GET/api/sso/:tenantSlug/saml/start

Démarre la connexion via SAML et redirige le navigateur vers le fournisseur d'identité configuré.

Appelez le point de terminaison par navigation dans le navigateur. Si SAML est configuré, le serveur répond par une redirection (302) vers le fournisseur d'identité ; sa réponse est ensuite envoyée à `saml/acs`. Si SAML n'est pas configuré pour le compte, le serveur répond par 404 `SSO_NOT_CONFIGURED` et un message d'erreur JSON.

Vue d'ensemble

Appel : GET /api/sso/:tenantSlug/saml/start. 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

(redirection 302 vers le fournisseur d'identité si SAML est configuré pour le compte)

Codes d'erreur

404 - — SAML n'est pas configuré pour ce compte.

Comportement vérifié

Pour un compte sans SAML, l'appel 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.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.GET /api/sso/:tenantSlug/saml/metadataRenvoie les métadonnées SAML de Zentor App (XML) pour l'importation dans votre fournisseur d'identité.

Articles associés

← Chatbot de démonstration et SSO