Connecteur Microsoft Graph Azure DevOps Work Items

Le connecteur Microsoft Graph Azure DevOps permet à votre organization d’indexer des éléments de travail dans son instance du service Azure DevOps. Après avoir configuré le connecteur et le contenu d’index à partir d’Azure DevOps, les utilisateurs finaux peuvent rechercher ces éléments dans Recherche Microsoft et Microsoft 365 Copilot.

Cet article s’adresse à toute personne qui configure, exécute et surveille un connecteur Microsoft Graph Azure DevOps Work Items. Il complète le processus de configuration générale et affiche des instructions qui s’appliquent uniquement à ce connecteur.

Avant de commencer

Vous devez être l’administrateur du locataire Microsoft 365 de votre organization, ainsi que l’administrateur de la instance Azure DevOps de votre organization.

Pour permettre au connecteur de se connecter à votre organisation Azure DevOps, vous devez activer l’accès aux applications tierces via OAuth. Pour en savoir plus, consultez la documentation Azure DevOps pour gérer les stratégies de sécurité .

Vous devez accorder les autorisations suivantes au compte d’utilisateur dont les informations d’identification sont utilisées pendant la configuration du connecteur :

Étape 1 : Ajouter un connecteur dans le Centre d’administration Microsoft 365

Ajouter des éléments de travail Azure DevOps Connecteur Microsoft Graph

Pour plus d’informations, consultez les instructions d’installation générales.

Étape 2 : Nommer la connexion

Suivez les instructions d’installation générales.

Étape 3 : Configurer les paramètres de connexion

Pour authentifier et synchroniser le contenu à partir d’Azure DevOps, choisissez l’une des deux méthodes prises en charge :

Microsoft Entra ID OAuth (préversion)

Vérifiez que votre organisation ADO est connectée à Microsoft Entra

Le connecteur Azure DevOps Graph indexe uniquement le contenu d’un organization ADO connecté à Microsoft Entra de votre locataire. Pour vous assurer que votre organization ADO est connecté à Microsoft Entra compte, procédez comme suit.

1. Accédez à Azure DevOps et sélectionnez le organization requis.
2. Sélectionnez Organization settings.
3. Dans le volet de navigation gauche, sélectionnez Microsoft Entra sous l’en-tête « Général ».
4. Vérifiez que le organization est connecté au compte Microsoft Entra de votre locataire.

Créer une application sur Microsoft Entra ID

1. Accédez au Portail Azure et connectez-vous avec les informations d’identification d’administrateur du locataire.
2. Accédez à Microsoft Entra ID ->Gérer ->inscriptions d'applications dans le volet de navigation, puis sélectionnez Nouvelle inscription.
3. Fournissez un nom pour l’application, puis sélectionnez Inscrire.
4. Notez l’ID d’application (client). Cet ID est utilisé pour accorder à l’application Microsoft Entra l’accès aux projets dans le organization ADO.
5. Ouvrez autorisations d’API dans le volet de navigation et sélectionnez Ajouter une autorisation.
6. Sélectionnez Azure DevOps , puis Autorisations déléguées.
7. Recherchez les autorisations suivantes, puis sélectionnez Ajouter des autorisations.
   a. Identité (lecture)
   b. Éléments de travail (lecture)
   c. Variable Groupes (lecture)
   d. Projet et équipe (lecture)
   e. Graphe (lecture)
   f. Analytique (lecture)
   
8. Sélectionnez Accorder le consentement administrateur pour [TenantName] et confirmez en sélectionnant Oui.
9. Vérifiez que les autorisations sont dans l’état « Accordé ».
10. Ouvrez Authentification à partir du volet de navigation. Sélectionnez Add a platform et choisissez Web. Ajoutez l’un des URI suivants sous « URI de redirection » :
    • Pour M365 Enterprise : https:// gcs.office.com/v1.0/admin/oauth/callback
    • Pour le gouvernement M365 : https:// gcsgcc.office.com/v1.0/admin/oauth/callback
11. Sous Octroi implicite et flux hybrides, case activée l’option pour ID tokens (used for implicit and hybrid flows) et cliquez sur Configurer.
12. Dans le volet de navigation, sélectionnez Certificats et secrets sous Gérer.
13. Sélectionnez Nouvelle clé secrète client , puis sélectionnez une période d’expiration pour le secret. Copiez le secret généré (Valeur) et enregistrez-le, car il n’est plus affiché.
14. Utilisez cette clé secrète client et l’ID d’application pour configurer le connecteur.

Accorder à l’application Microsoft Entra l’accès aux projets dans le organization ADO

Vous devez fournir à l’application Microsoft Entra l’accès nécessaire aux projets qui doivent être indexés en procédant comme suit :

1. Accédez à Azure DevOps et sélectionnez le organization requis.
2. Sélectionnez Organization settings.
3. Dans le volet de navigation gauche, sélectionnez Users sous l’en-tête « Général ».
4. Sélectionnez Add users.
5. Copiez l’ID d’application (client) obtenu à partir de l’application dans « Utilisateurs ou principaux de service ».
6. Accordez le niveau d’accès Basic et sélectionnez les projets pour autoriser l’accès à l’index. Ajoutez également au Project Reader groupe Azure DevOps (ou équivalent) pour garantir l’accès. Désactivez la sélection de l’option permettant d’envoyer une invitation par e-mail aux utilisateurs.

Azure DevOps OAuth

Pour vous connecter à votre instance Azure DevOps, vous avez besoin de votre nom de organization Azure DevOps, de son ID d’application et de sa clé secrète client pour l’authentification OAuth.

Inscrire une application

Inscrivez une application dans Azure DevOps afin que l’application Recherche Microsoft et Microsoft 365 Copilot puissent accéder à la instance. Pour en savoir plus, consultez la documentation Azure DevOps sur l’inscription d’une application.

Le tableau suivant fournit des conseils sur la façon de remplir le formulaire d’inscription de l’application :

Lors de l’inscription de l’application, vous obtenez l’ID d’application et la clé secrète client qui sont utilisés pour configurer le connecteur.

Paramètres de connexion

Après avoir inscrit l’application Recherche Microsoft auprès d’Azure DevOps, vous pouvez effectuer l’étape des paramètres de connexion. Entrez le nom de votre organization, l’ID de l’application et la clé secrète client.

Configurer les données : sélectionner des projets et des champs

Vous pouvez choisir que la connexion indexe l’ensemble du organization ou des projets spécifiques.

Si vous choisissez d’indexer l’intégralité de la organization, les éléments de tous les projets du organization sont indexés. Les nouveaux projets et éléments sont indexés lors de l’analyse suivante après leur création.

Si vous choisissez des projets individuels, seuls les éléments de travail des projets sélectionnés sont indexés.

Ensuite, sélectionnez les champs que la connexion doit indexer et afficher un aperçu des données dans ces champs avant de continuer.

Étape 4 : Gérer les autorisations de recherche

Le connecteur Azure DevOps Work Items Microsoft Graph prend en charge les autorisations de recherche visibles uniquement pour les personnes ayant accès à cette source de données ou tout le monde. Si vous choisissez Uniquement les personnes ayant accès à cette source de données, les données indexées apparaissent dans les résultats de la recherche pour les utilisateurs qui y ont accès en fonction des autorisations accordées aux utilisateurs ou aux groupes au niveau du chemin d’accès Organisation, Projet ou Zone dans Azure DevOps. Si vous choisissez Tout le monde, les données indexées apparaissent dans les résultats de la recherche pour tous les utilisateurs.

Étape 5 : Attribuer des étiquettes de propriété

Suivez les instructions d’installation générales.

Étape 6 : Gérer le schéma

Suivez les instructions d’installation générales.

Étape 7 : Choisir les paramètres d’actualisation

Le connecteur Azure DevOps Work Items Microsoft Graph prend en charge les planifications d’actualisation pour les analyses complètes et incrémentielles. La planification recommandée est d’une heure pour une analyse incrémentielle et d’une journée pour une analyse complète.

Étape 8 : Vérifier la connexion

Suivez les instructions d’installation générales.

Résolution des problèmes

Après avoir publié votre connexion, vous pouvez consulter la status sous l’onglet Sources de données dans le Centre d’administration. Pour savoir comment effectuer des mises à jour et des suppressions, consultez Gérer votre connecteur. Vous trouverez les étapes de résolution des problèmes courants ici.

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