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-SSOIsibonelo 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
POST /api/auth/loginIngena umsebenzisi ngekheli le-imeyili noma igama lokusebenzisa nephasiwedi futhi ikhiphe ithokheni yokufinyelela (JWT) kanye nethokheni ye-refresh.POST /api/auth/refreshShintshanisa i-refresh-token esebenzayo ngombandela omusha wethokheni yokufinyelela nethokheni ye-refresh.POST /api/auth/forgot-passwordIqala ukusetha kabusha iphasiwedi: uma i-akhawunti enekheli le-imeyili elinikeziwe ikhona, ithola i-imeyili enesixhumanisi sokusetha kabusha.POST /api/auth/reset-passwordIsetha iphasiwedi entsha ngethokheni ye-reset evela ku-imeyili yokusetha kabusha.