POST/api/auth/sso/exchange

Inyathelo lokugqibela lokungena nge-SSO (SAML/OIDC): itshintshanisa ikhowudi yesihlandlo esinye evela kwisiqondiso kabusha nge-token yokufikelela kunye ne-refresh token.

Emva kokungena komboneleli wobunini, i-Zentor App iqondisa kwakhona ibhrawuza ngekhowudi yesihlandlo esinye kwipharamitha yombuzo ethi `sso_code`. Thumela ikhowudi kwimveliso ethi `code`. Impendulo iqulathe `token` ne`refreshToken` njengokungena okuqhelekileyo. Ikhowudi nganye isebenza kube kanye kuphela kwaye kwixesha elifutshane. Ikhowudi esele isetyenziswa, ephelelwe ixesha okanye engasebenziyo, ikhokelela ku-400 `SSO_EXCHANGE_INVALID`; umsebenzisi uqalisa ukungena kwe-SSO kwakhona. Ngoko ke le ntlanganiso ayidibananga.

Ushwankathelo

Ukubiza: POST /api/auth/sso/exchange. Le endpoint yeyeqela elithi “Uqinisekiso” le-API ye-Zentor App. Ifikeleleka esidlangalaleni kwaye ayifuni kuqinisekiswa kwesazisi (authentication). Ukubiza ayisiyo i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kwakhona. Iipharamitha ezinyanzelekileyo: code (body). Iimeko zeempazamo ezibhaliweyo: 400 SSO_EXCHANGE_INVALID. Impendulo engumzekelo engezantsi ibonisa ulwakhiwo lwempendulo ephumelelayo ngefomathi ye-JSON.

Ukuqinisekiswa nokhuseleko

Akukho kuqinisekiswa kufunekayo

Idempotent: Hayi

Iiparamitha

code(body, string, kuyafuneka)— Ikhowudi yesihlandlo esinye evela kwisiqondiso kwe-SSO

Umzekelo we-request

{"code":"<Ikhowudi yesihlandlo esinye evela kwi-SSO callback redirect>"}

Umzekelo we-response

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

Iikhowudi zeempazamo

400 SSO_EXCHANGE_INVALID — Ikhowudi ayisebenzi, isele isetyenziswa okanye iphelelwe ixesha.

Ukuziphatha okujongwe

Ikhowudi engasebenziyo inika i-400 `SSO_EXCHANGE_INVALID`. Imeko yempumelelo ifuna ukungena ngokupheleleyo komboneleli wobunini oluselweyo.

Uqinisekiso

Amanqaku ahambelanayo

← Uqinisekiso