GET/api/sso/:tenantSlug/saml/start

Pornește autentificarea prin SAML și redirecționează browserul către furnizorul de identitate configurat.

Apelați endpointul prin navigare în browser. Dacă SAML este configurat, serverul răspunde cu o redirecționare (302) către furnizorul de identitate; răspunsul acestuia este trimis apoi către `saml/acs`. Dacă SAML nu este configurat pentru cont, serverul răspunde cu 404 `SSO_NOT_CONFIGURED` și un mesaj de eroare JSON.

Prezentare generală

Apel: GET /api/sso/:tenantSlug/saml/start. 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

(redirecționare 302 către furnizorul de identitate dacă SAML este configurat pentru cont)

Coduri de eroare

404 - — SAML nu este configurat pentru acest cont.

Comportament verificat

Pentru un cont fără SAML, apelul 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.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): primește răspunsul SAML semnat al furnizorului de identitate printr-un POST de formular.GET /api/sso/:tenantSlug/saml/metadataReturnează metadatele SAML ale Zentor App (XML) pentru import în furnizorul dumneavoastră de identitate.

Articole similare

← Chatbot demonstrativ și SSO