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

Assertion Consumer Service (ACS): prijíma podpísanú odpoveď SAML od poskytovateľa identity formulárovým POST.

Tento endpoint volá výhradne poskytovateľ identity; musí byť zadaný v jeho nastaveniach ako ACS URL (pozri `saml/metadata`). Poskytovateľ identity zasiela podpísanú, base64 kódovanú odpoveď vo formulárovom poli `SAMLResponse`. 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. Ak je odpoveď neplatná alebo chýba súvisiaci prihlasovací proces, server presmeruje na prihlasovaciu stránku s parametrom dotazu `sso_error`, napríklad `sso_error=SSO_STATE_MISSING`.

Prehľad

Volanie: POST /api/sso/:tenantSlug/saml/acs. 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), SAMLResponse (body). 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
SAMLResponse(body, string, povinné)— SAML odpoveď podpísaná poskytovateľom identity (XML, base64 kódovaná) ako formulárové pole

Príklad odpovede

Presmerovanie 302 na https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (príklad bez platnej SAML odpovede)

Chybové kódy

302 SSO_STATE_MISSING — Presmerovanie na prihlasovaciu stránku s `sso_error`, ak je SAML odpoveď neplatná alebo chýba prihlasovací proces.

Overené správanie

Neplatná `SAMLResponse` vedie k presmerovaniu (302) na prihlasovaciu stránku s `sso_error`.

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/oidc/callbackPrijíma presmerovanie poskytovateľa identity po prihlásení OIDC a presmeruje prehliadač späť na Zentor App.GET /api/sso/:tenantSlug/saml/startSpustí prihlásenie cez SAML a presmeruje prehliadač na nastaveného poskytovateľa identity.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