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-SSOUmzekelo 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
POST /api/auth/loginIngenisa umsebenzisi ngedilesi ye-imeyile okanye igama lomsebenzisi kunye nephasiwedi kwaye ikhuphe i-token yokufikelela (JWT) kunye ne-refresh token.POST /api/auth/refreshTshintshela i-refresh-token esebenzayo ngesibini esitsha se-token yokufikelela kunye ne-refresh token.POST /api/auth/forgot-passwordIqalisa ukusetwa kwakhona kwephasiwedi: ukuba i-akhawunti enedilesi ye-imeyile enikeziweyo ikhona, ifumana i-imeyile enekhonkco lokusetwa kwakhona.POST /api/auth/reset-passwordIsetha iphasiwedi entsha nge-token ye-reset evela kwi-imeyile yokusetwa kwakhona.