POST/api/auth/sso/exchange
Letzter Schritt einer SSO-Anmeldung (SAML/OIDC): tauscht den Einmalcode aus der Weiterleitung gegen ein Zugangstoken und ein Refresh-Token.
Nach der Anmeldung beim Identity-Provider leitet Zentor App den Browser mit einem Einmalcode im Query-Parameter `sso_code` zurück. Senden Sie diesen Code im Feld `code`. Die Antwort enthält `token` und `refreshToken` wie bei einer regulären Anmeldung. Jeder Code ist nur einmal und nur kurz gültig. Ein bereits verwendeter, abgelaufener oder ungültiger Code führt zu 400 `SSO_EXCHANGE_INVALID`; der Benutzer startet die SSO-Anmeldung dann erneut. Der Aufruf ist daher nicht idempotent.
Überblick
Aufruf: POST /api/auth/sso/exchange. Der Endpunkt gehört zur Gruppe „Authentifizierung“ der API von Zentor App. Er ist öffentlich erreichbar und benötigt keine Authentifizierung. Der Aufruf ist nicht idempotent: Jeder erfolgreiche Aufruf löst die Aktion erneut aus. Pflichtparameter: code (Body). Dokumentierte Fehlerfälle: 400 SSO_EXCHANGE_INVALID. Die Beispielantwort unten zeigt den Aufbau einer erfolgreichen Antwort im JSON-Format.
Auth & Absicherung
Keine Authentifizierung erforderlich
Idempotent: Nein
Parameter
code(body, string, erforderlich)— Einmalcode aus der SSO-WeiterleitungBeispiel-Request
{"code":"<Einmalcode aus dem SSO-Callback-Redirect>"}Beispiel-Response
{"ok":true,"token":"<JWT>","refreshToken":"<Refresh-Token>"}Fehlercodes
400 SSO_EXCHANGE_INVALID — Der Code ist ungültig, bereits verwendet oder abgelaufen.Geprüftes Verhalten
Ein ungültiger Code liefert 400 `SSO_EXCHANGE_INVALID`. Der Erfolgsfall setzt eine vollständige Anmeldung beim eingerichteten Identity-Provider voraus.
Authentifizierung
POST /api/auth/loginMeldet einen Benutzer mit E-Mail-Adresse oder Benutzername und Passwort an und gibt ein Zugangstoken (JWT) sowie ein Refresh-Token aus.POST /api/auth/refreshTauscht ein gültiges Refresh-Token gegen ein neues Paar aus Zugangstoken und Refresh-Token.POST /api/auth/forgot-passwordStartet das Zurücksetzen eines Passworts: Existiert ein Konto mit der angegebenen E-Mail-Adresse, erhält es eine E-Mail mit einem Link zum Zurücksetzen.POST /api/auth/reset-passwordSetzt ein neues Passwort mit dem Reset-Token aus der E-Mail zum Zurücksetzen.