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 SSOSAMLResponse(body, string, kuyadingeka)— Impendulo ye-SAML esayinweyo ngumnikezeli wesazisi (i-XML, ehlanganiswe nge-base64) njengemethrameta yefomuIsibonelo 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.