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-SSO
SAMLResponse(body, string, kuyadingeka)— Impendulo ye-SAML esayiniwe ngomhlinzeki womazisi (i-XML, ehlanganiswe nge-base64) njengensimu yefomu

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

Izihloko ezihlobene

← Idemo ye-chatbot ne-SSO