> 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/de/benutzer-und-projektverwaltung/user-management/migrating-to-ldap-or-saml.md). # Migration zu LDAP oder SAML ``` { _id: '123', email: 'alice@example.com' first_name: 'Alice', last_name: 'Jones' } ``` Jetzt möchten Sie in das LDAP-/Active-Directory-System Ihres Unternehmens integrieren. In diesem System lauten Alices Angaben: ``` Alice: - uid: 'alicejones' - mail: 'alicejones@tech.example.com' - givenName: 'Alice' - sn: 'Jones' ``` Ihr Ziel ist es, dass Alice sich mit ihrem LDAP-Benutzernamen (`alicejones`) und Passwort statt mit ihren alten Overleaf-Zugangsdaten anmeldet, ohne dabei etwas von ihrer Arbeit zu verlieren. So geht's. {% hint style="warning" %} Für diesen Prozess muss der **sharelatex** Container neu erstellt werden, was zu etwas Ausfallzeit führt. Wir empfehlen dringend, sich mit diesem Prozess vertraut zu machen, indem Sie ihn zunächst in einer Test-/Staging-Umgebung durchgehen. {% endhint %} {% stepper %} {% step %} ### Bitten Sie Ihre Nutzer, ihre E-Mail-Adressen zu aktualisieren Overleaf-Konten sind an E-Mail-Adressen gebunden, daher besteht der erste Schritt darin, die Overleaf-E-Mails Ihrer Nutzer mit ihren LDAP- oder SAML-E-Mails zu synchronisieren. In unserem Beispiel würden Sie Alice bitten, sich in ihr Overleaf-Konto einzuloggen und ihre E-Mail von `alice@example.com` auf `alicejones@tech.example.com`. {% hint style="warning" %} Vergessen Sie sich selbst nicht! Wenn Sie Admin sind, müssen Sie auch Ihre eigene E-Mail-Adresse aktualisieren. {% endhint %} {% hint style="success" %} Wenn Sie viele Nutzer haben, können Sie das [Benutzernamensmigration](/on-premises/de/benutzer-und-projektverwaltung/user-management/username-migration.md) Skript verwenden, um die primäre E-Mail-Adresse eines Nutzers in großen Mengen zu ändern. {% endhint %} {% endstep %} {% step %} ### Aktivieren Sie das LDAP- oder SAML-Modul Sobald die E-Mail-Adressen aller aktualisiert sind, ist es Zeit, den Schalter umzulegen! Sie müssen die richtigen Umgebungsvariablen für Ihre neue Authentifizierungsmethode festlegen und dann den **sharelatex** Container mit dem `bin/up -d` Befehl neu. Dadurch wird das standardmäßige Overleaf-Anmeldeformular durch Ihr neues LDAP- oder SAML-Anmeldeformular ersetzt. {% hint style="info" %} Die relevanten Informationen zum Aktivieren von LDAP finden Sie [hier](/on-premises/de/konfiguration/overleaf-toolkit/authentication/ldap-authentication.md), und SAML 2.0 [hier](/on-premises/de/konfiguration/overleaf-toolkit/authentication/saml-authentication.md). {% endhint %} {% endstep %} {% step %} ### Nutzer können sich jetzt über LDAP oder SAML anmelden Wenn Alice sich das nächste Mal anmeldet, wird sie das neue Formular sehen. ![LDAP/Active Directory-Anmeldeseite](/files/f180f9c611a680471f618e3b5857480fa812e2c2) Sie können ihren LDAP-Benutzernamen (`alicejones`) und ihr Passwort eingeben, und da ihre E-Mail-Adresse jetzt mit der in LDAP übereinstimmt, werden sie direkt in ihr bestehendes Overleaf-Konto eingeloggt. Alle ihre Projekte befinden sich genau dort, wo sie sie verlassen haben. Wenn Sie SAML 2.0 aktiviert haben, sehen Nutzer eine Schaltfläche, die sie beim Klicken zu Ihrem IdP weiterleitet, damit sie dort ihre Anmeldedaten eingeben können. Nach erfolgreicher Authentifizierung werden sie zurück zu Ihrer Overleaf-Instanz weitergeleitet und in ihr Konto eingeloggt. ![SAML-Anmeldeseite](/files/e88cad261832abb4bc165f4847f656498c541150) {% hint style="info" %} Siehe die [Umgebungsvariablen](broken://pages/ebbf882ed8511eb77f188b7576fc226015cf9c95) Seite mit Informationen zum Anpassen der Anmeldeoberfläche. Und wenn Sie jemals zurückrollen müssen, kommentieren Sie einfach die LDAP/SAML-Konfiguration aus und erstellen Sie den **sharelatex** Container mit dem `bin/up -d` Befehl neu. Anschließend können sich Nutzer wieder mit ihrer aktuellen E-Mail-Adresse und ihrem Overleaf-spezifischen Passwort anmelden. {% endhint %} {% endstep %} {% endstepper %} ## Umgekehrt: Wechsel von LDAP/SAML zurück zur nativen Authentifizierung Was ist, wenn Sie LDAP oder SAML schon eine Weile verwenden und zu Overleafs eingebautem Anmeldesystem wechseln möchten (vielleicht haben Sie Ihr LDAP abgeschafft)? Kein Problem! So können Sie diese Umstellung vornehmen. {% stepper %} {% step %} ### Überprüfen Sie, dass die E-Mail-Adresse aller korrekt ist Die Konten Ihrer Nutzer sind bereits mit ihren LDAP- oder SAML-E-Mail-Adressen verknüpft. Diese E-Mail-Adresse werden sie ab jetzt zum Anmelden verwenden, also stellen Sie einfach sicher, dass alles stimmt. {% endstep %} {% step %} ### Deaktivieren Sie das LDAP- oder SAML-Modul Entfernen oder löschen Sie einfach die LDAP/SAML-Konfigurationseinstellungen und erstellen Sie den **sharelatex** Container mit dem `bin/up -d` Befehl neu. Dadurch wird das native Overleaf-Anmeldeformular für E-Mail und Passwort wiederhergestellt. ![Anmeldeseite für die native Authentifizierung](/files/68d6cd386e02a4184cb2989c3457da89b1ad0d81) {% endstep %} {% step %} ### Bitten Sie Nutzer, ihre Passwörter zurückzusetzen Wenn Ihre Nutzer jetzt die Anmeldeseite besuchen, sehen sie statt des LDAP/SAML-Formulars das Overleaf-Anmeldeformular. Da sie vielleicht nie ein natives Overleaf-Passwort hatten, müssen sie eines erstellen. Jeder Nutzer sollte: * Klicken Sie auf den Link „Passwort vergessen?“. * Geben Sie die mit ihrem Konto verknüpfte E-Mail-Adresse ein (die aus LDAP/SAML). * Folgen Sie dem Link in der E-Mail zum Zurücksetzen des Passworts, um ein neues Passwort festzulegen. {% hint style="info" %} Wenn Sie das noch nicht getan haben, lesen Sie unseren Leitfaden zum Aktivieren von [E-Mail-Zustellung](/on-premises/de/konfiguration/overleaf-toolkit/email-delivery.md). {% endhint %} Sobald das erledigt ist, können sie sich mit ihrer E-Mail-Adresse und ihrem neuen Overleaf-spezifischen Passwort anmelden, um auf alle ihre Projekte zuzugreifen. {% 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/de/benutzer-und-projektverwaltung/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.