GET/api/sso/:tenantSlug/oidc/start
Pornește autentificarea prin OpenID Connect și redirecționează browserul către furnizorul de identitate configurat.
Apelați endpointul prin navigare în browser, nu printr-o cerere JavaScript. Dacă OIDC este configurat, serverul răspunde cu o redirecționare (302) către furnizorul de identitate; după autentificare acolo, browserul se întoarce prin `oidc/callback`. Dacă OIDC 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/oidc/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 SSOExemplu de răspuns
(redirecționare 302 către furnizorul de identitate dacă OIDC este configurat pentru cont)
Coduri de eroare
404 - — OIDC nu este configurat pentru acest cont.Comportament verificat
Pentru un cont fără OIDC, 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/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.GET /api/sso/:tenantSlug/saml/metadataReturnează metadatele SAML ale Zentor App (XML) pentru import în furnizorul dumneavoastră de identitate.