GET/api/sso/:tenantSlug/oidc/callback
Yamukela ukudluliselwa komnikezeli wesazisi ngemva kokungena nge-OIDC njalo ibuyisela isikhangeli kuZentor App.
Lesisibonakalo sibizwa kuphela ngumnikezeli wesazisi ngokudluliselwa kwesikhangeli; kumele singeniswe ezilungiselelweni zakhe njengendlela yokudluliselwa-URI. Nxa kuphumelele, iZentor App ibuyisela isikhangeli lekhodi yesikhathi esinye kumethrameta yesicelo `sso_code`; lekhodi itshintshiswa ngethokheni yokungena nge-`POST /api/auth/sso/exchange`. Nxa kuyiphutha – isibonelo nxa imethrameta yokuvikela `state` ingekho kumbe ingalungile – iseva idlulisela ekhasini lokungena lemethrameta yesicelo `sso_error`, isibonelo `sso_error=SSO_STATE_MISSING`. Qalani ukungena kutsha.
Isifinyezo
Ukubiza: GET /api/sso/:tenantSlug/oidc/callback. 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). 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 SSOIsibonelo sempendulo (response)
Ukudluliselwa kwe-302 ku-https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (isibonelo ngaphandle kwe-`state` esemthethweni)
Amakhodi amaphutha
302 SSO_STATE_MISSING — Ukudluliselwa ekhasini lokungena nge-`sso_error`, nxa i-`state` ingekho kumbe ingalungile.Ukuziphatha okuhlolwe
Ngaphandle kwe-`state` esemthethweni, iseva idlulisela nge-302 le-`sso_error=SSO_STATE_MISSING` 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/saml/startIqala ukungena nge-SAML njalo idlulisela isikhangeli kumnikezeli wesazisi olungiswe.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): yamukela impendulo ye-SAML esayinweyo yomnikezeli wesazisi nge-POST yefomu.GET /api/sso/:tenantSlug/saml/metadataInikeza imininingwane ye-SAML yeZentor App (XML) ukuba ifakwe emnikezelini wenu wesazisi.