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é SSOSAMLResponse(body, string, povinné)— SAML odpoveď podpísaná poskytovateľom identity (XML, base64 kódovaná) ako formulárové polePrí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.