GET/api/sso/:tenantSlug/saml/metadata

Returnează metadatele SAML ale Zentor App (XML) pentru import în furnizorul dumneavoastră de identitate.

Metadatele conțin, printre altele, entity ID și URL-ul ACS de care furnizorul dumneavoastră de identitate are nevoie pentru configurare. Răspunsul este un document XML, nu JSON. Dacă SAML nu este configurat pentru cont, serverul răspunde cu 404 `SSO_NOT_CONFIGURED`.

Prezentare generală

Apel: GET /api/sso/:tenantSlug/saml/metadata. Acest endpoint aparține grupului „Chatbot demonstrativ și SSO” al API-ului Zentor App. Este accesibil public și nu necesită autentificare. Apelul este idempotent: apelurile repetate cu aceleași date returnează același rezultat. Parametri obligatorii: tenantSlug (cale). Cazuri de eroare documentate: 404 -.

Autentificare și securitate

Nu este necesară autentificarea

Idempotent: Da

Parametri

tenantSlug(path, string, obligatoriu)— Identificatorul (slug) al contului pentru care este configurat SSO

Exemplu de răspuns

(metadate SAML ca document XML dacă SAML este configurat pentru cont – nu JSON)

Coduri de eroare

404 - — SAML nu este configurat pentru acest cont.

Comportament verificat

Pentru un cont fără SAML, cererea returnează 404.

Chatbot demonstrativ și SSO

POST /api/global-chatbot/demoTrimite un mesaj către chatbotul demonstrativ public de la zentor-app.de/demo și returnează răspunsul acestuia. Demo-ul poate fi testat în browser fără înregistrare.GET /api/global-chatbot/demo/historyÎncarcă istoricul de mesaje al unei conversații demonstrative, astfel încât acesta să fie păstrat la reluarea demo-ului.POST /api/global-chatbot/demo/pollObține mesajele noi ale unei conversații demonstrative, de exemplu atunci când un angajat Zentor a preluat conversația. Pagina demo apelează endpointul la intervale.POST /api/global-chatbot/demo/ratingSalvează evaluarea unei conversații demonstrative (utilă sau neutilă) cu un comentariu opțional.POST /api/global-chatbot/demo/trackÎnregistrează evenimente de utilizare anonime ale paginii demo pentru statisticile de vizitatori ale Zentor.POST /api/global-chatbot/demo/voice-transcribeConvertește o înregistrare vocală de pe pagina demo în text (intrare vocală), dacă funcția vocală a demo-ului este activată.POST /api/global-chatbot/demo/voice-speakConvertește text în vorbire (ieșire vocală pe pagina demo), dacă funcția vocală a demo-ului este activată.GET /api/sso/:tenantSlug/statusVerifică dacă autentificarea unică (SAML sau OIDC) este configurată pentru un cont. Pagina de autentificare folosește rezultatul pentru a oferi autentificarea SSO.GET /api/sso/:tenantSlug/oidc/startPornește autentificarea prin OpenID Connect și redirecționează browserul către furnizorul de identitate configurat.GET /api/sso/:tenantSlug/oidc/callbackPrimește redirecționarea furnizorului de identitate după autentificarea OIDC și redirecționează browserul înapoi la Zentor App.GET /api/sso/:tenantSlug/saml/startPornește autentificarea prin SAML și redirecționează browserul către furnizorul de identitate configurat.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): primește răspunsul SAML semnat al furnizorului de identitate printr-un POST de formular.

Articole similare

← Chatbot demonstrativ și SSO