POST/api/sso/:tenantSlug/saml/acs

Assertion Consumer Service (ACS): odbiera podpisaną odpowiedź SAML od dostawcy identyfikacji poprzez formularzowy POST.

Ten endpoint jest wywoływany wyłącznie przez dostawcę identyfikacji; musi zostać wprowadzony w jego ustawieniach jako URL ACS (zob. `saml/metadata`). Dostawca identyfikacji wysyła podpisaną, zakodowaną w base64 odpowiedź w polu formularza `SAMLResponse`. W przypadku powodzenia Zentor App przekierowuje przeglądarkę z powrotem z jednorazowym kodem w parametrze zapytania `sso_code`; kod ten wymieniany jest na token dostępu przez `POST /api/auth/sso/exchange`. Jeśli odpowiedź jest nieprawidłowa lub brakuje powiązanego procesu logowania, serwer przekierowuje do strony logowania z parametrem zapytania `sso_error`, np. `sso_error=SSO_STATE_MISSING`.

Przegląd

Wywołanie: POST /api/sso/:tenantSlug/saml/acs. Ten endpoint należy do grupy „Chatbot demonstracyjny i SSO” API Zentor App. Jest publicznie dostępny i nie wymaga uwierzytelniania. Wywołanie nie jest idempotentne: każde udane wywołanie ponownie uruchamia akcję. Parametry wymagane: tenantSlug (ścieżka), SAMLResponse (body). Udokumentowane przypadki błędów: 302 SSO_STATE_MISSING.

Uwierzytelnianie i zabezpieczenia

Uwierzytelnianie nie jest wymagane

Idempotentny: Nie

Parametry

tenantSlug(path, string, wymagane)— Identyfikator (slug) konta, dla którego skonfigurowano SSO
SAMLResponse(body, string, wymagane)— Odpowiedź SAML podpisana przez dostawcę identyfikacji (XML, zakodowana w base64) jako pole formularza

Przykładowa odpowiedź

Przekierowanie 302 do https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (przykład bez prawidłowej odpowiedzi SAML)

Kody błędów

302 SSO_STATE_MISSING — Przekierowanie do strony logowania z `sso_error`, jeśli odpowiedź SAML jest nieprawidłowa lub brakuje procesu logowania.

Zweryfikowane zachowanie

Nieprawidłowa `SAMLResponse` prowadzi do przekierowania (302) do strony logowania z `sso_error`.

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