GET/api/sso/:tenantSlug/oidc/callback
Reçoit la redirection du fournisseur d'identité après la connexion OIDC et redirige le navigateur vers Zentor App.
Ce point de terminaison n'est appelé que par le fournisseur d'identité via redirection du navigateur ; il doit être saisi comme URI de redirection dans ses paramètres. 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`. En cas d'erreur – par exemple si le paramètre de sécurité `state` est manquant ou invalide – le serveur redirige vers la page de connexion avec le paramètre de requête `sso_error`, par exemple `sso_error=SSO_STATE_MISSING`. Relancez alors la connexion.
Vue d'ensemble
Appel : GET /api/sso/:tenantSlug/oidc/callback. 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). 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éExemple de réponse
Redirection 302 vers https://zentor-app.de/login?sso_error=SSO_STATE_MISSING (exemple sans `state` valide)
Codes d'erreur
302 SSO_STATE_MISSING — Redirection vers la page de connexion avec `sso_error` si `state` est manquant ou invalide.Comportement vérifié
Sans `state` valide, le serveur redirige vers la page de connexion avec 302 et `sso_error=SSO_STATE_MISSING`.
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/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é.