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

Assertion Consumer Service (ACS): sprejme podpisan odgovor SAML ponudnika identitete prek obrazca POST.

To končno točko kliče izključno ponudnik identitete; vnesti jo je treba v njegove nastavitve kot ACS-URL (glejte `saml/metadata`). Ponudnik identitete pošlje base64 kodiran, podpisan odgovor v polju obrazca `SAMLResponse`. 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`. Če je odgovor neveljaven ali manjka povezani postopek prijave, strežnik preusmeri na stran za prijavo s poizvedbenim parametrom `sso_error`, na primer `sso_error=SSO_STATE_MISSING`.

Pregled

Klic: POST /api/sso/:tenantSlug/saml/acs. 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), SAMLResponse (body). 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 SSO
SAMLResponse(body, string, obvezno)— Podpisan odgovor SAML ponudnika identitete (XML, kodiran base64) kot polje obrazca

Primer odgovora

Preusmeritev 302 na https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (primer brez veljavnega odgovora SAML)

Kode napak

302 SSO_STATE_MISSING — Preusmeritev na stran za prijavo z `sso_error`, če je odgovor SAML neveljaven ali manjka postopek prijave.

Preverjeno vedenje

Neveljaven `SAMLResponse` povzroči preusmeritev (302) z `sso_error` 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/oidc/callbackSprejme preusmeritev ponudnika identitete po prijavi OIDC in preusmeri brskalnik nazaj na Zentor App.GET /api/sso/:tenantSlug/saml/startSproži prijavo prek SAML in preusmeri brskalnik na nastavljenega ponudnika identitete.GET /api/sso/:tenantSlug/saml/metadataVrne SAML metapodatke Zentor App (XML) za uvoz v vašega ponudnika identitete.

Sorodni članki

← Demo klepetalni robot in SSO