POST/api/sso/:tenantSlug/saml/acs
Assertion Consumer Service (ACS): yamkela impendulo ye-SAML esayinweyo yomboneleli wesazisi nge-POST yefomu.
Lesi sibonakalo sibizwa ngomboneleli wesazisi kuphela; kufuneka singeniswe kwizicwangciso zakhe njengeURL ye-ACS (jonga `saml/metadata`). Umboneleli wesazisi uthumela impendulo esayinweyo, ehlanganiswe nge-base64 kwisimo sefomu `SAMLResponse`. 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`. Ukuba impendulo ingasebenziyo okanye inkqubo yokungena efanelekileyo ingekho, iseva idlulisela kwiphepha lokungena ngemfameta yombuzo `sso_error`, umzekelo `sso_error=SSO_STATE_MISSING`.
Ushwankathelo
Ukubiza: POST /api/sso/:tenantSlug/saml/acs. 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), SAMLResponse (body). Iimeko zeempazamo ezibhaliweyo: 302 SSO_STATE_MISSING.
Ukuqinisekiswa nokhuseleko
Akukho kuqinisekiswa kufunekayo
Idempotent: Hayi
Iiparamitha
tenantSlug(path, string, kuyafuneka)— Isibonakalo (slug) seakhawunti elisetyelweyo ne-SSOSAMLResponse(body, string, kuyafuneka)— Impendulo ye-SAML esayinweyo ngumboneleli wesazisi (i-XML, ehlanganiswe nge-base64) njengentsimbi yefomuUmzekelo we-response
Ukudluliselwa kwe-302 ku-https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (umzekelo ngaphandle kwempendulo ye-SAML esebenzayo)
Iikhowudi zeempazamo
302 SSO_STATE_MISSING — Ukudluliselwa kwiphepha lokungena nge-`sso_error`, ukuba impendulo ye-SAML ingasebenziyo okanye inkqubo yokungena efanelekileyo ingekho.Ukuziphatha okujongwe
I-`SAMLResponse` engasebenziyo ikhokelela ekudluliselweni (302) nge-`sso_error` 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/oidc/callbackYamkela ukudluliselwa komboneleli wesazisi emva kokungena nge-OIDC kwaye ibuyisela isikhangeli kwi-Zentor App.GET /api/sso/:tenantSlug/saml/startIqalisa ukungena nge-SAML kwaye idlulisela isikhangeli kumboneleli wesazisi osetiweyo.GET /api/sso/:tenantSlug/saml/metadataInikeza iinkcukacha ze-SAML ze-Zentor App (XML) ukuba zifakwe kumboneleli wenu wesazisi.