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-Weiterleitung

Beispiel-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

Verwandte Artikel

← Authentifizierung