> 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.md). # Benutzerverwaltung ## Einen Administratorbenutzer erstellen 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 programmatischen Ansatz können Sie dasselbe Skript auch verwenden, um normale Benutzer sowie Administratoren zu erstellen. Für normale Benutzer lassen Sie das --admin-Flag weg. {% endhint %} Wenn Sie interne Konten zur Authentifizierung verwenden und einen vorhandenen Benutzer zu einem Instanz-Admin hochstufen oder Admin-Berechtigungen widerrufen müssen, gehen Sie wie folgt vor: {% stepper %} {% step %} ### Über die Admin-Oberfläche * Melden Sie sich als bestehender Administrator an. * Klicken Sie auf Admin -> Benutzer verwalten. * Suchen Sie nach dem Benutzer und klicken Sie auf seine E-Mail-Adresse. * Scrollen Sie nach unten zum Abschnitt Site-Admin und klicken Sie auf den Link (anzeigen). * Aktivieren Sie das Kontrollkästchen Ist Site-Admin. * Klicken Sie zum Abschließen auf Speichern. {% endstep %} {% endstepper %} *** ## Benutzer löschen Wie in unserem Leitfaden zu [Lizenznutzung verstehen](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 weiter oder werden gelöscht. Standardmäßig werden Konten vorläufig gelöscht. Informationen dazu, wie Benutzer dauerhaft aus Ihrer Instanz entfernt werden, finden Sie in `ENABLE_CRON_RESOURCE_DELETION` in der [Umgebungsvariablen](broken://pages/ebbf882ed8511eb77f188b7576fc226015cf9c95) im 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 -> Benutzer verwalten {% stepper %} {% step %} * Melden Sie sich als Administrator an. * Klicken Sie auf Admin -> Benutzer verwalten. * Suchen Sie nach dem Benutzer und aktivieren Sie das Kontrollkästchen neben seiner E-Mail-Adresse. * Klicken Sie auf das Papierkorb-Symbol. * Klicken Sie zur Bestätigung auf Löschen. {% endstep %} {% endstepper %} ### Über die Kommandozeile 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 auch dann fortgesetzt wird, wenn das Lösch-E-Mail 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 Informations-E-Mail an den gelöschten Benutzer zu verhindern. {% endhint %} *** ## Einen vorläufig gelöschten Benutzer wiederherstellen 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 -> Benutzer verwalten. * 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 zur Bestätigung 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 Zeitfensters von 90 Tagen wiederhergestellt werden. Nach 90 Tagen ist eine Kontowiederherstellung nicht mehr möglich. {% endhint %} *** ## Benutzer zählen Sie können die Benutzeranzahl über die Admin-Oberfläche unter abrufen. Für programmatische 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 Kontoupdates durchgeführt werden, hängt davon ab, ob SSO aktiviert ist. * Wenn SSO nicht verwendet wird: * Administratoren können Benutzerkontoinformationen über Admin -> Benutzer verwalten ändern (E-Mail, Vorname, Nachname und einen Link zum Zurücksetzen des Passworts generieren). * Normale Benutzer können ihre eigenen Daten über Konto -> Kontoeinstellungen 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 bei der Anmeldung anhand des Authentifizierungssystems aktualisiert werden. * Wenn OVERLEAF\_SAML\_UPDATE\_USER\_DETAILS\_ON\_LOGIN oder OVERLEAF\_LDAP\_UPDATE\_USER\_DETAILS\_ON\_LOGIN auf true gesetzt sind, ist das Benutzerdetailformular auf deaktiviert, und Vor- und Nachname können nur in Ihrem Identitätsverwaltungssystem festgelegt werden. Weitere Einzelheiten finden Sie unter: * SAML-2.0-Konfiguration: * LDAP-Konfiguration: *** Zuletzt vor 4 Monaten aktualisiert Diese Dokumentationsseite enthält Links zu externen Anleitungen 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://overleaf-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.