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 SSO

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

Powiązane artykuły

← Chatbot demonstracyjny i SSO