GET/api/sso/:tenantSlug/oidc/start
Démarre la connexion via OpenID Connect et redirige le navigateur vers le fournisseur d'identité configuré.
Appelez le point de terminaison par navigation dans le navigateur, et non par une requête JavaScript. Si OIDC est configuré, le serveur répond par une redirection (302) vers le fournisseur d'identité ; après la connexion là-bas, le navigateur revient via `oidc/callback`. Si OIDC 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/oidc/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 OIDC est configuré pour le compte)
Codes d'erreur
404 - — OIDC n'est pas configuré pour ce compte.Comportement vérifié
Pour un compte sans OIDC, 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/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.GET /api/sso/:tenantSlug/saml/metadataRenvoie les métadonnées SAML de Zentor App (XML) pour l'importation dans votre fournisseur d'identité.