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-omdirigeringenEksempel 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
POST /api/auth/loginLogger inn en bruker med e-postadresse eller brukernavn og passord og utsteder et tilgangstoken (JWT) samt et refresh-token.POST /api/auth/refreshBytter ut et gyldig refresh-token med et nytt par av tilgangstoken og refresh-token.POST /api/auth/forgot-passwordStarter nullstilling av passord: Hvis det finnes en konto med den angitte e-postadressen, mottar den en e-post med en lenke for nullstilling.POST /api/auth/reset-passwordSetter et nytt passord med reset-tokenet fra nullstillings-e-posten.