> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/pl/zarzadzanie-uzytkownikami-i-projektami/user-management/migrating-to-ldap-or-saml.md). # Migracja do LDAP lub SAML ``` { _id: '123', email: 'alice@example.com' first_name: 'Alice', last_name: 'Jones' } ``` Teraz chcesz zintegrować się z systemem LDAP/Active Directory swojej firmy. W tym systemie dane Alice są następujące: ``` Alice: - uid: 'alicejones' - mail: 'alicejones@tech.example.com' - givenName: 'Alice' - sn: 'Jones' ``` Twoim celem jest to, aby Alice logowała się przy użyciu swojej nazwy użytkownika LDAP (`alicejones`) i hasła zamiast starych danych logowania Overleaf, bez utraty żadnej z jej pracy. Oto jak to zrobić. {% hint style="warning" %} Ten proces będzie wymagał ponownego utworzenia **sharelatex** kontenera, co spowoduje pewien przestój. Gorąco zalecamy, aby najpierw zapoznać się z tym procesem, przechodząc przez niego w środowisku testowym/stagingowym. {% endhint %} {% stepper %} {% step %} ### Poproś użytkowników o zaktualizowanie swoich adresów e-mail Konta Overleaf są powiązane z adresami e-mail, więc pierwszym krokiem jest zsynchronizowanie adresów e-mail użytkowników Overleaf z ich adresami LDAP lub SAML. W naszym przykładzie poprosisz Alice, aby zalogowała się na swoje konto Overleaf i zmieniła swój adres e-mail z `alice@example.com` do `alicejones@tech.example.com`. {% hint style="warning" %} Nie zapomnij o sobie! Jeśli jesteś administratorem, musisz też zaktualizować swój własny adres e-mail. {% endhint %} {% hint style="success" %} Jeśli masz wielu użytkowników, możesz użyć [Migracja nazwy użytkownika](/on-premises/pl/zarzadzanie-uzytkownikami-i-projektami/user-management/username-migration.md) skryptu do zbiorczej zmiany głównego adresu e-mail użytkownika. {% endhint %} {% endstep %} {% step %} ### Włącz moduł LDAP lub SAML Gdy adresy e-mail wszystkich zostaną zaktualizowane, czas przełączyć system! Będziesz musiał ustawić odpowiednie zmienne środowiskowe dla nowej metody uwierzytelniania, a następnie ponownie utworzyć **sharelatex** kontener przy użyciu `bin/up -d` polecenia. To zastępuje standardowy formularz logowania Overleaf nowym formularzem LDAP lub SAML. {% hint style="info" %} Odpowiednie informacje dotyczące włączania LDAP znajdziesz [tutaj](/on-premises/pl/konfiguracja/overleaf-toolkit/authentication/ldap-authentication.md), oraz SAML 2.0 [tutaj](/on-premises/pl/konfiguracja/overleaf-toolkit/authentication/saml-authentication.md). {% endhint %} {% endstep %} {% step %} ### Użytkownicy mogą teraz logować się przez LDAP lub SAML Następnym razem, gdy Alice będzie się logować, zobaczy nowy formularz. ![Strona logowania LDAP/Active Directory](/files/77ed356a09ea4c4ee2c50627f2bb218513a05c0f) Mogą wpisać swoją nazwę użytkownika LDAP (`alicejones`) oraz hasło, a ponieważ ich adres e-mail teraz zgadza się z tym w LDAP, zostaną od razu zalogowani do istniejącego konta Overleaf. Wszystkie ich projekty będą dokładnie tam, gdzie je zostawili. Jeśli włączono SAML 2.0, użytkownicy zobaczą przycisk, który po kliknięciu przekieruje ich do dostawcy tożsamości (IdP), aby mogli wprowadzić swoje dane uwierzytelniające. Po pomyślnym uwierzytelnieniu zostaną przekierowani z powrotem do Twojej instancji Overleaf i zalogowani na swoje konto. ![Strona logowania SAML](/files/eff5fae0c49414eb26743f6bdfd0feb1be4d4e45) {% hint style="info" %} Zobacz [Zmienne środowiskowe](broken://pages/a6e930c58129d3a3462c8f1baa6f4d7d4317672c) strona z informacjami o dostosowywaniu strony logowania. A jeśli kiedykolwiek będziesz musiał wycofać zmiany, po prostu zakomentuj konfigurację LDAP/SAML i ponownie utwórz **sharelatex** kontener przy użyciu `bin/up -d` polecenie. Użytkownicy będą wtedy mogli logować się przy użyciu swojego bieżącego adresu e-mail i hasła specyficznego dla Overleaf. {% endhint %} {% endstep %} {% endstepper %} ## W drugą stronę: przejście z LDAP/SAML z powrotem do natywnego uwierzytelniania A co, jeśli od pewnego czasu korzystasz z LDAP lub SAML i chcesz przejść na wbudowany system logowania Overleaf (może wycofałeś LDAP)? Nie ma problemu! Oto jak możesz wykonać to przełączenie. {% stepper %} {% step %} ### Sprawdź, czy adres e-mail każdego jest poprawny Konta twoich użytkowników są już powiązane z ich adresami e-mail LDAP lub SAML. To będzie adres e-mail, którego będą odtąd używać do logowania, więc po prostu upewnij się, że wszystko wygląda poprawnie. {% endstep %} {% step %} ### Wyłącz moduł LDAP lub SAML Po prostu usuń lub wyłącz ustawienia konfiguracji LDAP/SAML i ponownie utwórz **sharelatex** kontener przy użyciu `bin/up -d` polecenie. To przywróci natywny formularz logowania Overleaf przy użyciu adresu e-mail i hasła. ![Strona logowania natywnego uwierzytelniania](/files/d81ea2a2f4f8ea6677854c6080ed24e0d3ea8dc4) {% endstep %} {% step %} ### Poproś użytkowników o zresetowanie haseł Gdy użytkownicy odwiedzą teraz stronę logowania, zobaczą formularz logowania Overleaf zamiast formularza LDAP/SAML. Ponieważ być może nigdy nie mieli natywnego hasła Overleaf, będą musieli je utworzyć. Każdy użytkownik powinien: * Kliknąć łącze „Nie pamiętasz hasła?”. * Wprowadzić adres e-mail powiązany z ich kontem (ten z LDAP/SAML). * Skorzystać z łącza w wiadomości e-mail do resetowania hasła, aby ustawić nowe hasło. {% hint style="info" %} Jeśli jeszcze tego nie zrobiłeś, sprawdź nasz przewodnik dotyczący włączania [Dostarczanie wiadomości e-mail](/on-premises/pl/konfiguracja/overleaf-toolkit/email-delivery.md). {% endhint %} Gdy to zostanie zrobione, będą mogli logować się przy użyciu swojego adresu e-mail i nowego hasła specyficznego dla Overleaf, aby uzyskać dostęp do wszystkich swoich projektów. {% endstep %} {% endstepper %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ayakaleaf-pro.ayaka.space/on-premises/pl/zarzadzanie-uzytkownikami-i-projektami/user-management/migrating-to-ldap-or-saml.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.