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 SSO

Isibonelo 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.

Izihloko ezihlobene

← Idemo ye-chatbot le-SSO