> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-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 w swojej firmie. W tym systemie dane Alice są następujące: ``` Alice: - uid: 'alicejones' - mail: 'alicejones@tech.example.com' - givenName: 'Alice' - sn: 'Jones' ``` Twoim celem jest umożliwienie Alice logowania się przy użyciu jej nazwy użytkownika LDAP (`alicejones`) i hasła zamiast starych danych uwierzytelniających Overleaf, bez utraty jakiejkolwiek pracy. Oto jak to osiągnąć. {% hint style="warning" %} Ten proces będzie wymagał odtworzenia **sharelatex** kontenera, co spowoduje pewien przestój. Gorąco zalecamy, aby najpierw zapoznać się z tym procesem, przechodząc przez niego w środowisku testowym/przedprodukcyjnym. {% endhint %} {% stepper %} {% step %} ### Poproś użytkowników o aktualizację swoich adresów e-mail Konta Overleaf są powiązane z adresami e-mail, więc pierwszym krokiem jest zsynchronizowanie e-maili Overleaf Twoich użytkowników z ich e-mailami LDAP lub SAML. W naszym przykładzie poprosiłbyś Alice, aby zalogowała się na swoje konto Overleaf i zmieniła swój adres e-mail z `alice@example.com` na `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 nazw użytkowników](/on-premises/pl/zarzadzanie-uzytkownikami-i-projektami/user-management/username-migration.md) skryptu, aby zbiorczo zmienić główny adres e-mail użytkownika. {% endhint %} {% endstep %} {% step %} ### Włącz moduł LDAP lub SAML Gdy adresy e-mail wszystkich zostaną zaktualizowane, czas przełączyć przełącznik! Będziesz musiał ustawić odpowiednie zmienne środowiskowe dla nowej metody uwierzytelniania, a następnie odtworzyć **sharelatex** kontener używając `bin/up -d` polecenie. To zastępuje standardowy formularz logowania Overleaf Twoim nowym formularzem LDAP lub SAML. {% hint style="info" %} Możesz znaleźć odpowiednie informacje dotyczące włączania LDAP [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 próbowała się zalogować, zobaczy nowy formularz. ![Strona logowania LDAP/Active Directory](/files/77ed356a09ea4c4ee2c50627f2bb218513a05c0f) Mogą wpisać swoją nazwę użytkownika LDAP (`alicejones`) i hasło, a ponieważ ich adres e-mail teraz pasuje do tego w LDAP, zostaną od razu zalogowani do swojego istniejącego konta Overleaf. Wszystkie ich projekty będą dokładnie tam, gdzie je zostawili. Jeśli włączyłeś SAML 2.0, użytkownicy zobaczą przycisk, który po kliknięciu przekieruje ich do Twojego IdP, aby podali 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) stronę, aby uzyskać informacje o dostosowywaniu wyglądu strony logowania. A jeśli kiedykolwiek będziesz musiał wykonać rollback, po prostu zakomentuj konfigurację LDAP/SAML i odtwórz **sharelatex** kontener używając `bin/up -d` polecenie. Użytkownicy będą wtedy mogli logować się, używając swojego obecnego adresu e-mail i hasła specyficznego dla Overleaf. {% endhint %} {% endstep %} {% endstepper %} ## W drugą stronę: przejście z LDAP/SAML z powrotem do uwierzytelniania natywnego A jeśli korzystasz z LDAP lub SAML od jakiegoś czasu i chcesz przejść do wbudowanego systemu logowania Overleaf (być może wycofałeś swój LDAP)? Żaden problem! Oto jak możesz dokonać tego przełączenia. {% stepper %} {% step %} ### Sprawdź, czy adresy e-mail wszystkich są poprawne Konta Twoich użytkowników są już powiązane z ich adresami e-mail LDAP lub SAML. To jest adres e-mail, którego będą używać do logowania się od teraz, więc po prostu upewnij się, że wszystko wygląda poprawnie. {% endstep %} {% step %} ### Wyłącz moduł LDAP lub SAML Po prostu usuń lub odznacz ustawienia konfiguracji LDAP/SAML i odtwórz **sharelatex** kontener używając `bin/up -d` polecenie. To przywróci natywny formularz logowania Overleaf za pomocą adresu e-mail i hasła. ![Strona logowania uwierzytelniania natywnego](/files/d81ea2a2f4f8ea6677854c6080ed24e0d3ea8dc4) {% endstep %} {% step %} ### Poproś użytkowników o zresetowanie haseł Gdy Twoi użytkownicy teraz odwiedzą stronę logowania, zobaczą formularz logowania Overleaf zamiast formularza LDAP/SAML. Ponieważ mogli nigdy nie mieć natywnego hasła Overleaf, będą musieli je utworzyć. Każdy użytkownik powinien: * Kliknąć link „Nie pamiętasz hasła?”. * Wprowadzić adres e-mail powiązany z jego kontem (ten z LDAP/SAML). * Postępować zgodnie z linkiem w e-mailu do resetowania hasła, aby ustawić nowe hasło. {% hint style="info" %} Jeśli jeszcze tego nie zrobiłeś, sprawdź nasz przewodnik po włączaniu [dostarczania e-maili](/on-premises/pl/konfiguracja/overleaf-toolkit/email-delivery.md). {% endhint %} Gdy to będzie zrobione, będą mogli zalogować 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://overleaf-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.