POST/api/sso/:tenantSlug/saml/acs
Assertion Consumer Service (ACS): ontvangt het ondertekende SAML-antwoord van de identity provider via een formulier-POST.
Dit endpoint wordt uitsluitend aangeroepen door de identity provider; het moet in diens instellingen als ACS-URL worden ingevoerd (zie `saml/metadata`). De identity provider verzendt het ondertekende, base64-gecodeerde antwoord in het formulierveld `SAMLResponse`. Bij succes leidt Zentor App de browser terug met de eenmalige code in de queryparameter `sso_code`; deze code wordt via `POST /api/auth/sso/exchange` ingewisseld voor een toegangstoken. Is het antwoord ongeldig of ontbreekt het bijbehorende aanmeldproces, dan leidt de server door naar de aanmeldpagina met de queryparameter `sso_error`, bijvoorbeeld `sso_error=SSO_STATE_MISSING`.
Overzicht
Aanroep: POST /api/sso/:tenantSlug/saml/acs. Dit endpoint hoort bij de groep ‘Demo-chatbot en SSO’ van de API van Zentor App. Het is openbaar toegankelijk en vereist geen authenticatie. De aanroep is niet idempotent: elke geslaagde aanroep activeert de actie opnieuw. Verplichte parameters: tenantSlug (pad), SAMLResponse (body). Gedocumenteerde foutgevallen: 302 SSO_STATE_MISSING.
Auth & beveiliging
Geen authenticatie vereist
Idempotent: Nee
Parameters
tenantSlug(path, string, vereist)— Identificatie (slug) van het account waarvoor SSO is ingerichtSAMLResponse(body, string, vereist)— Door de identity provider ondertekend SAML-antwoord (XML, base64-gecodeerd) als formulierveldVoorbeeld-response
302-doorverwijzing naar https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (voorbeeld zonder geldig SAML-antwoord)
Foutcodes
302 SSO_STATE_MISSING — Doorverwijzing naar de aanmeldpagina met `sso_error` als het SAML-antwoord ongeldig is of het aanmeldproces ontbreekt.Geverifieerd gedrag
Een ongeldige `SAMLResponse` leidt tot een doorverwijzing (302) naar de aanmeldpagina met `sso_error`.
Demo-chatbot en SSO
POST /api/global-chatbot/demoVerzendt een bericht naar de openbare demo-chatbot op zentor-app.de/demo en levert het antwoord daarvan. De demo kan zonder registratie in de browser worden uitgeprobeerd.GET /api/global-chatbot/demo/historyLaadt de bestaande berichtgeschiedenis van een demogesprek, zodat deze behouden blijft bij het opnieuw openen van de demo.POST /api/global-chatbot/demo/pollHaalt nieuwe berichten van een demogesprek op, bijvoorbeeld wanneer een medewerker van Zentor het gesprek heeft overgenomen. De demopagina roept het endpoint met tussenpozen aan.POST /api/global-chatbot/demo/ratingSlaat de beoordeling van een demogesprek op (nuttig of niet nuttig) met een optionele opmerking.POST /api/global-chatbot/demo/trackRegistreert anonieme gebruiksgebeurtenissen van de demopagina voor de bezoekersstatistieken van Zentor.POST /api/global-chatbot/demo/voice-transcribeZet een spraakopname op de demopagina om in tekst (spraakinvoer), als de spraakfunctie van de demo is ingeschakeld.POST /api/global-chatbot/demo/voice-speakZet tekst om in gesproken taal (spraakuitvoer op de demopagina), als de spraakfunctie van de demo is ingeschakeld.GET /api/sso/:tenantSlug/statusControleert of single sign-on (SAML of OIDC) is ingericht voor een account. De aanmeldpagina gebruikt het resultaat om de SSO-aanmelding aan te bieden.GET /api/sso/:tenantSlug/oidc/startStart het aanmelden via OpenID Connect en leidt de browser door naar de ingerichte identity provider.GET /api/sso/:tenantSlug/oidc/callbackOntvangt de doorverwijzing van de identity provider na de OIDC-aanmelding en leidt de browser terug naar Zentor App.GET /api/sso/:tenantSlug/saml/startStart het aanmelden via SAML en leidt de browser door naar de ingerichte identity provider.GET /api/sso/:tenantSlug/saml/metadataLevert de SAML-metadata van Zentor App (XML) voor import in uw identity provider.