Connecteur Microsoft Graph Azure DevOps Wiki
Le connecteur 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 Microsoft.
Remarque
- Lisez l’article Configuration de votre connecteur Graph pour comprendre les instructions générales de configuration des connecteurs Graph.
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é .
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
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 à 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. | 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.
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 d’indexer la totalité de la 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 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 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 ». |