POST/api/auth/sso/exchange

Isinyathelo sokucina sokungena nge-SSO (SAML/OIDC): itshintshanisa ikhodi yakanye evela ekuqondisweni kutsha ngethokheni yokufinyelela lerefresh token.

Ngemva kokungena komnikezeli wobunikazi, iZentor App iqondisa kutsha ibhrawuza ngekhodi yakanye kupharamitha yombuzo ethi `sso_code`. Thumelani ikhodi le ensimini ethi `code`. Impendulo iqukethe `token` le`refreshToken` njengokungena okujayelekileyo. Ikhodi ngayinye isebenza kakanye kuphela njalo isebenza isikhathi esincane. Ikhodi eyasele isetshenzisiwe, ephelelwe isikhathi kumbe engasebenziyo, iholela ku-400 `SSO_EXCHANGE_INVALID`; umsebenzisi aqalise ukungena kwe-SSO kutsha. Ngakho lesibizo kasihlanganiswe.

Isifinyezo

Ukubiza: POST /api/auth/sso/exchange. Le endpoint ingeyeqembu elithi “Ukuqinisekiswa” le-API ye-Zentor App. Ifinyeleleka emphakathini njalo kayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza kakusiyo i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kutsha. Amapharamitha adingekayo: code (body). Izimo zamaphutha ezibhaliweyo: 400 SSO_EXCHANGE_INVALID. Isibonelo sempendulo ngezansi sitshengisa ukwakheka kwempendulo ephumelelayo ngefomethi ye-JSON.

Ukuqinisekisa ubuwena lokuvikeleka

Kakudingeki ukuqinisekisa ubuwena

I-idempotent: Hatshi

Amapharamitha

code(body, string, kuyadingeka)— Ikhodi yakanye evela ekuqondisweni kwe-SSO

Isibonelo sesicelo (request)

{"code":"<ikhodi yokusetshenziswa kanye evela ku-SSO-Callback-Redirect>"}

Isibonelo sempendulo (response)

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

Amakhodi amaphutha

400 SSO_EXCHANGE_INVALID — Ikhodi kayisebenzi, eyasele isetshenzisiwe kumbe eyaphelelwa isikhathi.

Ukuziphatha okuhlolwe

Ikhodi engasebenziyo inikeza i-400 `SSO_EXCHANGE_INVALID`. Isimo sempumelelo sidinga ukungena okupheleleyo komnikezeli wobunikazi olulungiswayo.

Ukuqinisekiswa

Izihloko ezihlobene

← Ukuqinisekiswa