POST/api/sso/:tenantSlug/saml/acs

Assertion Consumer Service (ACS): yamukela impendulo ye-SAML esayinweyo yomnikezeli wesazisi nge-POST yefomu.

Lesisibonakalo sibizwa kuphela ngumnikezeli wesazisi; kumele singeniswe ezilungiselelweni zakhe njenge-URL ye-ACS (bonani `saml/metadata`). Umnikezeli wesazisi uthumela impendulo esayinweyo, ehlanganiswe nge-base64 esimweni sefomu `SAMLResponse`. Nxa kuphumelele, iZentor App ibuyisela isikhangeli lekhodi yesikhathi esinye kumethrameta yesicelo `sso_code`; lekhodi itshintshiswa ngethokheni yokungena nge-`POST /api/auth/sso/exchange`. Nxa impendulo ingekho emthethweni kumbe inqubo yokungena efaneleyo ingekho, iseva idlulisela ekhasini lokungena lemethrameta yesicelo `sso_error`, isibonelo `sso_error=SSO_STATE_MISSING`.

Isifinyezo

Ukubiza: POST /api/sso/:tenantSlug/saml/acs. Le endpoint ingeyeqembu elithi “Idemo ye-chatbot le-SSO” le-API ye-Zentor App. Ifinyeleleka emphakathini njalo kayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza kakusiyo i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kutsha. Amapharamitha adingekayo: tenantSlug (path), SAMLResponse (body). Izimo zamaphutha ezibhaliweyo: 302 SSO_STATE_MISSING.

Ukuqinisekisa ubuwena lokuvikeleka

Kakudingeki ukuqinisekisa ubuwena

I-idempotent: Hatshi

Amapharamitha

tenantSlug(path, string, kuyadingeka)— Isibonakalo (slug) se-akhawunti elungiselelwe SSO
SAMLResponse(body, string, kuyadingeka)— Impendulo ye-SAML esayinweyo ngumnikezeli wesazisi (i-XML, ehlanganiswe nge-base64) njengemethrameta yefomu

Isibonelo sempendulo (response)

Ukudluliselwa kwe-302 ku-https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (isibonelo ngaphandle kwempendulo ye-SAML esemthethweni)

Amakhodi amaphutha

302 SSO_STATE_MISSING — Ukudluliselwa ekhasini lokungena nge-`sso_error`, nxa impendulo ye-SAML ingekho emthethweni kumbe inqubo yokungena efaneleyo ingekho.

Ukuziphatha okuhlolwe

I-`SAMLResponse` engalungile iholela ekudluliselweni (302) nge-`sso_error` ekhasini lokungena.

Idemo ye-chatbot le-SSO

POST /api/global-chatbot/demoIthumela umlayezo kubhothi lokubonisa yomphakathi ku-zentor-app.de/demo njalo inikeze impendulo yayo. Idemo ingazanywa ngaphandle kokubhalisa kubhrawuza.GET /api/global-chatbot/demo/historyIlayitsha umlando wemilayezo wangaphambilini wengxoxo yedemo ukuthi igcinwe nxa idemo ivulwa kutsha.POST /api/global-chatbot/demo/pollLithatha imilayezo emitsha yengxoxo yedemo, isibonelo nxa isisebenzi seZentor sithatha ingxoxo. Ikhasi ledemo libiza isihlanganiso ngezikhathi ezihleliweyo.POST /api/global-chatbot/demo/ratingIgcina ukuhlolwa kwengxoxo yedemo (okusiza kumbe okungasizi) ngokuphawula okukhethiweyo.POST /api/global-chatbot/demo/trackIrekhoda izenzakalo zokusetshenziswa ezingaziwayo zekhasi ledemo zamanani wezivakatshi zeZentor.POST /api/global-chatbot/demo/voice-transcribeIguqula ukuqoshwa kwezwi ekhasini ledemo kube umbhalo (ukungena kwezwi), nxa umsebenzi wezwi wedemo uvuliwe.POST /api/global-chatbot/demo/voice-speakIguqula umbhalo ube yikhulumo (umsindo kukhasi ledemo), nxa umsebenzi wenkulumo wedemo uvuliwe.GET /api/sso/:tenantSlug/statusIhlola ukuthi ukungena kanye (SAML kumbe OIDC) kulungiswe yini ku-akhawunti. Ikhasi lokungena lisebenzisa umphumela ukuze linikeze ukungena nge-SSO.GET /api/sso/:tenantSlug/oidc/startIqala ukungena nge-OpenID Connect njalo idlulisela isikhangeli kumnikezeli wesazisi olungiswe.GET /api/sso/:tenantSlug/oidc/callbackYamukela ukudluliselwa komnikezeli wesazisi ngemva kokungena nge-OIDC njalo ibuyisela isikhangeli kuZentor App.GET /api/sso/:tenantSlug/saml/startIqala ukungena nge-SAML njalo idlulisela isikhangeli kumnikezeli wesazisi olungiswe.GET /api/sso/:tenantSlug/saml/metadataInikeza imininingwane ye-SAML yeZentor App (XML) ukuba ifakwe emnikezelini wenu wesazisi.

Izihloko ezihlobene

← Idemo ye-chatbot le-SSO