Connecteur Microsoft Graph Atlassian Jira Cloud
Le connecteur Microsoft Graph Atlassian Jira Cloud permet à votre organization d’indexer les problèmes Jira. Après avoir configuré le connecteur et indexé le contenu du site Jira, les utilisateurs finaux peuvent rechercher ces éléments dans Recherche Microsoft.
Remarque
Lisez l’article Configurer des connecteurs Microsoft Graph dans le Centre d'administration Microsoft 365 pour comprendre les instructions générales de configuration des connecteurs.
Cet article s’adresse à toute personne qui configure, exécute et surveille un connecteur Atlassian Jira Cloud. Il complète le processus de configuration générale et affiche des instructions qui s’appliquent uniquement au connecteur Atlassian Jira Cloud.
Importante
Le connecteur Atlassian Jira Cloud prend uniquement en charge les instances hébergées dans le cloud Jira. Les versions de Jira Server et Jira Data Center ne sont pas prises en charge par ce connecteur.
Avant de commencer
Vous devez être l’administrateur du locataire Microsoft 365 de votre organization et l’administrateur du site Jira de votre organization.
Vous aurez besoin des autorisations suivantes accordées au compte d’utilisateur dont les informations d’identification sont utilisées lors de la configuration du connecteur :
Nom de l’autorisation | Type d’autorisation | Requis pour |
---|---|---|
Parcourir les projets | Autorisation de projet | Problèmes liés à L’analyse de Jira. Cette autorisation est obligatoire pour les projets qui doivent être indexés. |
Autorisations de sécurité au niveau du problème | Sécurité au niveau du problème | Analyse de différents types de problèmes. Cette autorisation est facultative. |
Parcourir les utilisateurs et les groupes | Autorisation globale | Suppression des résultats de la recherche de liste de contrôle d’accès. Cette autorisation est facultative et nécessaire pour sélectionner Only people with access to this data source l’option à l’étape 4 ci-dessous. |
Administrer Jira | Autorisation globale | Suppression des résultats de la recherche de liste de contrôle d’accès. Cette autorisation est facultative et nécessaire pour sélectionner Only people with access to this data source l’option à l’étape 4 ci-dessous. |
Étape 1 : Ajouter un connecteur 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 site Jira, utilisez l’URL de votre site Jira. Une URL de site cloud Jira ressemble généralement à https://< organization_name.atlassian.net/>. Vous pouvez choisir Authentification de base ou OAuth 2.0 (recommandé) pour vous authentifier auprès de votre site Jira.
Authentification de base
Entrez le nom d’utilisateur de votre compte (généralement l’ID d’e-mail) et le jeton d’API pour vous authentifier à l’aide de l’authentification de base. Pour en savoir plus sur la génération d’un jeton d’API, consultez la documentation d’Atlassian sur la gestion des jetons d’API pour votre compte Atlassian.
OAuth 2.0
Inscrivez une application dans Atlassian Jira afin que l’application Recherche Microsoft puisse accéder aux instance. Pour en savoir plus, consultez la documentation du support Atlassian sur l’activation d’OAuth 2.0.
Les étapes suivantes fournissent des conseils sur l’inscription de l’application :
Connectez-vous à la console Atlassian Developer avec votre compte d’administrateur Atlassian Jira.
Sélectionnez sur
Create
et sélectionnezOAuth 2.0 integration
.Fournissez un nom approprié pour l’application et créez-la.
Accédez à à
Permissions
partir du volet de navigation sur la gauche. Sous l’en-tête « Granular Permissions », sélectionnezAdd
pourJira API
. Une fois ajouté, sélectionnez etConfigure
ajoutez les étendues suivantes répertoriées ci-dessous.# Nom de l'étendue Code 1 Afficher les champs read:field:jira
2 Afficher les avatars read:avatar:jira
3 Afficher les catégories de projets read:project-category:jira
4 Afficher les projets read:project:jira
5 Lire les configurations de champ read:field-configuration:jira
6 Afficher les types de problèmes read:issue-type:jira
7 Afficher les propriétés du projet read:project.property:jira
8 Afficher les utilisateurs read:user:jira
9 Afficher les rôles d’application read:application-role:jira
10 Afficher les groupes read:group:jira
11 Hiérarchies de type de problème en lecture read:issue-type-hierarchy:jira
12 Afficher les versions du projet read:project-version:jira
13 Afficher les composants du projet read:project.component:jira
14 Afficher les détails du problème read:issue-details:jira
15 Afficher les journaux d’audit read:audit-log:jira
16 Afficher la méta de problème read:issue-meta:jira
17 Afficher les rôles de projet read:project-role:jira
18 Afficher les niveaux de sécurité des problèmes read:issue-security-level:jira
19 Afficher les schémas de sécurité des problèmes read:issue-security-scheme:jira
20 Afficher les schémas d’autorisation read:permission-scheme:jira
21 Afficher les autorisations read:permission:jira
Accédez à à
Authorization
partir du volet de navigation à gauche. Ajoutez l’URL de rappel pour M365 Enterprise :https://gcs.office.com/v1.0/admin/oauth/callback
, pour M365 Government :https://gcsgcc.office.com/v1.0/admin/oauth/callback
et enregistrez les modifications.Accédez à à
Settings
partir du volet de navigation à gauche. Vous obtiendrez leClient ID
etSecret
à partir de cette page.
Effectuez l’étape des paramètres de connexion à l’aide de l’ID client et du secret.
Remarque
- Reportez-vous à la liste des étendues pour les applications OAuth 2.0 pour en savoir plus sur les autorisations Jira.
- Les autorisations OAuth (classiques) d’origine sont déconseillées pour le cloud Jira. Reportez-vous à l’annonce du journal des modifications pour en savoir plus.
Étape 3a : Configurer les données : Sélectionner des projets
Vous pouvez choisir que la connexion indexe l’intégralité du site Jira ou des projets spécifiques uniquement.
- Si vous choisissez d’indexer l’intégralité du site Jira, les problèmes Jira dans tous les projets du site seront indexés. Les nouveaux projets et problèmes seront indexés lors de l’analyse suivante après leur création.
- Si vous choisissez des projets individuels, seuls les problèmes Jira dans ces projets seront indexés.
Remarque
Lorsque vous accordez l’autorisation Parcourir des projets à un projet Jira, elle est répertoriée et peut être analysée. Si un projet est manquant, case activée les autorisations pour votre compte.
Vous pouvez également choisir de filtrer les problèmes Jira qui seront indexés de deux manières.
- Spécifiez la période de modification du problème. Cela indexe uniquement les problèmes Jira qui sont créés ou modifiés dans la période sélectionnée sur une base propagée en fonction de l’analyse actuelle.
- Spécifiez le JQL. Cela indexe uniquement les problèmes Jira qui sont retournés après le filtrage en fonction du langage de requête Jira (JQL) fourni. Pour en savoir plus sur l’utilisation de JQL, consultez la documentation du support Atlassian sur l’utilisation de la recherche avancée avec le langage de requête Jira.
Conseil
Vous pouvez utiliser le filtre JQL pour indexer uniquement des types de problèmes Jira spécifiques à l’aide de « issueType dans (Bogue,Amélioration) »
Étape 3b : Configurer les données : Sélectionner des propriétés
Sélectionnez les champs que vous souhaitez que la connexion indexe et affiche un aperçu des données dans ces champs avant de continuer. Certains champs sont déjà sélectionnés par défaut et ne peuvent pas être supprimés.
Le connecteur Atlassian Jira peut indexer à la fois les champs de problème par défaut et les champs de problème créés personnalisés.
Remarque
Si un champ personnalisé créé sélectionné n’est pas présent dans certains types de problème Jira, le champ est ingéré comme NULL (vide).
Étape 4 : Gérer les autorisations de recherche
Le connecteur Atlassian Jira 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. Dans Atlassian Jira, les autorisations de sécurité sont définies à l’aide de schémas d’autorisation de projet contenant des groupes au niveau du site et des rôles de projet. La sécurité au niveau du problème peut également être définie à l’aide de schémas d’autorisation au niveau du problème.
Si vous choisissez Uniquement les personnes ayant accès à cette source de données, vous devez choisir davantage si votre site Jira a des utilisateurs provisionnés Azure Active Directory (Azure AD) ou des utilisateurs non-Azure AD.
Pour identifier l’option qui convient à votre organization :
- Choisissez l’option Azure AD si l’ID de Email des utilisateurs Jira est identique à l’UTILISATEURPrincipalName (UPN) des utilisateurs dans Azure AD.
- Choisissez l’option Non-Azure AD si l’ID d’e-mail des utilisateurs Jira est différent de l’UtilisateurPrincipalName (UPN) des utilisateurs dans Azure AD.
Remarque
- Si vous choisissez Azure AD comme type de source d’identité, le connecteur mappe les ID Email des utilisateurs obtenus directement à partir de Jira à la propriété UPN d’Azure AD.
- Si vous avez choisi « Non-Azure AD » pour le type d’identité, consultez [Mapper vos identités non-Azure AD](map-non-Azure AD.md) pour obtenir des instructions sur le mappage des identités. Vous pouvez utiliser cette option pour fournir l’expression régulière de mappage de l’ID Email à l’UPN.
É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 Atlassian Jira 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.
Après avoir publié la connexion, vous devez personnaliser la page des résultats de la recherche. Pour en savoir plus sur la personnalisation des résultats de recherche, consultez Personnaliser la page des résultats de recherche.
É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 Jira. Il vous suffit de copier-coller le json de disposition des résultats pour commencer.
Résolution des problèmes
Vous trouverez ci-dessous une liste des erreurs courantes observées lors de la configuration du connecteur ou pendant les analyses, ainsi que leurs raisons possibles.
Étape | Message d’erreur | Raison(s) possible(s) |
---|---|---|
Paramètres de connexion | La demande est de format non valide ou incorrecte. | URL du site Jira incorrecte. |
Paramètres de connexion | Impossible d’accéder au service cloud Jira pour votre site Jira. | URL du site Jira incorrecte. |
Paramètres de connexion | Le client n’a pas l’autorisation d’effectuer l’action. | Jeton d’API non valide fourni pour l’authentification de base. |
Paramètres de connexion | Erreur « Un problème s’est produit » dans la fenêtre contextuelle OAuth. | Les étendues accordées à l’application OAuth ne correspondent pas. Les étendues incompatibles sont répertoriées dans la fenêtre contextuelle. |
Durée de l’analyse (post-configuration du connecteur) | Impossible de s’authentifier auprès de la source de données. Vérifiez que les informations d’identification associées à cette source de données sont correctes. | L’utilisateur ne dispose pas d’une ou de plusieurs autorisations requises pour analyser Jira. |
Durée de l’analyse (post-configuration du connecteur) | Vous n’êtes pas autorisé à accéder à cette source de données. Vous pouvez contacter le propriétaire de cette source de données pour demander l’autorisation. | Si vous utilisez OAuth, les étendues d’application ont peut-être changé ou l’application a peut-être expiré ou supprimée. Si vous utilisez l’authentification de base, le jeton d’API a peut-être expiré ou supprimé. |
Limitations
Voici les limitations connues du connecteur Atlassian Jira :
- Les versions de Jira Server et data center ne sont pas prises en charge.