POST/api/auth/sso/exchange

Sista steget i en SSO-inloggning (SAML/OIDC): byter engångskoden från omdirigeringen mot en åtkomsttoken och en refresh-token.

Efter inloggning hos identitetsleverantören omdirigerar Zentor App webbläsaren tillbaka med en engångskod i frågeparametern `sso_code`. Skicka denna kod i fältet `code`. Svaret innehåller `token` och `refreshToken` som vid en vanlig inloggning. Varje kod är giltig endast en gång och endast kort tid. En redan använd, utgången eller ogiltig kod resulterar i 400 `SSO_EXCHANGE_INVALID`; användaren startar då SSO-inloggningen igen. Anropet är därför inte idempotent.

Översikt

Anrop: POST /api/auth/sso/exchange. Endpointen tillhör gruppen ”Autentisering” i Zentor Apps API. Den är offentligt tillgänglig och kräver ingen autentisering. Anropet är inte idempotent: Varje lyckat anrop utlöser åtgärden på nytt. Obligatoriska parametrar: code (body). Dokumenterade felfall: 400 SSO_EXCHANGE_INVALID. Exempelsvaret nedan visar strukturen för ett lyckat svar i JSON-format.

Autentisering & säkerhet

Ingen autentisering krävs

Idempotent: Nej

Parametrar

code(body, string, obligatorisk)— Engångskod från SSO-omdirigeringen

Exempel på request

{"code":"<Engångskod från SSO-callback-omdirigeringen>"}

Exempel på response

{"ok":true,"token":"<JWT>","refreshToken":"<Refresh-Token>"}

Felkoder

400 SSO_EXCHANGE_INVALID — Koden är ogiltig, redan använd eller utgången.

Verifierat beteende

En ogiltig kod returnerar 400 `SSO_EXCHANGE_INVALID`. Framgångsfallet förutsätter en fullständig inloggning hos den konfigurerade identitetsleverantören.

Autentisering

Relaterade artiklar

← Autentisering