POST/api/auth/sso/exchange

Zadnji korak prijave SSO (SAML/OIDC): zamenja enkratno kodo iz preusmeritve za dostopni žeton in žeton za obnovitev.

Po prijavi pri ponudniku identitete Zentor App preusmeri brskalnik nazaj z enkratno kodo v poizvedbenem parametru `sso_code`. Pošljite to kodo v polju `code`. Odgovor vsebuje `token` in `refreshToken` kot pri navadni prijavi. Vsaka koda velja le enkrat in le kratek čas. Že uporabljena, potekla ali neveljavna koda povzroči 400 `SSO_EXCHANGE_INVALID`; uporabnik nato ponovno zažene prijavo SSO. Klic zato ni idempotenten.

Pregled

Klic: POST /api/auth/sso/exchange. Ta endpoint spada v skupino »Avtentikacija« API-ja Zentor App. Je javno dostopen in ne zahteva overjanja. Klic ni idempotenten: vsak uspešen klic znova sproži dejanje. Obvezni parametri: code (body). Dokumentirani primeri napak: 400 SSO_EXCHANGE_INVALID. Spodnji primer odgovora prikazuje strukturo uspešnega odgovora v formatu JSON.

Avtentikacija in zaščita

Avtentikacija ni potrebna

Idempotentno: Ne

Parametri

code(body, string, obvezno)— Enkratna koda iz preusmeritve SSO

Primer zahteve

{"code":"<enkratna koda iz preusmeritve SSO-Callback>"}

Primer odgovora

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

Kode napak

400 SSO_EXCHANGE_INVALID — Koda je neveljavna, že uporabljena ali potekla.

Preverjeno vedenje

Neveljavna koda vrne 400 `SSO_EXCHANGE_INVALID`. Primer uspeha predpostavlja popolno prijavo pri nastavljenem ponudniku identitete.

Avtentikacija

Sorodni članki

← Avtentikacija