POST/api/sso/:tenantSlug/saml/acs
Assertion Consumer Service (ACS): receives the identity provider's signed SAML response via form POST.
This endpoint is called exclusively by the identity provider; it must be entered as the ACS URL in the provider's settings (see `saml/metadata`). The identity provider sends the base64-encoded, signed response in the form field `SAMLResponse`. On success, Zentor App redirects the browser back with the one-time code in the query parameter `sso_code`; this code is exchanged for an access token via `POST /api/auth/sso/exchange`. If the response is invalid or the associated sign-in process is missing, the server redirects to the sign-in page with the query parameter `sso_error`, for example `sso_error=SSO_STATE_MISSING`.
Overview
Call: POST /api/sso/:tenantSlug/saml/acs. This endpoint belongs to the “Demo Chatbot and SSO” group of the Zentor App API. It is publicly accessible and requires no authentication. The call is not idempotent: every successful call triggers the action again. Required parameters: tenantSlug (path), SAMLResponse (body). Documented error cases: 302 SSO_STATE_MISSING.
Auth & Security
No authentication required
Idempotent: No
Parameters
tenantSlug(path, string, required)— Identifier (slug) of the account for which SSO is set upSAMLResponse(body, string, required)— SAML response signed by the identity provider (XML, base64-encoded) as a form fieldExample Response
302 redirect to https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (example without a valid SAML response)
Error Codes
302 SSO_STATE_MISSING — Redirect to the sign-in page with `sso_error` if the SAML response is invalid or the sign-in process is missing.Verified behaviour
An invalid `SAMLResponse` leads to a redirect (302) to the sign-in page with `sso_error`.
Demo Chatbot and SSO
POST /api/global-chatbot/demoSends a message to the public demo chatbot at zentor-app.de/demo and returns its reply. The demo can be tried out in the browser without registering.GET /api/global-chatbot/demo/historyLoads the message history of a demo conversation so that it is preserved when the demo is reopened.POST /api/global-chatbot/demo/pollFetches new messages of a demo conversation, for example when a Zentor team member has taken over the conversation. The demo page calls the endpoint at intervals.POST /api/global-chatbot/demo/ratingStores the rating of a demo conversation (helpful or not helpful) with an optional comment.POST /api/global-chatbot/demo/trackRecords anonymous usage events on the demo page for Zentor's visitor statistics.POST /api/global-chatbot/demo/voice-transcribeConverts a voice recording on the demo page into text (voice input), if the demo's voice feature is enabled.POST /api/global-chatbot/demo/voice-speakConverts text into speech (voice output on the demo page), if the demo's voice feature is enabled.GET /api/sso/:tenantSlug/statusChecks whether single sign-on (SAML or OIDC) is set up for an account. The sign-in page uses the result to offer SSO sign-in.GET /api/sso/:tenantSlug/oidc/startStarts sign-in via OpenID Connect and redirects the browser to the configured identity provider.GET /api/sso/:tenantSlug/oidc/callbackReceives the identity provider's redirect after OIDC sign-in and redirects the browser back to Zentor App.GET /api/sso/:tenantSlug/saml/startStarts sign-in via SAML and redirects the browser to the configured identity provider.GET /api/sso/:tenantSlug/saml/metadataReturns the Zentor App SAML metadata (XML) for import into your identity provider.