Connecteur Microsoft Graph Atlassian Jira Cloud

  • Article

Le connecteur Atlassian Jira Cloud Microsoft Graph permet à votre organisation 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.

Notes

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 organisation et l’administrateur du site Jira de votre organisation.

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

Ajouter un connecteur Jira

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 à l’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 :

  1. Connectez-vous à la console Atlassian Developer avec votre compte d’administrateur Atlassian Jira.

  2. Sélectionnez sur Create et sélectionnez OAuth 2.0 integration.

  3. Fournissez un nom approprié pour l’application et créez-la.

  4. Accédez à à Permissions partir du volet de navigation sur la gauche. Sous l’en-tête « Granular Permissions », sélectionnez Add pour Jira API. Une fois ajouté, sélectionnez et Configure 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

  5. 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.

  6. Accédez à à Settings partir du volet de navigation à gauche. Vous obtiendrez le Client ID et Secret à partir de cette page.

Effectuez l’étape des paramètres de connexion à l’aide de l’ID client et du secret.

Notes

É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.

Notes

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, vérifiez les autorisations de 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.

La liste des propriétés que vous sélectionnez ici peut avoir un impact sur la façon dont vous pouvez filtrer, rechercher et afficher vos résultats dans Copilot pour Microsoft 365.

Source, propriété Label Description
des auteurs authors Nom des personnes qui ont participé ou collaboré sur l’élément dans la source de données.
Créé createdDateTime Date et heure de création de l’élément dans la source de données.
IssueIconUrl iconUrl URL de l’icône associée avec une priorité de problème spécifique.
IssueLink url L’URL cible de l’élément dans la source de données.
ReporterEmailId createdBy Nom de la personne qui a récemment modifié l’élément dans la source de données.
Titre title Le titre de l’élément que vous souhaitez voir dans la recherche et d’autres expériences.
Mis à jour lastModifiedDateTime Date et heure de la dernière modification de l’élément dans la source de données.

Notes

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.

Importante

Le connecteur Jira cloud Graph doit être en mesure de lire l’ID d’e-mail d’un utilisateur dans Jira pour attribuer de manière appropriée des autorisations de sécurité dans Recherche Microsoft. Pour cela, vous devez vous assurer de l’une des opérations suivantes :

  • Tous les utilisateurs doivent avoir sélectionné l’option « Tout le monde » pour leurs paramètres de visibilité de profil. Pour en savoir plus sur les paramètres de visibilité des profils, reportez-vous à la documentation d’Atlassian.
  • Pour les organisations qui utilisent des « comptes managés » (tous les comptes Atlassian avec des adresses e-mail de votre domaine vérifié deviennent des comptes managés. Pour plus d’informations , reportez-vous à cette documentation :
  • Tous les utilisateurs, qui font partie de comptes gérés, doivent avoir le paramètre de compte managé sélectionné dans les paramètres de visibilité du profil.
  • Les utilisateurs qui ne font pas partie du compte managé (comme le compte d’analyse) doivent avoir sélectionné « Tout le monde » dans leurs paramètres de visibilité de profil.
  • Le compte d’analyse utilisé lors de la configuration de la connexion doit avoir le domaine du compte managé.

Si vous choisissez Uniquement les personnes ayant accès à cette source de données, vous devez choisir davantage si votre site Jira dispose d’utilisateurs provisionnés d’ID Microsoft Entra ou d’utilisateurs non-Azure AD.

Pour identifier l’option qui convient à votre organisation :

  1. Choisissez l’option Microsoft Entra ID si l’ID d’e-mail des utilisateurs Jira est identique à l’UTILISATEURPrincipalName (UPN) des utilisateurs dans l’ID Microsoft Entra.
  2. 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 l’ID Microsoft Entra.

Notes

  • Si vous choisissez l’ID Microsoft Entra comme type de source d’identité, le connecteur mappe les ID d’e-mail des utilisateurs obtenus à partir de Jira directement à la propriété UPN à partir de l’ID Microsoft Entra.
  • 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 d’e-mail à l’UPN.
  • Les mises à jour des utilisateurs ou des groupes qui régissent les autorisations d’accès sont synchronisées uniquement dans les analyses complètes. Les analyses incrémentielles ne prennent actuellement pas en charge le traitement des mises à jour des autorisations.

É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.

Limitations

Voici les limitations connues du connecteur Atlassian Jira :

  • Le connecteur ne prend pas en charge le rôle d’application « Tout utilisateur connecté » pour accorder l’accès aux problèmes.
  • Les versions de Jira Server et data center ne sont pas prises en charge.

Résolution des problèmes

Après avoir publié votre connexion, vous pouvez examiner l’état 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 d’autres problèmes ou si vous souhaitez nous faire part de vos commentaires, écrivez-nous aka.ms/TalkToGraphConnectors.