POST/api/auth/sso/exchange

Hatua ya mwisho ya kuingia kwa SSO (SAML/OIDC): hubadilishana msimbo wa mara moja kutoka kwa uelekezaji upya kwa tokeni ya ufikiaji na tokeni ya refresh.

Baada ya kuingia kwa mtoa huduma wa utambulisho, Zentor App huelekeza kivinjari tena na msimbo wa mara moja katika kigezo cha swali `sso_code`. Tumeni msimbo huu kwenye sehemu `code`. Jibu lina `token` na `refreshToken` kama kuingia kwa kawaida. Msimbo kila mmoja ni halali mara moja na kwa muda mfupi tu. Msimbo ulioshatumika, uliopitwa muda au batili husababisha 400 `SSO_EXCHANGE_INVALID`; mtumiaji huanza tena kuingia kwa SSO. Hivyo wito huu si idempotent.

Muhtasari

Mwito: POST /api/auth/sso/exchange. Endpoint hii ni sehemu ya kundi la “Uthibitishaji” la API ya Zentor App. Inafikika hadharani na haihitaji uthibitishaji. Mwito huu si idempotent: kila mwito uliofanikiwa huanzisha kitendo upya. Vigezo vya lazima: code (body). Hali za hitilafu zilizoandikwa: 400 SSO_EXCHANGE_INVALID. Jibu la mfano hapa chini linaonyesha muundo wa jibu lililofanikiwa katika umbizo la JSON.

Uthibitishaji na ulinzi

Hakuna uthibitishaji unaohitajika

Idempotent: Hapana

Vigezo

code(body, string, inahitajika)— Msimbo wa mara moja kutoka uelekezaji wa SSO

Mfano wa ombi (request)

{"code":"<Msimbo wa matumizi moja kutoka kwa uelekezaji wa SSO callback>"}

Mfano wa jibu (response)

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

Misimbo ya hitilafu

400 SSO_EXCHANGE_INVALID — Msimbo ni batili, umetumika tayari au umepitwa muda.

Tabia iliyoangaliwa

Msimbo batili hutoa 400 `SSO_EXCHANGE_INVALID`. Hali ya mafanikio inahitaji kuingia kikamilifu kwa mtoa huduma wa utambulisho aliyesanidiwa.

Uthibitishaji

Makala zinazohusiana

← Uthibitishaji