Connecteur Microsoft Graph Atlassian Jira Cloud

  • Article

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

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 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 :

  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.

Remarque

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

  1. Choisissez l’option Azure AD si l’ID de Email des utilisateurs Jira est identique à l’UTILISATEURPrincipalName (UPN) des utilisateurs dans Azure AD.
  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 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.