GET/api/sso/:tenantSlug/saml/start
Uruchamia logowanie przez SAML i przekierowuje przeglądarkę do skonfigurowanego dostawcy identyfikacji.
Wywołaj endpoint przez nawigację przeglądarki. Jeśli SAML jest skonfigurowane, serwer odpowiada przekierowaniem (302) do dostawcy identyfikacji; jego odpowiedź jest następnie przesyłana do `saml/acs`. Jeśli SAML nie jest skonfigurowane dla konta, serwer odpowiada kodem 404 `SSO_NOT_CONFIGURED` i komunikatem błędu JSON.
Przegląd
Wywołanie: GET /api/sso/:tenantSlug/saml/start. Ten endpoint należy do grupy „Chatbot demonstracyjny i SSO” API Zentor App. Jest publicznie dostępny i nie wymaga uwierzytelniania. Wywołanie jest idempotentne: powtarzane wywołania z tymi samymi danymi zwracają ten sam wynik. Parametry wymagane: tenantSlug (ścieżka). Udokumentowane przypadki błędów: 404 -.
Uwierzytelnianie i zabezpieczenia
Uwierzytelnianie nie jest wymagane
Idempotentny: Tak
Parametry
tenantSlug(path, string, wymagane)— Identyfikator (slug) konta, dla którego skonfigurowano SSOPrzykładowa odpowiedź
(przekierowanie 302 do dostawcy identyfikacji, jeśli SAML jest skonfigurowane dla konta)
Kody błędów
404 - — SAML nie jest skonfigurowane dla tego konta.Zweryfikowane zachowanie
Dla konta bez SAML wywołanie zwraca 404.
Chatbot demonstracyjny i SSO
POST /api/global-chatbot/demoWysyła wiadomość do publicznego chatbota demonstracyjnego na zentor-app.de/demo i zwraca jego odpowiedź. Demo można wypróbować w przeglądarce bez rejestracji.GET /api/global-chatbot/demo/historyWczytuje dotychczasową historię wiadomości rozmowy demonstracyjnej, aby zachować ją po ponownym otwarciu demo.POST /api/global-chatbot/demo/pollPobiera nowe wiadomości rozmowy demonstracyjnej, np. gdy pracownik Zentor przejął rozmowę. Strona demo wywołuje endpoint w odstępach czasu.POST /api/global-chatbot/demo/ratingZapisuje ocenę rozmowy demonstracyjnej (pomocna lub niepomocna) z opcjonalnym komentarzem.POST /api/global-chatbot/demo/trackRejestruje anonimowe zdarzenia użycia strony demo na potrzeby statystyk odwiedzających Zentor.POST /api/global-chatbot/demo/voice-transcribeZamienia nagranie głosowe na stronie demo na tekst (wejście głosowe), jeśli funkcja głosowa demo jest włączona.POST /api/global-chatbot/demo/voice-speakZamienia tekst na mowę (wyjście głosowe na stronie demo), jeśli funkcja głosowa demo jest włączona.GET /api/sso/:tenantSlug/statusSprawdza, czy jednokrotne logowanie (SAML lub OIDC) jest skonfigurowane dla konta. Strona logowania wykorzystuje wynik, aby zaproponować logowanie SSO.GET /api/sso/:tenantSlug/oidc/startUruchamia logowanie przez OpenID Connect i przekierowuje przeglądarkę do skonfigurowanego dostawcy identyfikacji.GET /api/sso/:tenantSlug/oidc/callbackOdbiera przekierowanie dostawcy identyfikacji po zalogowaniu OIDC i przekierowuje przeglądarkę z powrotem do Zentor App.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): odbiera podpisaną odpowiedź SAML od dostawcy identyfikacji poprzez formularzowy POST.GET /api/sso/:tenantSlug/saml/metadataZwraca metadane SAML Zentor App (XML) do zaimportowania w Państwa dostawcy identyfikacji.