GET/api/sso/:tenantSlug/oidc/callback

Odbiera przekierowanie dostawcy identyfikacji po zalogowaniu OIDC i przekierowuje przeglądarkę z powrotem do Zentor App.

Ten endpoint jest wywoływany wyłącznie przez dostawcę identyfikacji za pomocą przekierowania przeglądarki; musi zostać wprowadzony w jego ustawieniach jako redirect URI. 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`. W przypadku błędu – np. gdy parametr bezpieczeństwa `state` jest nieobecny lub nieprawidłowy – serwer przekierowuje do strony logowania z parametrem zapytania `sso_error`, np. `sso_error=SSO_STATE_MISSING`. W takim przypadku rozpocznij logowanie ponownie.

Przegląd

Wywołanie: GET /api/sso/:tenantSlug/oidc/callback. 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). 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

Przykładowa odpowiedź

Przekierowanie 302 do https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (przykład bez prawidłowego `state`)

Kody błędów

302 SSO_STATE_MISSING — Przekierowanie do strony logowania z `sso_error`, jeśli `state` jest nieobecny lub nieprawidłowy.

Zweryfikowane zachowanie

Bez prawidłowego `state` serwer przekierowuje do strony logowania z kodem 302 i `sso_error=SSO_STATE_MISSING`.

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