GET/api/sso/:tenantSlug/oidc/callback
Sprejme preusmeritev ponudnika identitete po prijavi OIDC in preusmeri brskalnik nazaj na Zentor App.
To končno točko kliče izključno ponudnik identitete prek preusmeritve brskalnika; vnesti jo je treba v njegove nastavitve kot Redirect-URI. Ob uspehu Zentor App preusmeri brskalnik nazaj z enkratno kodo v poizvedbenem parametru `sso_code`; ta koda se zamenja za dostopni žeton prek `POST /api/auth/sso/exchange`. Ob napaki – na primer, če varnostni parameter `state` manjka ali je neveljaven – strežnik preusmeri na stran za prijavo s poizvedbenim parametrom `sso_error`, na primer `sso_error=SSO_STATE_MISSING`. Nato ponovno zaženite prijavo.
Pregled
Klic: GET /api/sso/:tenantSlug/oidc/callback. Ta endpoint spada v skupino »Demo klepetalni robot in SSO« API-ja Zentor App. Je javno dostopen in ne zahteva overjanja. Klic ni idempotenten: vsak uspešen klic znova sproži dejanje. Obvezni parametri: tenantSlug (pot). Dokumentirani primeri napak: 302 SSO_STATE_MISSING.
Avtentikacija in zaščita
Avtentikacija ni potrebna
Idempotentno: Ne
Parametri
tenantSlug(path, string, obvezno)— Identifikator (slug) računa, za katerega je nastavljen SSOPrimer odgovora
Preusmeritev 302 na https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (primer brez veljavnega `state`)
Kode napak
302 SSO_STATE_MISSING — Preusmeritev na stran za prijavo z `sso_error`, če `state` manjka ali je neveljaven.Preverjeno vedenje
Brez veljavnega `state` strežnik preusmeri s 302 in `sso_error=SSO_STATE_MISSING` na stran za prijavo.
Demo klepetalni robot in SSO
POST /api/global-chatbot/demoPošlje sporočilo javnemu demo klepetalnemu robotu na zentor-app.de/demo in vrne njegov odgovor. Demo lahko preizkusite v brskalniku brez registracije.GET /api/global-chatbot/demo/historyNaloži dotedanji potek sporočil demo pogovora, da se ohrani ob ponovnem odprtju demo verzije.POST /api/global-chatbot/demo/pollPridobi nova sporočila demo pogovora, na primer ko je sodelavec Zentor prevzel pogovor. Demo stran kliče končno točko v presledkih.POST /api/global-chatbot/demo/ratingShrani oceno demo pogovora (koristno ali nekoristno) z neobveznim komentarjem.POST /api/global-chatbot/demo/trackZajema anonimne dogodke uporabe demo strani za statistiko obiskovalcev Zentor.POST /api/global-chatbot/demo/voice-transcribePretvori glasovni posnetek na demo strani v besedilo (govorni vnos), če je glasovna funkcija demo verzije aktivirana.POST /api/global-chatbot/demo/voice-speakPretvori besedilo v govor (glasovni izhod na demo strani), če je glasovna funkcija demo verzije aktivirana.GET /api/sso/:tenantSlug/statusPreveri, ali je za račun nastavljena enotna prijava (SAML ali OIDC). Stran za prijavo uporabi rezultat za ponudbo prijave SSO.GET /api/sso/:tenantSlug/oidc/startSproži prijavo prek OpenID Connect in preusmeri brskalnik na nastavljenega ponudnika identitete.GET /api/sso/:tenantSlug/saml/startSproži prijavo prek SAML in preusmeri brskalnik na nastavljenega ponudnika identitete.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): sprejme podpisan odgovor SAML ponudnika identitete prek obrazca POST.GET /api/sso/:tenantSlug/saml/metadataVrne SAML metapodatke Zentor App (XML) za uvoz v vašega ponudnika identitete.