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-SSOIsibonelo 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
POST /api/auth/loginIngenisa umsebenzisi ngekheli le-imeyili kumbe ibizo lokusebenzisa lephasiwedi njalo ikhuphe ithokheni yokufinyelela (JWT) kanye lerefresh token.POST /api/auth/refreshItshintshanisa i-refresh-token esebenzayo ngombandela omutsha wethokheni yokufinyelela lerefresh token.POST /api/auth/forgot-passwordIqala ukusetha kutsha iphasiwedi: nxa i-akhawunti elekheli le-imeyili elinikeziweyo ikhona, ithola i-imeyili elesixhumanisi sokusetha kutsha.POST /api/auth/reset-passwordIsetha iphasiwedi entsha ngethokheni ye-reset evela ku-imeyili yokusetha kutsha.