GET/api/sso/:tenantSlug/oidc/callback

Yamkela ukudluliselwa komboneleli wesazisi emva kokungena nge-OIDC kwaye ibuyisela isikhangeli kwi-Zentor App.

Lesi sibonakalo sibizwa ngomboneleli wesazisi kuphela ngokudluliselwa kwesikhangeli; kufuneka singeniswe kwizicwangciso zakhe njengendlela yokudluliselwa-URI. Xa kuphumelele, i-Zentor App ibuyisela isikhangeli kunye nekhowudi yesihlandlo esinye kwimfameta yombuzo `sso_code`; lekhowudi itshintshiswa ngethokheni yokungena nge-`POST /api/auth/sso/exchange`. Xa kukho impazamo – umzekelo ukuba imfameta yokhuseleko `state` ayikho okanye ayisebenzi – iseva idlulisela kwiphepha lokungena ngemfameta yombuzo `sso_error`, umzekelo `sso_error=SSO_STATE_MISSING`. Qalisa ukungena kwakhona.

Ushwankathelo

Ukubiza: GET /api/sso/:tenantSlug/oidc/callback. Le endpoint yeyeqela elithi “Idemo ye-chatbot ne-SSO” le-API ye-Zentor App. Ifikeleleka esidlangalaleni kwaye ayifuni kuqinisekiswa kwesazisi (authentication). Ukubiza ayisiyo i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kwakhona. Iipharamitha ezinyanzelekileyo: tenantSlug (path). Iimeko zeempazamo ezibhaliweyo: 302 SSO_STATE_MISSING.

Ukuqinisekiswa nokhuseleko

Akukho kuqinisekiswa kufunekayo

Idempotent: Hayi

Iiparamitha

tenantSlug(path, string, kuyafuneka)— Isibonakalo (slug) seakhawunti elisetyelweyo ne-SSO

Umzekelo we-response

Ukudluliselwa kwe-302 ku-https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (umzekelo ngaphandle kwe-`state` esemthethweni)

Iikhowudi zeempazamo

302 SSO_STATE_MISSING — Ukudluliselwa kwiphepha lokungena nge-`sso_error`, ukuba i-`state` ayikho okanye ayisebenzi.

Ukuziphatha okujongwe

Ngaphandle kwe-`state` esemthethweni, iseva idlulisela nge-302 kunye ne-`sso_error=SSO_STATE_MISSING` kwiphepha lokungena.

Idemo ye-chatbot ne-SSO

POST /api/global-chatbot/demoIthumela umyalezo kwibhoti yokubonisa yoluntu ku-zentor-app.de/demo kwaye inikeze impendulo yayo. Idemo inganzanwa ngaphandle kokubhalisa kwibhrawuza.GET /api/global-chatbot/demo/historyIlayisha imbali yemiyalezo yangaphambili yencoko yedemo ukuze igcinwe xa idemo ivulwa kwakhona.POST /api/global-chatbot/demo/pollLithatha imiyalezo emitsha yencoko yedemo, umzekelo xa umsebenzi we-Zentor uthatha incoko. Iphepha ledemo libiza isidibanisi kumaxesha athile.POST /api/global-chatbot/demo/ratingIgcina ukuvavanywa kwencoko yedemo (okunceda okanye okungancedi) ngokuphawula okukhethiweyo.POST /api/global-chatbot/demo/trackIrekhoda iziganeko zokusetyenziswa ezingaziwayo zephepha ledemo zamanani weendwendwe ze-Zentor.POST /api/global-chatbot/demo/voice-transcribeIguqula uqoshoyi lwezwi kwiphepha ledemo kube ngumbhalo (ongeno lwezwi), ukuba umsebenzi wezwi wedemo uvuliwe.POST /api/global-chatbot/demo/voice-speakIguqula umbhalo ube yintetho ekhulunywayo (isandi kwikhasi ledemo), ukuba umsebenzi wentetho yedemo uvulwe.GET /api/sso/:tenantSlug/statusIhlola ukuba ukungena kanye (SAML okanye OIDC) kusetwe na kwi-akhawunti. Iphepha lokungena lisebenzisa isiphumo ukunika ukungena nge-SSO.GET /api/sso/:tenantSlug/oidc/startIqalisa ukungena nge-OpenID Connect kwaye idlulisela isikhangeli kumboneleli wesazisi osetiweyo.GET /api/sso/:tenantSlug/saml/startIqalisa ukungena nge-SAML kwaye idlulisela isikhangeli kumboneleli wesazisi osetiweyo.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): yamkela impendulo ye-SAML esayinweyo yomboneleli wesazisi nge-POST yefomu.GET /api/sso/:tenantSlug/saml/metadataInikeza iinkcukacha ze-SAML ze-Zentor App (XML) ukuba zifakwe kumboneleli wenu wesazisi.

Amanqaku ahambelanayo

← Idemo ye-chatbot ne-SSO