Connecteur bitbucket Pull Request Microsoft 365 Copilot (préversion)

Le connecteur Bitbucket Pull Request Microsoft 365 Copilot permet à votre organization d’indexer les demandes de tirage et la documentation (fichiers .txt et .md) stockées dans Bitbucket. Après avoir configuré le connecteur et indexé le contenu Bitbucket, les utilisateurs peuvent rechercher et récupérer des informations via Recherche Microsoft et Microsoft 365 Copilot.

Cet article est destiné aux administrateurs Microsoft 365 ou à toute personne qui configure, exécute ou surveille le connecteur Bitbucket Copilot.

Fonctionnalités

• Indexer les référentiels Bitbucket, les demandes de tirage et la documentation.
• Activez Recherche et Microsoft 365 Copilot Microsoft pour récupérer efficacement les données Bitbucket.
• Conservez les ACL Bitbucket et les autorisations utilisateur.
• Autoriser les administrateurs à personnaliser la fréquence d’analyse et les préférences d’indexation.

Limitations

• Le connecteur ne prend pas en charge l’indexation des pipelines CI/CD Bitbucket au-delà de status indexation.
• Seuls les dépôts, les demandes de tirage, les fichiers .md et .txt sont indexés.
• Les instances Bitbucket locales/auto-hébergées ne sont pas prises en charge actuellement.
• Le connecteur peut laisser le champ LastModifiedBy vide dans les cas où les modifications Git ne sont pas mappées à un compte Bitbucket. Cela se produit lorsqu’une configuration manuelle reliant git à des comptes d’utilisateur Bitbucket n’est pas terminée avant une analyse incrémentielle.

Configuration requise

1. Votre instance Bitbucket est accessible via l’API.
2. Le compte d’utilisateur utilisé pour l’authentification a accès aux dépôts, aux demandes de tirage et aux fichiers de connaissances à indexer.
3. Les utilisateurs qui accèdent aux données Bitbucket indexées ont des identités Microsoft Entra ID correspondantes pour le mappage des autorisations.
4. Configurer un consommateur OAuth sur Bitbucket
   1. Accédez à la page de votre espace de travail sur Bitbucket.
   2. Cliquez sur l’icône d’engrenage en haut à droite, puis sélectionnez Paramètres de l’espace de travail.
   3. Dans le volet de navigation de gauche, sélectionnez Consommateurs OAuth situés sous la section Flux de travail.
   4. Cliquez sur Ajouter un consommateur et renseignez en fonction des URL de redirection suivantes :
   • Pour Microsoft 365 Entreprise, utilisezhttps://gcs.office.com/v1.0/admin/oauth/callback
   • Pour Microsoft 365 Government, utilisez https://gcsgcc.office.com/v1.0/admin/oauth/callback
   5. Activez la clé pour disposer des autorisations suivantes configurées pour lire les problèmes :
   • Compte
   • Dépôts
   • Demandes de tirage
   6. Enregistrer la configuration et copier les valeurs de clé et de secret

Nous vous recommandons d’utiliser des comptes d’utilisateur distincts pour l’authentification OAuth avec chaque connexion, car la limite de débit de Bitbucket est calculée individuellement par utilisateur.

Prise en main

Choisir un nom d’affichage

Choisissez un nom d’affichage qui permet aux utilisateurs de reconnaître les demandes de fusion ou la documentation dans une réponse Copilot.

URL instance Bitbucket

Entrez l’URL de votre instance Bitbucket (par exemple, https://bitbucket.org/testinstance).

Type d’authentification

1. Entrez votre ID client à l’aide de la clé de votre consommateur Bitbucket OAuth et votre clé secrète client à l’aide de la clé secrète de consommateur OAuth correspondante.
2. Choisissez Autoriser pour vous connecter et accorder l’accès.
3. Cliquez sur Autoriser pour vous connecter et accorder les autorisations d’accès requises.

Déployer sur un public limité

Avant de déployer le connecteur, testez la connexion avec une base d’utilisateurs limitée dans Copilot et Microsoft Search.

Configuration personnalisée

Dans l’installation personnalisée, vous pouvez modifier l’une des valeurs par défaut pour les utilisateurs, le contenu et la synchronisation.

Utilisateurs

Mappage d’identité

Par défaut, en raison de la limitation de l’API Bitbucket, le connecteur mappe les e-mails dans Microsoft Entra ID à l’aide de noms publics de Bitbucket. Si ce mappage ne s’aligne pas sur votre configuration, personnalisez le mappage d’identité.

Pour garantir l’application correcte des autorisations, mappez les identités des utilisateurs Bitbucket à Microsoft Entra ID. Les options sont les suivantes :

• Nom complet: Correspond aux noms complets Bitbucket pour Microsoft Entra ID propriétés de l’utilisateur.
• Nom public : Mappe les noms publics Bitbucket avec Microsoft Entra ID propriétés utilisateur.

Si le mappage direct échoue, utilisez des expressions régulières (expression régulière) pour la transformation. Par exemple :

1. Sélectionnez Courrier comme propriété utilisateur Microsoft Entra.
2. Sélectionnez Nom complet comme propriété utilisateur non Microsoft Entra.
3. Utilisez une expression régulière telle que ([^@]+) pour capturer une séquence d’un ou plusieurs caractères qui se trouvent avant le @ symbole.
4. Créez une formule pour terminer le mappage, par exemple {0}@<your-domain>.

Contenu

Sous l’onglet Contenu , vous pouvez vérifier les mappages de propriétés dans les exemples de données pour les métadonnées telles que le contenu, les étiquettes, la description et les horodatages.

Synchronisation

Vous pouvez configurer des analyses incrémentielles et complètes . Voici les valeurs par défaut :

• L’analyse incrémentielle s’exécute toutes les 15 minutes par défaut.
• L’analyse complète s’exécute quotidiennement pour garantir une indexation à jour.

Étapes suivantes

• Passez en revue la status de connexion dans le Centre Administration Microsoft 365.

Si vous rencontrez des problèmes ou si vous souhaitez fournir des commentaires, contactez le support Microsoft Graph.