POST/api/auth/sso/exchange

Laaste stap van 'n SSO-aanmelding (SAML/OIDC): ruil die eenmalige kode uit die herleiding vir 'n toegangstoken en 'n refresh-token.

Na aanmelding by die identiteitsverskaffer herlei Zentor App die blaaier terug met 'n eenmalige kode in die navraagparameter `sso_code`. Stuur hierdie kode in die veld `code`. Die antwoord bevat `token` en `refreshToken` soos by 'n gewone aanmelding. Elke kode is net een keer en net vir 'n kort tyd geldig. 'n Reeds gebruikte, verlopde of ongeldige kode lei tot 400 `SSO_EXCHANGE_INVALID`; die gebruiker begin die SSO-aanmelding dan weer. Die oproep is dus nie idempotent nie.

Oorsig

Oproep: POST /api/auth/sso/exchange. Hierdie eindpunt behoort tot die groep “Verifikasie” van die Zentor App-API. Dit is publiek toeganklik en vereis geen verifikasie nie. Die oproep is nie idempotent nie: elke suksesvolle oproep aktiveer die aksie opnuut. Verpligte parameters: code (body). Gedokumenteerde foutgevalle: 400 SSO_EXCHANGE_INVALID. Die voorbeeldrespons hieronder toon die struktuur van ’n suksesvolle respons in JSON-formaat.

Verifikasie en sekuriteit

Geen verifikasie vereis nie

Idempotent: Nee

Parameters

code(body, string, vereis)— Eenmalige kode uit die SSO-herleiding

Voorbeeldversoek

{"code":"<eenmalige kode uit die SSO callback Redirect>"}

Voorbeeldrespons

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

Foutkodes

400 SSO_EXCHANGE_INVALID — Die kode is ongeldig, reeds gebruik of verlope.

Gekontroleerde gedrag

'n Ongeldige kode lewer 400 `SSO_EXCHANGE_INVALID`. Die suksesgeval vereis 'n volledige aanmelding by die opgestelde identiteitsverskaffer.

Verifikasie

Verwante artikels

← Verifikasie