POST/api/auth/sso/exchange

Ultimul pas al unei autentificări SSO (SAML/OIDC): schimbă codul de unică folosință din redirecționare pentru un token de acces și un refresh token.

După autentificarea la furnizorul de identitate, Zentor App redirecționează browserul cu un cod de unică folosință în parametrul de interogare `sso_code`. Trimiteți acest cod în câmpul `code`. Răspunsul conține `token` și `refreshToken`, ca la o autentificare obișnuită. Fiecare cod este valabil o singură dată și pentru puțin timp. Un cod deja utilizat, expirat sau invalid are ca rezultat 400 `SSO_EXCHANGE_INVALID`; utilizatorul repornește apoi autentificarea SSO. Prin urmare, apelul nu este idempotent.

Prezentare generală

Apel: POST /api/auth/sso/exchange. Acest endpoint aparține grupului „Autentificare” al API-ului Zentor App. Este accesibil public și nu necesită autentificare. Apelul nu este idempotent: fiecare apel reușit declanșează din nou acțiunea. Parametri obligatorii: code (body). Cazuri de eroare documentate: 400 SSO_EXCHANGE_INVALID. Răspunsul exemplu de mai jos arată structura unui răspuns reușit în format JSON.

Autentificare și securitate

Nu este necesară autentificarea

Idempotent: Nu

Parametri

code(body, string, obligatoriu)— Cod de unică folosință din redirecționarea SSO

Exemplu de cerere

{"code":"<Cod unic din redirectul de callback SSO>"}

Exemplu de răspuns

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

Coduri de eroare

400 SSO_EXCHANGE_INVALID — Codul este invalid, deja utilizat sau expirat.

Comportament verificat

Un cod invalid returnează 400 `SSO_EXCHANGE_INVALID`. Cazul de succes presupune o autentificare completă la furnizorul de identitate configurat.

Autentificare

Articole similare

← Autentificare