POST/api/sso/:tenantSlug/saml/acs
Assertion Consumer Service (ACS): yamukela impendulo ye-SAML esayiniwe yomhlinzeki womazisi nge-POST yefomu.
Lesi sibonakalo sibizwa kuphela umhlinzeki womazisi; kumele singeniswe ezilungiselelweni zakhe njenge-URL ye-ACS (bheka `saml/metadata`). Umhlinzeki womazisi uthumela impendulo esayiniwe, ehlanganiswe nge-base64 esimweni sefomu `SAMLResponse`. Uma kuphumelele, i-Zentor App ibuyisela isiphequluli nekhodi yesikhathi esisodwa kumethrameta yomcelo `sso_code`; lekhodi ishintshaniswa ngethokheni yokungena nge-`POST /api/auth/sso/exchange`. Uma impendulo ingekho emthethweni noma inqubo yokungena efanele ingekho, iseva idlulisela ekhasini lokungena nemethrameta yomcelo `sso_error`, isibonelo `sso_error=SSO_STATE_MISSING`.
Ukubuka konke
Ukubiza: POST /api/sso/:tenantSlug/saml/acs. Le endpoint ingeyeqembu elithi “Idemo ye-chatbot ne-SSO” le-API ye-Zentor App. Ifinyeleleka esidlangalaleni futhi ayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza akuyona i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kabusha. Amapharamitha ayimpoqo: tenantSlug (path), SAMLResponse (body). Izimo zamaphutha ezibhaliwe: 302 SSO_STATE_MISSING.
Ukuqinisekisa ubunikazi nokuvikeleka
Akudingeki ukuqinisekisa ubunikazi
I-idempotent: Cha
Amapharamitha
tenantSlug(path, string, kuyadingeka)— Isibonakalo (slug) se-akhawunti elungiselelwe i-SSOSAMLResponse(body, string, kuyadingeka)— Impendulo ye-SAML esayiniwe ngomhlinzeki womazisi (i-XML, ehlanganiswe nge-base64) njengensimu yefomuIsibonelo se-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`, uma impendulo ye-SAML ingekho emthethweni noma inqubo yokungena efanele ingekho.Ukuziphatha okuhlolwe
I-`SAMLResponse` engalungile iholela ekudluliselweni (302) nge-`sso_error` ekhasini lokungena.
Idemo ye-chatbot ne-SSO
POST /api/global-chatbot/demoIthumela umlayezo kubhothi lokubonisa yomphakathi ku-zentor-app.de/demo futhi inikeze impendulo yayo. Idemo ingazanywa ngaphandle kobhalisi kubhrawuza.GET /api/global-chatbot/demo/historyIlayisha umlando wemiyalezo yangaphambilini wengxoxo yedemo ukuze igcinwe uma idemo ivulwa kabusha.POST /api/global-chatbot/demo/pollLithatha imiyalezo emisha yengxoxo yedemo, isibonelo uma isisebenzi se-Zentor sithatha ingxoxo. Ikhasi ledemo libiza isixhumi ngezikhathi ezihleliwe.POST /api/global-chatbot/demo/ratingIgcina ukuhlolwa kwengxoxo yedemo (okusizile noma okungasizile) ngokuphawula okukhethekile.POST /api/global-chatbot/demo/trackIrekhoda izenzakalo zokusetshenziswa ezingaziwa zekhasi ledemo zamanani wezivakashi ze-Zentor.POST /api/global-chatbot/demo/voice-transcribeIguqula ukuqoshwa kwezwi ekhasini ledemo kube ngumbhalo (okungenayo kwezwi), uma umsebenzi wezwi wedemo uvuliwe.POST /api/global-chatbot/demo/voice-speakIguqula umbhalo ube yinkulumo (umsindo wasekhaya wekhulumo kukhasi lwedemo), uma umsebenzi wenkulumo wedemo uvuliwe.GET /api/sso/:tenantSlug/statusIhlola ukuthi ukungena kanye (SAML noma OIDC) kulungiswe yini ku-akhawunti. Ikhasi lokungena lisebenzisa umphumela ukuze linikeze ukungena nge-SSO.GET /api/sso/:tenantSlug/oidc/startIqala ukungena nge-OpenID Connect futhi idlulisele isiphequluli kumhlinzeki womazisi olungiswe.GET /api/sso/:tenantSlug/oidc/callbackYamukela ukudluliselwa komhlinzeki womazisi ngemva kokungena nge-OIDC futhi ibuyisele isiphequluli ku-Zentor App.GET /api/sso/:tenantSlug/saml/startIqala ukungena nge-SAML futhi idlulisele isiphequluli kumhlinzeki womazisi olungiswe.GET /api/sso/:tenantSlug/saml/metadataInikeza imininingwane ye-SAML ye-Zentor App (XML) ukuba ifakwe emhlinzekini wenu womazisi.