GET/api/sso/:tenantSlug/saml/metadata

Zwraca metadane SAML Zentor App (XML) do zaimportowania w Państwa dostawcy identyfikacji.

Metadane zawierają między innymi entity ID i URL ACS, których Państwa dostawca identyfikacji potrzebuje do konfiguracji. Odpowiedź jest dokumentem XML, nie JSON. Jeśli SAML nie jest skonfigurowane dla konta, serwer odpowiada kodem 404 `SSO_NOT_CONFIGURED`.

Przegląd

Wywołanie: GET /api/sso/:tenantSlug/saml/metadata. 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ź

(metadane SAML jako dokument XML, jeśli SAML jest skonfigurowane dla konta – nie JSON)

Kody błędów

404 - — SAML nie jest skonfigurowane dla tego konta.

Zweryfikowane zachowanie

Dla konta bez SAML żądanie 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.GET /api/sso/:tenantSlug/saml/startUruchamia logowanie przez SAML i przekierowuje przeglądarkę do skonfigurowanego dostawcy identyfikacji.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): odbiera podpisaną odpowiedź SAML od dostawcy identyfikacji poprzez formularzowy POST.

Powiązane artykuły

← Chatbot demonstracyjny i SSO