POST/api/sso/:tenantSlug/saml/acs
Assertion Consumer Service (ACS) : reçoit la réponse SAML signée du fournisseur d'identité via un POST de formulaire.
Ce point de terminaison n'est appelé que par le fournisseur d'identité ; il doit être saisi comme URL ACS dans ses paramètres (voir `saml/metadata`). Le fournisseur d'identité envoie la réponse signée, encodée en base64, dans le champ de formulaire `SAMLResponse`. En cas de succès, Zentor App redirige le navigateur avec le code à usage unique dans le paramètre de requête `sso_code` ; ce code est échangé contre un jeton d'accès via `POST /api/auth/sso/exchange`. Si la réponse est invalide ou si le processus de connexion associé est manquant, le serveur redirige vers la page de connexion avec le paramètre de requête `sso_error`, par exemple `sso_error=SSO_STATE_MISSING`.
Vue d'ensemble
Appel : POST /api/sso/:tenantSlug/saml/acs. Ce point de terminaison appartient au groupe « Chatbot de démonstration et SSO » de l'API de Zentor App. Il est accessible publiquement et ne nécessite aucune authentification. L'appel n'est pas idempotent : chaque appel réussi déclenche à nouveau l'action. Paramètres obligatoires : tenantSlug (chemin), SAMLResponse (body). Cas d'erreur documentés : 302 SSO_STATE_MISSING.
Authentification et sécurité
Aucune authentification requise
Idempotent: Non
Paramètres
tenantSlug(path, string, requis)— Identifiant (slug) du compte pour lequel SSO est configuréSAMLResponse(body, string, requis)— Réponse SAML signée par le fournisseur d'identité (XML, encodée en base64) en tant que champ de formulaireExemple de réponse
Redirection 302 vers https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (exemple sans réponse SAML valide)
Codes d'erreur
302 SSO_STATE_MISSING — Redirection vers la page de connexion avec `sso_error` si la réponse SAML est invalide ou si le processus de connexion est manquant.Comportement vérifié
Une `SAMLResponse` invalide conduit à une redirection (302) vers la page de connexion avec `sso_error`.
Chatbot de démonstration et SSO
POST /api/global-chatbot/demoEnvoie un message au chatbot de démonstration public sur zentor-app.de/demo et renvoie sa réponse. La démo peut être testée dans le navigateur sans inscription.GET /api/global-chatbot/demo/historyCharge l'historique des messages d'une conversation de démonstration afin qu'il soit conservé lors de la réouverture de la démo.POST /api/global-chatbot/demo/pollRécupère les nouveaux messages d'une conversation de démonstration, par exemple lorsqu'un collaborateur de Zentor a pris en charge la conversation. La page de démonstration appelle le point de terminaison à intervalles réguliers.POST /api/global-chatbot/demo/ratingEnregistre l'évaluation d'une conversation de démonstration (utile ou non utile) avec un commentaire facultatif.POST /api/global-chatbot/demo/trackEnregistre les événements d'utilisation anonymes de la page de démonstration pour les statistiques de visiteurs de Zentor.POST /api/global-chatbot/demo/voice-transcribeConvertit un enregistrement vocal sur la page de démonstration en texte (saisie vocale), si la fonction vocale de la démo est activée.POST /api/global-chatbot/demo/voice-speakConvertit du texte en parole (sortie vocale sur la page de démonstration), si la fonction vocale de la démo est activée.GET /api/sso/:tenantSlug/statusVérifie si l'authentification unique (SAML ou OIDC) est configurée pour un compte. La page de connexion utilise le résultat pour proposer la connexion SSO.GET /api/sso/:tenantSlug/oidc/startDémarre la connexion via OpenID Connect et redirige le navigateur vers le fournisseur d'identité configuré.GET /api/sso/:tenantSlug/oidc/callbackReçoit la redirection du fournisseur d'identité après la connexion OIDC et redirige le navigateur vers Zentor App.GET /api/sso/:tenantSlug/saml/startDémarre la connexion via SAML et redirige le navigateur vers le fournisseur d'identité configuré.GET /api/sso/:tenantSlug/saml/metadataRenvoie les métadonnées SAML de Zentor App (XML) pour l'importation dans votre fournisseur d'identité.