POST/api/auth/sso/exchange

Danho repedzisiro rekupinda ne-SSO (SAML/OIDC): inotsinhanisa kodhi yekamwe chete inobva pakudzoserwa netokheni yekuwana nerefresh token.

Mushure mekupinda kumupi wezita, Zentor App inodzoserazve bhurauza netokheni yekamwe chete pamunda wemubvunzo unonzi `sso_code`. Tumirai kodhi iyi mumunda unonzi `code`. Mhinduro ine `token` ne`refreshToken` sezvinoitika kana kupinda kwakajairika. Kodhi imwe neimwe inoshanda kamwe chete uye kwenguva pfupi. Kodhi yakatoshandiswa, yapera nguva kana isingashandi, inoguma na-400 `SSO_EXCHANGE_INVALID`; mushandisi anotangazve kupinda kweSSO. Saka dana iri harisi idempotent.

Pfupiso

Kudana: POST /api/auth/sso/exchange. Endpoint iyi ndeyeboka re“Kusimbiswa” reAPI yeZentor App. Inowanikwa neveruzhinji uye haidi kusimbiswa (authentication). Kudana uku hakusi idempotent: kudana kwese kwese kunobudirira kunotangisa chiito zvakare. Maparameter anodiwa: code (body). Zviitiko zvezvikanganiso zvakanyorwa: 400 SSO_EXCHANGE_INVALID. Mhinduro yemuenzaniso iri pazasi inoratidza chimiro chemhinduro inobudirira muJSON format.

Kusimbiswa nekuchengetedza

Hapana kusimbiswa kunodiwa

Idempotent: Kwete

Maparameter

code(body, string, zvinodiwa)— Kodhi yekamwe chete inobva kudzoreredzo yeSSO

Muenzaniso wechikumbiro

{"code":"<Kodhi yekamwe chete kubva muSSO callback redirect>"}

Muenzaniso wemhinduro

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

Makodhi ekukanganisa

400 SSO_EXCHANGE_INVALID — Kodhi isingashandi, yakatoshandiswa kana yapera nguva.

Mafambiro akaongororwa

Kodhi isingashandi inopa 400 `SSO_EXCHANGE_INVALID`. Mamiriro ekubudirira anoda kupinda kwakazara kumupi wezita akagadzirirwa.

Kusimbiswa

Zvinyorwa zvine hukama

← Kusimbiswa