Connecteur Microsoft Graph Azure DevOps Wiki

Le connecteur Microsoft Graph Wiki Azure DevOps permet à votre organization d’indexer des wikis dans son instance du service Azure DevOps. Après avoir configuré le connecteur, les utilisateurs finaux peuvent rechercher des wikis de projet et des wikis de code à partir d’Azure DevOps dans Recherche et Microsoft 365 Copilot Microsoft.

Cet article est destiné aux administrateurs Microsoft 365 ou à toute personne qui configure, exécute et surveille un connecteur Microsoft Graph Azure DevOps Wiki.

Importante

Le connecteur Microsoft Graph Wiki Azure DevOps prend uniquement en charge le service cloud Azure DevOps. Azure DevOps Server 2019, TFS 2018, TFS 2017, TFS 2015 et TFS 2013 ne sont pas pris en charge par ce connecteur.

Fonctionnalités

• Indexer des wikis à partir d’Azure DevOps
• Permettre à vos utilisateurs finaux de poser des questions relatives aux wikis de projet et aux wikis de code.
• Utilisez la recherche sémantique dans Copilot pour permettre aux utilisateurs de trouver du contenu pertinent en fonction des mots clés, des préférences personnelles et des connexions sociales.

Limitations

• Le connecteur indexe uniquement un organization ADO par connexion.

Configuration requise

• Vous devez être l’administrateur de recherche du locataire Microsoft 365 de votre organization.

• Pour permettre au connecteur de se connecter à votre organization 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é .

  

• Compte de service : pour vous connecter à Azure DevOps et autoriser le connecteur Microsoft Graph à mettre à jour régulièrement les wikis, vous avez besoin d’un compte de service avec les autorisations suivantes qui lui sont accordées.

  Nom de l’autorisation	Type d’autorisation	Requis pour
  Afficher les informations au niveau du projet	Autorisation de projet	Analyse des éléments de travail Azure DevOps. Cette autorisation est obligatoire pour les projets qui doivent être indexés.

  Importante

  Le compte de service doit avoir un niveau d’accès De base . Pour en savoir plus sur les niveaux d’accès dans Azure DevOps, lisez niveaux d’accès pris en charge.

Prise en main

1. Nom d’affichage

Un nom d’affichage est utilisé pour identifier chaque citation dans Copilot, ce qui permet aux utilisateurs de reconnaître facilement le fichier ou l’élément associé. Le nom d’affichage indique également le contenu approuvé. Le nom d’affichage est également utilisé comme filtre de source de contenu. Une valeur par défaut est présente pour ce champ, mais vous pouvez la personnaliser avec un nom que les utilisateurs de votre organization reconnaître.

2. Type d’authentification

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

Importante

• Microsoft Entra ID OAuth est en préversion et disponible pour certains clients. Il s’agit du mécanisme OAuth recommandé .
• Azure DevOps OAuth est le mécanisme d’authentification hérité, qui n’est pas activement investi.

a. 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. Code (lecture)
   c. Droits d’utilisation (lecture)
   d. Projet et équipe (lecture)
   e. Graphe (lecture)
   f. MemberEntitlement Management (lecture)
   g. Wiki (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 ID d’application et de votre clé secrète client Azure DevOps organization 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 inscrire l’application, visitez le lien pour inscrire l’application. 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 :

Champs obligatoires	Description	Valeur recommandée
Nom de la société	Nom de votre entreprise.	Utilisez une valeur appropriée.
Nom de l’application	Valeur unique qui identifie l’application que vous autorisez.	Recherche Microsoft.
Site web de l’application	URL de l’application qui demande l’accès à votre instance Azure DevOps pendant la configuration du connecteur. (obligatoire).	Pour Microsoft 365 Entreprise : https:// gcs.office.com/, Pour Microsoft 365 Gouvernement : https:// gcsgcc.office.com/
URL de rappel d’autorisation	URL de rappel obligatoire vers laquelle le serveur d’autorisation redirige.	Pour Microsoft 365 Entreprise : https:// gcs.office.com/v1.0/admin/oauth/callback, Pour Microsoft 365 Government : https:// gcsgcc.office.com/v1.0/admin/oauth/callback
Étendues autorisées	Étendue d’accès pour l’application	Sélectionnez les étendues suivantes : Identité (lecture), Code (lecture), Droits d’utilisation (lecture), Projet et Équipe (lecture), Graph (lecture), Gestion des droits d’utilisation des membres (lecture), Wiki (lecture).

Importante

Les étendues autorisées sélectionnées pour l’application doivent correspondre exactement aux étendues répertoriées ci-dessus. Si plus ou moins d’étendues sont sélectionnées, l’autorisation échoue.

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.

Pour révoquer l’accès à une application inscrite dans Azure DevOps, accédez à Paramètres utilisateur en haut à droite de votre instance Azure DevOps. Sélectionnez Profil , puis Autorisations dans la section Sécurité du volet latéral. Pointez sur une application OAuth autorisée pour voir le bouton Révoquer dans le coin des détails de l’application.

3. Sélectionnez Organisation

Le connecteur Azure DevOps permet l’indexation d’un organization par connexion. Pour vous connecter à votre service Azure DevOps, sélectionnez le organization approprié dans la liste des organisations accessibles au compte de service.

4. Déployer pour un public limité

Déployez cette connexion sur une base d’utilisateurs limitée si vous souhaitez la valider dans Copilot et d’autres surfaces de recherche avant d’étendre le déploiement à un public plus large. Pour en savoir plus sur le déploiement limité, consultez Déploiement intermédiaire.

À ce stade, vous êtes prêt à créer la connexion pour les wikis Azure DevOps. Vous pouvez cliquer sur Créer pour publier vos wikis de connexion et d’index à partir de votre organization Azure DevOps.

Pour les autres paramètres, tels que les autorisations d’accès, lesrègles d’inclusion de données, le schéma, la fréquence d’analyse, etc., nous avons des valeurs par défaut basées sur ce qui fonctionne le mieux avec les données ADO. Vous pouvez voir les valeurs par défaut ci-dessous :

Utilisateurs	Description
Autorisations d’accès	Uniquement les personnes ayant accès au contenu dans la source de données.
Mapper des identités	Identités de source de données mappées à l’aide d’ID de Microsoft Entra.

Contenu	Description
Projets de site	Tous les projets sont indexés.
Gérer les propriétés	Pour case activée propriétés par défaut et leur schéma, consultez le contenu

Synchronisation	Description
Analyse incrémentielle	Fréquence : toutes les 15 minutes
Analyse complète	Fréquence : Tous les jours

Si vous souhaitez modifier l’une de ces valeurs, vous devez choisir la « Configuration personnalisée »

Configuration personnalisée

L’installation personnalisée est destinée aux administrateurs qui souhaitent modifier les valeurs par défaut des paramètres répertoriés dans le tableau ci-dessus. Une fois que vous avez cliqué sur l’option « Configuration personnalisée », trois onglets supplémentaires s’affichent : Utilisateurs, Contenu et Synchronisation.

Utilisateurs

Autorisations d’accès

Le connecteur Wiki Azure DevOps prend en charge les autorisations de recherche visibles pour tout le monde ou uniquement pour les personnes ayant accès à cette source de données. Si vous choisissez Tout le monde, les données indexées apparaissent dans les résultats de la recherche pour tous les utilisateurs. 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.

Remarque

Mises à jour aux groupes qui régissent les autorisations d’accès sont synchronisées uniquement dans des analyses complètes. Les analyses incrémentielles ne prennent pas en charge le traitement des mises à jour des autorisations.

Contenu

Choisir des projets

Dans cette étape, vous spécifiez l’étendue des données que vous souhaitez indexer à l’aide du connecteur Microsoft Graph Wiki Azure DevOps. Vous pouvez ensuite choisir que la connexion indexe l’intégralité du organization ou des projets spécifiques dans le organization sélectionné.

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

Si vous choisissez d’indexer des projets individuels, seuls les wikis des projets sélectionnés sont indexés.

Gérer les propriétés

Ici, vous pouvez ajouter ou supprimer des propriétés disponibles de votre source de données Azure DevOps, affecter un schéma à la propriété (définir si une propriété peut faire l’objet d’une recherche, s’il est interrogeable, récupérable ou refinable), modifier l’étiquette sémantique et ajouter un alias à la propriété. Les propriétés sélectionnées par défaut sont répertoriées ci-dessous.

Source, propriété	Étiquette	Description	Schéma
des auteurs	des auteurs	Nommez toutes les personnes qui ont participé ou collaboré sur l’élément dans la source de données	Récupérer
CommitId
Contenu	Contenu	Corps du contenu du wiki	Recherche
GitItemPath
IconUrl	IconUrl	URL de l’icône qui représente le wiki	Récupérer
isParentPage
LastPublishedAuthorEmail	Auteur de la dernière modification		Récupérer
LastPublishedDate	Date et heure de la dernière modification	Date et heure de la dernière modification de l’élément dans la source de données	Retrive
Organisation			Récupérer
Path
Project			Récupérer
ProjectId			Récupérer
RemoteURL	url	URL du wiki dans la source de données	Récupérer
Titre	Titre	Titre de la page wiki	Rechercher, Récupérer
Version			Récupérer
WikiId			Récupérer
WikiIdentifier			Récupérer
WikiType

Afficher un aperçu des données

Utilisez le bouton d’aperçu des résultats pour vérifier les exemples de valeurs des propriétés sélectionnées.

Synchronisation

L’intervalle d’actualisation détermine la fréquence à laquelle vos données sont synchronisées entre la source de données et l’index du connecteur Graph. Il existe deux types d’intervalles d’actualisation : l’analyse complète et l’analyse incrémentielle. Pour plus d’informations, consultez Paramètres d’actualisation.

Vous pouvez modifier les valeurs par défaut de l’intervalle d’actualisation à partir d’ici si vous le souhaitez.

Page Configurer les résultats de la recherche

Après avoir publié la connexion, vous devez personnaliser la page des résultats de recherche avec les secteurs verticaux et les types de résultats. Pour en savoir plus sur la personnalisation des résultats de recherche, passez en revue la gestion des secteurs verticaux et destypes de résultats.

Vous pouvez également utiliser l’exemple de disposition des résultats pour le connecteur Microsoft Graph Wiki Azure DevOps. Il vous suffit de copier-coller le json de disposition des résultats pour commencer.

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.