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

Prijíma presmerovanie poskytovateľa identity po prihlásení OIDC a presmeruje prehliadač späť na Zentor App.

Tento endpoint volá výhradne poskytovateľ identity presmerovaním prehliadača; musí byť zadaný v jeho nastaveniach ako redirect URI. Pri úspechu presmeruje Zentor App prehliadač späť s jednorazovým kódom v parametri dotazu `sso_code`; tento kód sa cez `POST /api/auth/sso/exchange` vymení za prístupový token. Pri chybe – napríklad ak bezpečnostný parameter `state` chýba alebo je neplatný – server presmeruje na prihlasovaciu stránku s parametrom dotazu `sso_error`, napríklad `sso_error=SSO_STATE_MISSING`. V takom prípade začnite prihlásenie znova.

Prehľad

Volanie: GET /api/sso/:tenantSlug/oidc/callback. Tento endpoint patrí do skupiny „Demo chatbot a SSO“ API aplikácie Zentor App. Je verejne dostupný a nevyžaduje žiadnu autentifikáciu. Volanie nie je idempotentné: Každé úspešné volanie akciu spustí znova. Povinné parametre: tenantSlug (cesta). Zdokumentované chybové prípady: 302 SSO_STATE_MISSING.

Autentifikácia a zabezpečenie

Nevyžaduje sa žiadna autentifikácia

Idempotentné: Nie

Parametre

tenantSlug(path, string, povinné)— Identifikátor (slug) účtu, pre ktorý je nastavené SSO

Príklad odpovede

Presmerovanie 302 na https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (príklad bez platného `state`)

Chybové kódy

302 SSO_STATE_MISSING — Presmerovanie na prihlasovaciu stránku s `sso_error`, ak `state` chýba alebo je neplatný.

Overené správanie

Bez platného `state` presmeruje server na prihlasovaciu stránku s 302 a `sso_error=SSO_STATE_MISSING`.

Demo chatbot a SSO

POST /api/global-chatbot/demoOdošle správu verejnému demo chatbotovi na zentor-app.de/demo a vráti jeho odpoveď. Demo je možné vyskúšať v prehliadači bez registrácie.GET /api/global-chatbot/demo/historyNačíta doterajšiu históriu správ demo konverzácie, aby sa zachovala pri opätovnom otvorení dema.POST /api/global-chatbot/demo/pollZískava nové správy demo konverzácie, napríklad ak konverzáciu prevzal pracovník Zentoru. Demo stránka volá endpoint v intervaloch.POST /api/global-chatbot/demo/ratingUloží hodnotenie demo konverzácie (užitočná alebo neužitočná) s nepovinným komentárom.POST /api/global-chatbot/demo/trackZaznamenáva anonymné udalosti využitia demo stránky pre štatistiku návštevníkov Zentoru.POST /api/global-chatbot/demo/voice-transcribePrevádza hlasový záznam na demo stránke na text (hlasový vstup), ak je hlasová funkcia dema aktivovaná.POST /api/global-chatbot/demo/voice-speakPrevádza text na hovorenú reč (hlasový výstup na demo stránke), ak je hlasová funkcia dema aktivovaná.GET /api/sso/:tenantSlug/statusSkontroluje, či je pre účet nastavené jednotné prihlásenie (SAML alebo OIDC). Prihlasovacia stránka použije výsledok na ponúknutie prihlásenia cez SSO.GET /api/sso/:tenantSlug/oidc/startSpustí prihlásenie cez OpenID Connect a presmeruje prehliadač na nastaveného poskytovateľa identity.GET /api/sso/:tenantSlug/saml/startSpustí prihlásenie cez SAML a presmeruje prehliadač na nastaveného poskytovateľa identity.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): prijíma podpísanú odpoveď SAML od poskytovateľa identity formulárovým POST.GET /api/sso/:tenantSlug/saml/metadataVracia metadáta SAML Zentor App (XML) na import do vášho poskytovateľa identity.

Súvisiace články

← Demo chatbot a SSO