GET/api/sso/:tenantSlug/saml/metadata
Renvoie les métadonnées SAML de Zentor App (XML) pour l'importation dans votre fournisseur d'identité.
Les métadonnées contiennent notamment l'ID d'entité et l'URL ACS dont votre fournisseur d'identité a besoin pour la configuration. La réponse est un document XML, pas du JSON. Si SAML n'est pas configuré pour le compte, le serveur répond par 404 `SSO_NOT_CONFIGURED`.
Vue d'ensemble
Appel : GET /api/sso/:tenantSlug/saml/metadata. 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 est idempotent : des appels répétés avec les mêmes données renvoient le même résultat. Paramètres obligatoires : tenantSlug (chemin). Cas d'erreur documentés : 404 -.
Authentification et sécurité
Aucune authentification requise
Idempotent: Oui
Paramètres
tenantSlug(path, string, requis)— Identifiant (slug) du compte pour lequel SSO est configuréExemple de réponse
(métadonnées SAML sous forme de document XML si SAML est configuré pour le compte – pas de JSON)
Codes d'erreur
404 - — SAML n'est pas configuré pour ce compte.Comportement vérifié
Pour un compte sans SAML, la requête renvoie 404.
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é.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS) : reçoit la réponse SAML signée du fournisseur d'identité via un POST de formulaire.