Configurer des connecteurs externes pour les tâches d'enrichissement

Aperçu

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Les fournisseurs d'authentification tiers vous permettent de connecter de manière sécurisée les tâches d'enrichissement Knowledge Studio à des plates-formes externes telles que GitHub, Microsoft SharePoint et Atlassian Confluence. Suivez les étapes de génération d'identifiants et de configuration du fournisseur d'authentification décrites dans ce document dans le cadre de votre configuration préalable.

Avant de commencer

Avant de configurer des connecteurs externes, assurez-vous d'avoir rempli les conditions préalables suivantes :

• Consultez le workflow de configuration d'enrichissement global dans Configurer les conditions préalables pour les tâches d'enrichissement.
• Assurez-vous de disposer des autorisations d'administrateur ou de développeur nécessaires sur vos plates-formes tierces cibles (GitHub, Microsoft SharePoint ou Atlassian Confluence) pour générer des jetons d'accès ou enregistrer des applications.
• Pour stocker des identifiants de manière sécurisée et les associer à des tâches, assurez-vous d'avoir correctement configuré le service d'identité de l'agent. Pour en savoir plus, consultez Configurer des autorisations IAM pour les fournisseurs d'authentification.

Lorsque vous connectez l'agent d'enrichissement à des sources de connaissances tierces, vous devez utiliser le service d'identité de l'agent Google Cloud . Agent Identity agit comme un gestionnaire d'authentification qui stocke de manière sécurisée vos identifiants tiers et fournit des jetons d'accès de courte durée à l'agent d'enrichissement. Ainsi, les opérateurs humains n'ont jamais à gérer directement les codes secrets bruts du client lors de l'exécution des tâches.

Configurer GitHub

Pour connecter Knowledge Studio à des dépôts GitHub, vous devez créer un jeton d'accès personnel (PAT) précis dans GitHub et le stocker dans un fournisseur d'authentification par clé API.

1. Connectez-vous à GitHub, cliquez sur votre photo de profil, puis sur Settings (Paramètres).
2. Accédez à Developer settings > Personal access tokens > Fine-grained tokens (Paramètres du développeur > Jetons d'accès personnels > Jetons précis).
3. Cliquez sur Générer un nouveau jeton.
4. Configurez les propriétés du jeton :
   • Nom du jeton : saisissez un nom descriptif (par exemple, enrichment-agent).
   • Expiration : définissez une date d'expiration appropriée.
   • Propriétaire de la ressource : sélectionnez l'organisation ou le compte utilisateur propriétaire des dépôts cibles.
   • Accès au dépôt : sélectionnez Sélectionner uniquement les dépôts, puis choisissez les dépôts que vous souhaitez enrichir.
   • Autorisations : accordez un accès spécifique en lecture ou en lecture et écriture pour les champs d'application requis (tels que Problèmes, Demandes d'extraction et Contenus).
5. Cliquez sur Générer un jeton et copiez-le de manière sécurisée.
6. Enregistrez un fournisseur d'authentification par clé API dans Google Cloud et fournissez le jeton d'accès personnel en tant que clé API. Consultez S'authentifier à l'aide d'une clé API avec le gestionnaire d'authentification.

Pour en savoir plus sur la création d'un PAT, consultez Gérer vos jetons d'accès personnels dans la documentation GitHub.

Configurer Microsoft SharePoint

Si vous vous connectez à Microsoft SharePoint, obtenez des identifiants OAuth auprès de Microsoft Entra ID (anciennement Azure Active Directory) à l'aide d'un flux OAuth à deux étapes.

1. Enregistrez une nouvelle application dans le Centre d'administration Microsoft Entra.
2. Accordez les autorisations de l'API Microsoft Graph :
   1. Accédez à API permissions (Autorisations d'API) > Add a permission (Ajouter une autorisation) > Microsoft Graph > Application permissions (Autorisations d'application) (ne sélectionnez pas "Delegated permissions" (Autorisations déléguées)).
   2. Ajoutez les champs d'application Sites.Read.All et Files.Read.All.
   3. Cliquez sur Accorder le consentement administrateur pour votre locataire afin que les deux autorisations d'application s'affichent comme "Accordées".

3. Créez un code secret du client. Notez immédiatement sa valeur, car elle ne s'affiche qu'une seule fois. Pour en savoir plus, consultez Créer un code secret du client.

4. Copiez les valeurs de configuration de votre application. Après l'enregistrement, collectez les valeurs suivantes pour la configuration de votre fournisseur d'authentification :

   • ID client : ID (client) de l'application figurant dans la vue d'ensemble de votre application.
   • URL du jeton : sur la page Overview (Présentation), cliquez sur l'onglet Endpoints (Points de terminaison). Copiez l'URL intitulée Point de terminaison du jeton OAuth 2.0 (v2).

5. Enregistrez un fournisseur d'authentification OAuth en deux étapes dans Google Cloud à l'aide de ces secrets. Lors de la création du fournisseur, indiquez le champ d'application par défaut pour le paramètre --allowed-scopes :

   --allowed-scopes="https://graph.microsoft.com/.default"
   

   Pour en savoir plus, consultez Inscrire une application sur la Plateforme d'identités Microsoft dans la documentation Microsoft Entra.

Configurer Atlassian Confluence

Comme Confluence n'est pas compatible avec le protocole OAuth en deux étapes pour les agents de serveur à serveur, vous devez créer un compte de service dédié (ou un compte utilisateur fictif) dans Atlassian, lui accorder les autorisations requises et générer un jeton d'accès personnel.

1. Connectez-vous au compte de service spécifique dans Confluence.
2. Cliquez sur votre photo de profil en haut à droite de l'écran.
3. Sélectionnez Paramètres (ou Paramètres du compte) dans le menu.
4. Dans l'onglet "Security" (Sécurité), accédez à la section "API tokens" (Jetons d'API).
5. Cliquez sur le bouton Create API token with scopes (Créer un jeton d'API avec des champs d'application). N'utilisez pas de jeton sans champ d'application, car il ne récupérera pas tous les outils requis.
6. Indiquez un nom descriptif (par exemple, enrichment-agent), configurez la date d'expiration, puis cliquez sur Suivant.
7. Dans la liste Sélectionner l'application, sélectionnez l'option Atlassian MCP, puis cliquez sur Suivant.
8. Sélectionnez tous les champs d'application de lecture et de recherche Confluence suivants :
   • read:page:confluence
   • read:space:confluence
   • search:confluence
   • read:confluence-content.all
   • read:confluence-content.summary
   • read:confluence-space.summary
   • search:rovo:mcp
   • read:jira-work
9. Cliquez sur Suivant, puis sur Créer.
10. Copiez le jeton généré.
11. Mettez en forme la chaîne d'identifiants pour le fournisseur d'authentification Google Cloud comme<ATLASSIAN_EMAIL>:<API_TOKEN>. Atlassian nécessite l'encodage de l'authentification HTTP de base (email:api_token) pour utiliser les jetons d'API personnels de manière programmatique.
12. Enregistrez un fournisseur d'authentification par clé API dans Google Cloud et fournissez la chaîne <ATLASSIAN_EMAIL>:<API_TOKEN> comme clé API. Consultez S'authentifier à l'aide d'une clé API avec le gestionnaire d'authentification.

Pour en savoir plus sur la création d'un jeton d'accès personnel, consultez Gérer les jetons d'API pour votre compte Atlassian dans la documentation Atlassian.

Étapes suivantes

• Découvrez comment créer des tâches d'enrichissement.