Le créateur d’intégration prend en charge les types d’autorisation standards, dont les clés API, les jetons du porteur, les noms d’utilisateur et les mots de passe, ainsi qu’OAuth 2.0. Cependant, en fonction des besoins et des workflows de votre entreprise, une autorisation standard risque de ne pas suffire. C’est pourquoi le créateur d’intégration prend également en charge un type d’intégration Authentification uniquement, qui fonctionnera avec les solutions d’authentification et d’autorisation de votre entreprise.
Cet article aborde les sujets suivants :
- À propos de l’autorisation personnalisée
- Configuration de l’autorisation personnalisée
- Création de l’intégration de données
- Test de l’autorisation personnalisée
À propos de l’autorisation personnalisée
L’intégration Authentification uniquement émet une demande pour un jeton et sa date d’expiration, qu’elle transmet ensuite aux données ou à l’intégration principale pour autorisation, puis envoie une demande de données.
Globalement, le workflow d’autorisation personnalisé est le suivant :
- Demande d’autorisation - L’intégration Authentification uniquement envoie une demande au serveur, en demandant la permission de récupérer un jeton d’accès. Si le serveur authentifie la demande (provenant d’agents IA), il autorise la récupération du jeton d’accès et, si disponible, la date/heure d’expiration.
- Traitement du jeton - Une fois que le serveur a répondu avec le jeton d’accès, l’intégration stocke deux éléments d’information importants : le paramètre « token » lui-même et son paramètre « expiresIn », qui détermine la durée de validité du jeton.
- Transmission du jeton aux données d’intégration - Ces deux paramètres (token et expiresIn) sont transmis à l’étape suivante, qui est l’intégration des données. Le jeton est utilisé pour authentifier les demandes suivantes émises par l’intégration des données. Le jeton est défini et traité de façon interne, et jamais exposé aux données de session ou de conversation.
- Demande d’autorisation personnalisée pour les données - Avec le jeton d’accès en place, l’intégration de données est maintenant autorisée à récupérer les données nécessaires, utilisées pour enrichir la conversation.
Le diagramme ci-dessous illustre le workflow d’autorisation personnalisé.
Configuration de l’autorisation personnalisée
Vous allez configurer l’autorisation personnalisée dans le cadre du processus normal de création d’une intégration dans le créateur d’intégration.
Configuration de l’autorisation personnalisée dans le créateur d’intégration
- Dans le menu principal, cliquez sur Intégrations API.
- En haut à droite, cliquez sur Ajouter une intégration.
- Dans la fenêtre Ajouter une intégration :
- Dans le champ Nom de l’intégration, donnez un nom parlant à votre intégration.
- (Facultatif) Dans le champ Description, saisissez une description pour l’intégration, qui vous rappellera à quoi elle sert.
- Sélectionner Configuration en tant qu’intégration « authentification uniquement ».
- Cliquez sur Enregistrer.
- Dans la barre latérale de gauche, sous Scénarios, passez la souris sur Échec, sélectionnez le menu d’options (
) et sélectionnez Supprimer. Pour une autorisation personnalisée, vous n’avez besoin que des scénarios Réussite. Vous ne pouvez pas supprimer les scénarios Repli.
- Dans la page des scénarios Réussite, créez deux paramètres de session (en cliquant sur le bouton +) avec les détails suivants :
- token
- Clé : token (ce mot exact)
- Requête : saisissez une valeur qui définit le jeton. Par exemple : data.access_token
- expiresIn
- Clé : token (ce mot exact)
-
Requête : saisissez une valeur qui définit l’expiration du jeton. Par exemple, data.expires_in
L’expiration du jeton peut ne pas faire partie de votre réponse de données. Dans ce cas, vous pouvez coder la valeur de votre choix en dur (en secondes). Par exemple : 3600
Nous recommandons fortement de définir l’expiration du jeton. Si vous rencontrez une erreur pendant le test, il s’agira du temps que vous aurez à attendre jusqu’à l’émission d’un autre jeton. Sans date/heure d’expiration, le jeton est indéfini, ce qui signifie que vous ne pourrez pas en émettre d’autre, tant que le problème est en cours de résolution.
- token
- Cliquez sur Enregistrer.
Création de l’intégration de données
Créez ensuite l’intégration de données qui utilisera l’intégration Authentification uniquement que vous avez créée lors des étapes précédentes. Procédez comme vous le faites d’habitude pour une nouvelle intégration. Pour obtenir de l’aide, consultez Créateur d’intégration.
Pour créer l’intégration de données
- Dans la barre latérale de gauche, sous Environnements, sélectionnez un environnement (Production, par exemple).
- Dans l’onglet Autorisation, dans le champ déroulant Type d’autorisation, sélectionnez Personnalisé.
- Dans le champ déroulant Intégration de l’autorisation API, sélectionnez l’intégration Authentification uniquement personnalisée que vous avez créée précédemment.
- Sélectionnez l’onglet En-têtes, puis cliquez sur Ajouter un en-tête.
- Remplissez les champs suivants :
- Clé : Authorization
-
Valeur : Bearer {{apiToken}} (orthographe exacte)
- Cliquez sur Enregistrer.
Test de l’autorisation personnalisée
Après avoir configuré votre intégration Authentification uniquement, nous vous recommandons de la tester. Pour obtenir de l’aide, consultez Fonctionnalité de test.
Résolution du problème statusCode: null
Il se peut que, lors du test de votre intégration, vous rencontriez le message « statusCode: null », comme illustré ci-après :
Commencez par vérifier que votre intégration Authentification uniquement a été correctement configurée en suivant les étapes ci-dessus.
Ensuite, notez où se produit l’erreur. Si elle se trouve dans l’intégration d’authentification, vous avez probablement un problème de configuration, ou l’URL à laquelle vous dirigez la demande peut être erronée. Dans ce cas, demandez à vos ingénieurs de vérifier de votre côté ; ils pourront probablement vous expliquer quel est le problème.
Si vous avez suivi la procédure ci-dessus et que vous rencontrez toujours l’erreur, attendez que le jeton expire et recommencez.
Si vous avez tout essayé et que l’intégration ne fonctionne toujours pas, contactez votre Responsable de la réussite client pour vous faire aider.