Connecteur Microsoft Graph Azure DevOps Wiki

Le connecteur Azure DevOps Wiki Graph 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 Microsoft.

Remarque

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

Importante

Le connecteur 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.

Avant de commencer

Vous devez être l’administrateur de recherche du locataire M365 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é .

Accès aux applications tierces via OAuth

Vous aurez besoin des autorisations suivantes accordées au compte d’utilisateur dont les informations d’identification sont utilisées pendant la configuration du connecteur :

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 d’utilisateur doit avoir le 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.

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

Ajouter un connecteur Wiki Azure DevOps

Suivez 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 vous connecter à votre instance Azure DevOps, vous avez besoin de l’ID d’application et de la clé secrète client de votre compte Azure DevOps pour l’authentification OAuth.

Inscrire une application

Inscrivez une application dans Azure DevOps afin que l’application Recherche Microsoft puisse accéder aux 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. Utiliser 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 M365 Enterprise : https:// gcs.office.com/,
For M365 Government: https:// gcsgcc.office.com/
URL de rappel d’autorisation URL de rappel obligatoire vers laquelle le serveur d’autorisation redirige. Pour M365 Enterprise : https:// gcs.office.com/v1.0/admin/oauth/callback,
For M365 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), MemberEntitlement Management (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 avec les détails ci-dessus, vous obtenez l’ID d’application et la clé secrète client qui seront utilisés pour configurer le connecteur.

Remarque

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.

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 votre ID d’application et votre clé secrète client.

Paramètres de l’application de connexion.

Configurer les données : sélectionnez organization, les projets et les champs

Dans cette étape, vous spécifiez l’étendue des données que vous souhaitez indexer à l’aide du connecteur de graphe Wiki Azure DevOps.

Dans un premier temps, vous pouvez choisir les organization que vous souhaitez indexer, parmi toutes les organisations à lesquelles vous avez accès. 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 seront indexés. Les nouveaux projets et wikis seront 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 seront indexés.

Étape 4 : Gérer les autorisations de recherche

Le connecteur Azure DevOps prend en charge les autorisations de recherche visibles par tout le monde. Avec l’option Tout le monde , les données indexées s’affichent 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 Wiki Azure DevOps 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 semaine pour une analyse complète.

Étape 8 : Vérifier la connexion

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

Étape 9 : Configurer la page des résultats de 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 Wiki Azure DevOps. Il vous suffit de copier-coller le json de disposition des résultats pour commencer.

Résolution des problèmes

Voici les erreurs courantes observées lors de la configuration du connecteur, ou pendant l’analyse, et ses raisons possibles.

Étape Message d’erreur Raison(s) possible(s)
Paramètres de connexion Invalid Credentials detected. Try signing in with a different account or check the permissions for your account L’accès aux applications tierces via OAuth peut être désactivé. Suivez les étapes pour gérer les stratégies de sécurité pour activer OAuth.
Paramètres de connexion Bad state message dans la fenêtre contextuelle OAuth avec l’URL indiquant error=InvalidScope Étendues incorrectes fournies à l’application inscrite.
Paramètres de connexion 400 - Bad request message dans la fenêtre contextuelle OAuth ID d’application incorrect
Paramètres de connexion BadRequest: Bad Request on api request message dans la fenêtre contextuelle OAuth Clé secrète client incorrecte
Durée de l’analyse (post-configuration du connecteur) The account associated with the connector doesn't have permission to access the item. L’application inscrite n’a aucune des étendues OAuth requises.
Durée de l’analyse (post-configuration du connecteur) You don't have permission to access this data source. You can contact the owner of this data source to request permission. L’accès aux applications tierces via OAuth est désactivé. Suivez les étapes pour gérer les stratégies de sécurité pour activer OAuth.
Durée de l’analyse (post-configuration du connecteur) Credentials associated with this data source have expired. Renew the credentials and then update the connection L’application inscrite a peut-être été supprimée ou a expiré.
Durée de l’analyse (post-configuration du connecteur) Item listed but no longer accessible or no longer exists Le niveau d’accès « De base » du compte d’analyse est peut-être manquant. Les analyses échouent avec l’accès « Partie prenante ».