POST/api/auth/sso/exchange
Sista steget i en SSO-inloggning (SAML/OIDC): byter engångskoden från omdirigeringen mot en åtkomsttoken och en refresh-token.
Efter inloggning hos identitetsleverantören omdirigerar Zentor App webbläsaren tillbaka med en engångskod i frågeparametern `sso_code`. Skicka denna kod i fältet `code`. Svaret innehåller `token` och `refreshToken` som vid en vanlig inloggning. Varje kod är giltig endast en gång och endast kort tid. En redan använd, utgången eller ogiltig kod resulterar i 400 `SSO_EXCHANGE_INVALID`; användaren startar då SSO-inloggningen igen. Anropet är därför inte idempotent.
Översikt
Anrop: POST /api/auth/sso/exchange. Endpointen tillhör gruppen ”Autentisering” i Zentor Apps API. Den är offentligt tillgänglig och kräver ingen autentisering. Anropet är inte idempotent: Varje lyckat anrop utlöser åtgärden på nytt. Obligatoriska parametrar: code (body). Dokumenterade felfall: 400 SSO_EXCHANGE_INVALID. Exempelsvaret nedan visar strukturen för ett lyckat svar i JSON-format.
Autentisering & säkerhet
Ingen autentisering krävs
Idempotent: Nej
Parametrar
code(body, string, obligatorisk)— Engångskod från SSO-omdirigeringenExempel på request
{"code":"<Engångskod från SSO-callback-omdirigeringen>"}Exempel på response
{"ok":true,"token":"<JWT>","refreshToken":"<Refresh-Token>"}Felkoder
400 SSO_EXCHANGE_INVALID — Koden är ogiltig, redan använd eller utgången.Verifierat beteende
En ogiltig kod returnerar 400 `SSO_EXCHANGE_INVALID`. Framgångsfallet förutsätter en fullständig inloggning hos den konfigurerade identitetsleverantören.
Autentisering
POST /api/auth/loginLoggar in en användare med e-postadress eller användarnamn och lösenord och utfärdar en åtkomsttoken (JWT) samt en refresh-token.POST /api/auth/refreshByter en giltig refresh-token mot ett nytt par av åtkomsttoken och refresh-token.POST /api/auth/forgot-passwordStartar en återställning av lösenord: om det finns ett konto med den angivna e-postadressen får det ett e-postmeddelande med en länk för återställning.POST /api/auth/reset-passwordStäller in ett nytt lösenord med reset-token från återställningsmeddelandet.