POST/api/auth/sso/exchange

Posledný krok prihlásenia SSO (SAML/OIDC): vymení jednorazový kód z presmerovania za prístupový token a refresh token.

Po prihlásení u poskytovateľa identity presmeruje Zentor App prehliadač s jednorazovým kódom v parametri dotazu `sso_code`. Tento kód odošlite v poli `code`. Odpoveď obsahuje `token` a `refreshToken`, podobne ako pri bežnom prihlásení. Každý kód platí len raz a len krátko. Už použitý, exspirovaný alebo neplatný kód vedie ku kódu 400 `SSO_EXCHANGE_INVALID`; používateľ potom znovu začne prihlásenie SSO. Volanie preto nie je idempotentné.

Prehľad

Volanie: POST /api/auth/sso/exchange. Tento endpoint patrí do skupiny „Autentifikácia“ API aplikácie Zentor App. Je verejne dostupný a nevyžaduje žiadnu autentifikáciu. Volanie nie je idempotentné: Každé úspešné volanie akciu spustí znova. Povinné parametre: code (body). Zdokumentované chybové prípady: 400 SSO_EXCHANGE_INVALID. Ukážková odpoveď nižšie zobrazuje štruktúru úspešnej odpovede vo formáte JSON.

Autentifikácia a zabezpečenie

Nevyžaduje sa žiadna autentifikácia

Idempotentné: Nie

Parametre

code(body, string, povinné)— Jednorazový kód z presmerovania SSO

Príklad požiadavky

{"code":"<jednorazový kód z presmerovania SSO callbacku>"}

Príklad odpovede

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

Chybové kódy

400 SSO_EXCHANGE_INVALID — Kód je neplatný, už použitý alebo exspirovaný.

Overené správanie

Neplatný kód vráti 400 `SSO_EXCHANGE_INVALID`. Úspešný prípad predpokladá úplné prihlásenie u nastaveného poskytovateľa identity.

Autentifikácia

Súvisiace články

← Autentifikácia