Authentifizierung
Anmeldung, Token-Erneuerung, Passwort zurücksetzen, SSO-Abschluss – und API-Zugang per API-Schlüssel.
Diese Gruppe umfasst die Anmeldung von Benutzern: Login mit E-Mail-Adresse oder Benutzername und Passwort, Erneuerung der Sitzung per Refresh-Token, das Zurücksetzen eines vergessenen Passworts und den Abschluss einer Single-Sign-On-Anmeldung (SAML/OIDC). Die Endpunkte liefern ein Zugangstoken (JWT), das im Header `Authorization: Bearer <token>` gesendet wird, sowie ein Refresh-Token, das bei jeder Verwendung durch ein neues ersetzt wird.
Für den maschinellen Zugriff eigener Programme auf Ihre Daten verwenden Sie statt einer Benutzeranmeldung einen API-Schlüssel für die REST-API unter `https://zentor-app.de/api/v1`. Zentor schaltet den API-Zugang auf Anfrage frei; anschließend erzeugen Administratoren im Dashboard unter „API-Schlüssel“ Schlüssel mit festgelegten Berechtigungen (Scopes). Der Schlüssel wird im Header `Authorization: Bearer <API-Schlüssel>` oder `X-API-Key` übertragen. Scopes, Fehlercodes und Hinweise zur sicheren Aufbewahrung finden Sie in der Übersicht der API-Referenz.
Die Anmelde-Endpunkte sind gegen wiederholte Fehlversuche geschützt: Nach mehreren falschen Eingaben verzögert der Server weitere Versuche und sperrt sie vorübergehend mit 429 `RATE_LIMIT_EXCEEDED`.