POST/api/auth/sso/exchange

Hapi i fundit i një identifikimi SSO (SAML/OIDC): shkëmbon kodin një-herësh nga ridrejtimi me një token aksesi dhe një refresh-token.

Pas hyrjes te ofruesi i identitetit, Zentor App ridrejton shfletuesin me një kod një-herësh në parametrin e kërkesës `sso_code`. Dërgoni këtë kod në fushën `code`. Përgjigja përmban `token` dhe `refreshToken` si në një hyrje të zakonshme. Çdo kod është i vlefshëm vetëm një herë dhe vetëm për pak kohë. Një kod tashmë i përdorur, i skaduar ose i pavlefshëm çon në 400 `SSO_EXCHANGE_INVALID`; përdoruesi atëherë nis përsëri hyrjen SSO. Thirrja prandaj nuk është idempotente.

Përmbledhje

Thirrja: POST /api/auth/sso/exchange. Ky endpoint i përket grupit “Vërtetimi” të API-së së Zentor App. Është i aksesueshëm publikisht dhe nuk kërkon autentifikim. Thirrja nuk është idempotente: çdo thirrje e suksesshme e shkakton veprimin përsëri. Parametrat e detyrueshëm: code (body). Rastet e dokumentuara të gabimeve: 400 SSO_EXCHANGE_INVALID. Përgjigjja shembull më poshtë tregon strukturën e një përgjigjeje të suksesshme në formatin JSON.

Autentifikimi dhe siguria

Nuk kërkohet autentifikim

Idempotent: Jo

Parametrat

code(body, string, i detyrueshëm)— Kodi një-herësh nga ridrejtimi SSO

Shembull request-i

{"code":"<kod njëpërdorimësh nga ridrejtimi SSO-callback>"}

Shembull response-i

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

Kodet e gabimeve

400 SSO_EXCHANGE_INVALID — Kodi është i pavlefshëm, tashmë i përdorur ose i skaduar.

Sjellja e verifikuar

Një kod i pavlefshëm kthen 400 `SSO_EXCHANGE_INVALID`. Rasti i suksesit kërkon një hyrje të plotë te ofruesi i identitetit i konfiguruar.

Vërtetimi

Artikuj të lidhur

← Vërtetimi