> 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/de/benutzer-und-projektverwaltung/user-management.md). # Benutzerverwaltung ## Erstellen eines Administratorbenutzers Bereitstellungen mit dem Overleaf Toolkit: {% code title="Overleaf Toolkit" overflow="wrap" %} ```bash $ bin/docker-compose exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/create-user --admin --email=joe@example.com" ``` {% endcode %} Ältere docker-compose.yml-Bereitstellungen: {% code title="Älteres docker-compose" overflow="wrap" %} ```bash $ docker exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/create-user --admin --email=joe@example.com" ``` {% endcode %} Der Befehl erstellt einen Benutzer mit der angegebenen E-Mail-Adresse, falls dieser noch nicht existiert, und macht ihn zu einem Administrator. Die Ausgabe des Befehls enthält eine URL, die Sie aufrufen können, um das Passwort für diesen Benutzer festzulegen und sich zum ersten Mal anzumelden. {% hint style="info" %} Für einen programmgesteuerten Ansatz können Sie dasselbe Skript auch verwenden, um normale Benutzer sowie Administratoren zu erstellen. Lassen Sie für normale Benutzer das Flag --admin weg. {% endhint %} Wenn Sie interne Konten zur Authentifizierung verwenden und einen vorhandenen Benutzer zum Instanzadministrator hochstufen oder Administratorberechtigungen entziehen müssen, gehen Sie wie folgt vor: {% stepper %} {% step %} ### Über die Admin-Oberfläche * Melden Sie sich als vorhandener Administrator an. * Klicken Sie auf Admin -> Manage Users. * Suchen Sie nach dem Benutzer und klicken Sie auf seine E-Mail-Adresse. * Scrollen Sie zum Abschnitt Site Admin und klicken Sie auf den Link (anzeigen). * Aktivieren Sie das Kontrollkästchen Ist Site Admin. * Klicken Sie auf Speichern, um abzuschließen. {% endstep %} {% endstepper %} *** ## Benutzer löschen Wie in unserem Leitfaden zu [dem Verständnis der Lizenznutzung](broken://pages/cbbc6fb7a22379ee52329b03f4ee980dc49197b6) erläutert, ist es im Allgemeinen ratsam, Konten nicht zu löschen, es sei denn, sie werden nicht mehr benötigt. Das Löschen eines Kontos entfernt das Konto und führt dazu, dass Mitwirkende den Zugriff auf Projekte verlieren. Derzeit gibt es keine Möglichkeit, Konten zu deaktivieren — sie existieren entweder mit ihren Daten weiterhin oder werden gelöscht. Standardmäßig werden Konten vorläufig gelöscht. Informationen zum endgültigen Entfernen von Benutzern aus Ihrer Instanz finden Sie im `ENABLE_CRON_RESOURCE_DELETION` in der [Umgebungsvariablen](broken://pages/ebbf882ed8511eb77f188b7576fc226015cf9c95) Leitfaden. {% hint style="info" %} Konten werden standardmäßig vorläufig gelöscht. Siehe `ENABLE_CRON_RESOURCE_DELETION` für das Verhalten bei der endgültigen Löschung. {% endhint %} ### Über Admin -> Manage Users {% stepper %} {% step %} * Melden Sie sich als Administrator an. * Klicken Sie auf Admin -> Manage Users. * Suchen Sie nach dem Benutzer und aktivieren Sie das Kontrollkästchen neben seiner E-Mail-Adresse. * Klicken Sie auf das Papierkorb-Symbol. * Klicken Sie zum Bestätigen auf Löschen. {% endstep %} {% endstepper %} ### Über die Befehlszeile Benutzerkonten (und ihre Projekte) können mit den folgenden Befehlen gelöscht werden. Bereitstellungen mit dem Overleaf Toolkit: {% code title="Overleaf Toolkit" %} ```bash $ bin/docker-compose exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/delete-user.mjs --email=joe@example.com" ``` {% endcode %} Ältere docker-compose.yml-Bereitstellungen: {% code title="Älteres docker-compose" %} ```bash $ docker exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/delete-user.mjs --email=joe@example.com" ``` {% endcode %} {% hint style="danger" %} Das Löschskript verwendet eine fest codierte Force-Option, die sicherstellt, dass die Löschung fortgesetzt wird, selbst wenn die E-Mail zur Kontolöschung nicht gesendet werden kann (z. B. wenn die E-Mail-Adresse des Benutzers nicht mehr aktiv ist). {% endhint %} {% hint style="info" %} Seit Version 5.5.0 kann die Option --skip-email verwendet werden, um das Senden einer informativen E-Mail an den gelöschten Benutzer zu verhindern. {% endhint %} *** ## Wiederherstellen eines vorläufig gelöschten Benutzers Wenn ein Benutzer nur vorläufig gelöscht wurde, können Sie sein Konto und seine Projekte wiederherstellen. {% stepper %} {% step %} * Melden Sie sich als Administrator an. * Klicken Sie auf Admin -> Manage Users. * Suchen Sie nach dem Benutzer, den Sie wiederherstellen möchten. * Klicken Sie auf die Schaltfläche Gelöschte Benutzer anzeigen. * Klicken Sie auf die E-Mail-Adresse des gelöschten Benutzers. * Klicken Sie auf Dieses Konto wiederherstellen. * Klicken Sie zum Bestätigen auf Wiederherstellen. {% endstep %} {% endstepper %} {% hint style="danger" %} Wenn ENABLE\_CRON\_RESOURCE\_DELETION auf true gesetzt ist, können vorläufig gelöschte Konten innerhalb eines Zeitraums von 90 Tagen wiederhergestellt werden. Nach 90 Tagen ist eine Kontowiederherstellung nicht möglich. {% endhint %} *** ## Benutzer zählen Sie können Benutzerzahlen über die Admin-Oberfläche unter abrufen. Für programmgesteuerte Prüfungen und Exporte können die folgenden Beispiele hilfreich sein. Gesamtzahl der Benutzer: {% code title="Gesamtzahl der Benutzer" %} ```bash echo 'db.users.countDocuments()' | docker exec -i mongo mongosh --quiet localhost/sharelatex # overleaf [direct: primary] sharelatex> 16 ``` {% endcode %} Gesamtzahl der Benutzer über den Metrics-Endpunkt: {% code title="Anzahl aktiver Benutzer aus den Metriken" %} ```bash docker exec sharelatex curl http://127.0.0.1:3000/metrics | grep num_active_users # # HELP num_active_users num_active_users # # TYPE num_active_users gauge # num_active_users{app="web-api",host="b3ae4ff549d8"} 16 ``` {% endcode %} Gesamtzahl aktiver Benutzer (Beispiel: Benutzer, die in den letzten 365 Tagen aktiv waren): {% code title="Gesamtzahl aktiver Benutzer" %} ```bash echo 'db.users.countDocuments({ lastActive: { $gte: new Date(new Date().getTime() - (365 * 24 * 60 * 60 * 1000)) } })' | docker exec -i mongo mongosh --quiet localhost/sharelatex # overleaf [direct: primary] sharelatex> 10 ``` {% endcode %} *** ## Benutzerkontoinformationen aktualisieren Wie Aktualisierungen von Konten durchgeführt werden, hängt davon ab, ob SSO aktiviert ist. * Wenn SSO nicht verwendet wird: * Administratoren können Benutzerkontoinformationen über Admin -> Manage Users ändern (E-Mail, Vorname, Nachname und einen Link zum Zurücksetzen des Passworts generieren). * Normale Benutzer können ihre eigenen Daten über Account -> Account Settings aktualisieren (einschließlich Passwortänderung und Generierung von Git-Authentifizierungstokens). * Wenn SSO verwendet wird: * Server Pro kann so konfiguriert werden, dass Vor- und Nachname eines Benutzers während der Anmeldung auf Grundlage des Authentifizierungssystems aktualisiert werden. * Wenn OVERLEAF\_SAML\_UPDATE\_USER\_DETAILS\_ON\_LOGIN oder OVERLEAF\_LDAP\_UPDATE\_USER\_DETAILS\_ON\_LOGIN true sind, ist das Formular für Benutzerdetails unter deaktiviert und Vor- und Nachname können nur in Ihrem Identitätsverwaltungssystem festgelegt werden. Weitere Details finden Sie unter: * SAML 2.0-Konfiguration: * LDAP-Konfiguration: *** Zuletzt aktualisiert vor 4 Monaten Diese Dokumentationsseite enthält Links zu externen Leitfäden und Konfigurationsseiten. Alle Links und Abfrageparameter bleiben wie im ursprünglichen Inhalt erhalten. --- # 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/de/benutzer-und-projektverwaltung/user-management.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.