POST/api/auth/sso/exchange

Isinyathelo sokugcina sokungena nge-SSO (SAML/OIDC): ishintshanisa ikhodi yokungenise eyodwa evela ekuqondisweni kabusha ngethokheni yokufinyelela nethokheni ye-refresh.

Ngemva kokungena komhlinzeki wesikhundla, i-Zentor App iqondisa ibhuraza kabusha ngekhodi yokungenise eyodwa kumbandela wokubuza `sso_code`. Thumela leli khodi ensimini ethi `code`. Impendulo iqukethe `token` ne`refreshToken` njengokungena okuvamile. Ikhodi ngayinye isebenza kanye kuphela futhi isebenza isikhathi esifushane. Ikhodi eyasivele isetshenzisiwe, ephelelwe isikhathi noma engasebenzi, iholela ku-400 `SSO_EXCHANGE_INVALID`; umsebenzisi uqala ukungena kwe-SSO kabusha. Ngalokho lesi sibizo asihlangene.

Ukubuka konke

Ukubiza: POST /api/auth/sso/exchange. Le endpoint ingeyeqembu elithi “Ukuqinisekiswa” le-API ye-Zentor App. Ifinyeleleka esidlangalaleni futhi ayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza akuyona i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kabusha. Amapharamitha ayimpoqo: code (body). Izimo zamaphutha ezibhaliwe: 400 SSO_EXCHANGE_INVALID. Isibonelo sempendulo ngezansi sibonisa ukwakheka kwempendulo ephumelelayo ngefomethi ye-JSON.

Ukuqinisekisa ubunikazi nokuvikeleka

Akudingeki ukuqinisekisa ubunikazi

I-idempotent: Cha

Amapharamitha

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

Isibonelo se-request

{"code":"<ikhodi yokusetshenziswa kanye evela ku-SSO callback redirect>"}

Isibonelo se-response

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

Amakhodi amaphutha

400 SSO_EXCHANGE_INVALID — Ikhodi ayisebenzi, yasivele isetshenzisiwe noma iphelelwe isikhathi.

Ukuziphatha okuhlolwe

Ikhodi engasebenzi inikeza i-400 `SSO_EXCHANGE_INVALID`. Isimo sempumelelo sidinga ukungena okuphelele komhlinzeki wesikhundla olungisiwe.

Ukuqinisekiswa

Izihloko ezihlobene

← Ukuqinisekiswa