POST/api/auth/sso/exchange

Siste trinn i en SSO-innlogging (SAML/OIDC): bytter ut engangskoden fra omdirigeringen med et tilgangstoken og et refresh-token.

Etter innlogging hos identitetsleverandøren omdirigerer Zentor App nettleseren tilbake med en engangskode i forespørselsparameteren `sso_code`. Send denne koden i feltet `code`. Svaret inneholder `token` og `refreshToken` som ved en vanlig innlogging. Hver kode er bare gyldig én gang og bare kort tid. En allerede brukt, utløpt eller ugyldig kode resulterer i 400 `SSO_EXCHANGE_INVALID`; brukeren starter da SSO-innloggingen på nytt. Kallet er derfor ikke idempotent.

Oversikt

Kall: POST /api/auth/sso/exchange. Endepunktet tilhører gruppen «Autentisering» i API-et til Zentor App. Det er offentlig tilgjengelig og krever ingen autentisering. Kallet er ikke idempotent: Hvert vellykket kall utløser handlingen på nytt. Obligatoriske parametere: code (body). Dokumenterte feiltilfeller: 400 SSO_EXCHANGE_INVALID. Eksempelsvaret nedenfor viser strukturen til et vellykket svar i JSON-format.

Autentisering og sikring

Ingen autentisering påkrevd

Idempotent: Nei

Parametere

code(body, string, påkrevd)— Engangskode fra SSO-omdirigeringen

Eksempel på forespørsel

{"code":"<Engangskode fra SSO-callback-omdirigeringen>"}

Eksempel på svar

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

Feilkoder

400 SSO_EXCHANGE_INVALID — Koden er ugyldig, allerede brukt eller utløpt.

Verifisert oppførsel

En ugyldig kode returnerer 400 `SSO_EXCHANGE_INVALID`. Suksesstilfellet forutsetter en fullstendig innlogging hos den oppsatte identitetsleverandøren.

Autentisering

Relaterte artikler

← Autentisering