GET/api/sso/:tenantSlug/oidc/callback

Primește redirecționarea furnizorului de identitate după autentificarea OIDC și redirecționează browserul înapoi la Zentor App.

Acest endpoint este apelat exclusiv de furnizorul de identitate prin redirecționare în browser; trebuie introdus ca URI de redirecționare în setările acestuia. Î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`. În caz de eroare – de exemplu dacă parametrul de securitate `state` lipsește sau este invalid – serverul redirecționează către pagina de autentificare cu parametrul de interogare `sso_error`, de exemplu `sso_error=SSO_STATE_MISSING`. În acest caz, reporniți autentificarea.

Prezentare generală

Apel: GET /api/sso/:tenantSlug/oidc/callback. 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). 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

Exemplu de răspuns

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

Coduri de eroare

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

Comportament verificat

Fără un `state` valid, serverul redirecționează către pagina de autentificare cu 302 și `sso_error=SSO_STATE_MISSING`.

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