POST/api/sso/:tenantSlug/saml/acs

Assertion Consumer Service (ACS): primește răspunsul SAML semnat al furnizorului de identitate printr-un POST de formular.

Acest endpoint este apelat exclusiv de furnizorul de identitate; trebuie introdus ca URL ACS în setările acestuia (vezi `saml/metadata`). Furnizorul de identitate trimite răspunsul semnat, codificat base64, în câmpul de formular `SAMLResponse`. În caz de succes, Zentor App redirecționează browserul înapoi cu codul de unică folosință în parametrul de interogare `sso_code`; acest cod este schimbat cu un token de acces prin `POST /api/auth/sso/exchange`. Dacă răspunsul este invalid sau lipsește procesul de autentificare asociat, serverul redirecționează către pagina de autentificare cu parametrul de interogare `sso_error`, de exemplu `sso_error=SSO_STATE_MISSING`.

Prezentare generală

Apel: POST /api/sso/:tenantSlug/saml/acs. Acest endpoint aparține grupului „Chatbot demonstrativ și SSO” al API-ului Zentor App. Este accesibil public și nu necesită autentificare. Apelul nu este idempotent: fiecare apel reușit declanșează din nou acțiunea. Parametri obligatorii: tenantSlug (cale), SAMLResponse (body). Cazuri de eroare documentate: 302 SSO_STATE_MISSING.

Autentificare și securitate

Nu este necesară autentificarea

Idempotent: Nu

Parametri

tenantSlug(path, string, obligatoriu)— Identificatorul (slug) al contului pentru care este configurat SSO
SAMLResponse(body, string, obligatoriu)— Răspuns SAML semnat de furnizorul de identitate (XML, codificat base64) ca și câmp de formular

Exemplu de răspuns

Redirecționare 302 către https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (exemplu fără răspuns SAML valid)

Coduri de eroare

302 SSO_STATE_MISSING — Redirecționare către pagina de autentificare cu `sso_error` dacă răspunsul SAML este invalid sau procesul de autentificare lipsește.

Comportament verificat

Un `SAMLResponse` invalid duce la o redirecționare (302) către pagina de autentificare cu `sso_error`.

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