Déployer le connecteur Atlassian Jira Cloud Copilot

Le connecteur atlassian Jira Cloud Microsoft 365 Copilot permet à votre organization d’indexer les problèmes Jira. Après avoir configuré le connecteur et le contenu d’index à partir du site Jira, les utilisateurs peuvent rechercher ces éléments dans recherche Microsoft et Microsoft 365 Copilot expériences.

Cet article décrit les étapes de déploiement et de personnalisation du connecteur Atlassian Jira Cloud.

Pour plus d’informations sur la configuration du service cloud Jira, consultez Configurer le service cloud Jira pour l’ingestion des connecteurs.

Configuration requise

Avant de déployer le connecteur Atlassian Jira Cloud, assurez-vous que l’environnement Jira Cloud est configuré dans votre organization. Le tableau suivant récapitule les étapes de configuration de l’environnement Jira Cloud et de déploiement du connecteur.

Avant de déployer le connecteur, vérifiez que vous remplissez les conditions préalables suivantes :

• Vous devez être l’administrateur de recherche du locataire Microsoft 365 de votre organization.
• Vérifiez que vous connaissez l’URL de instance Jira Cloud pour votre organization. Pour vous connecter à vos données Jira, vous avez besoin de l’URL de instance Jira de votre organization.
• Pour vous connecter à Jira et autoriser le connecteur Atlassian Jira Cloud Copilot à mettre à jour régulièrement les problèmes, vous avez besoin d’un compte de service avec les autorisations suivantes qui lui sont accordées.

Déployer le connecteur

Pour ajouter le connecteur Atlassian Jira Cloud pour votre organization :

1. Dans le Centre d’administration Microsoft 365, dans le volet gauche, choisissezConnecteursCopilot>.
2. Accédez à l’onglet Connecteurs , puis dans le volet gauche, choisissez Galerie.
3. Dans la liste des connecteurs disponibles, choisissez Atlassian Jira Cloud.

Définir le nom d’affichage

Le nom d’affichage est utilisé pour identifier les références dans les réponses Copilot afin d’aider les utilisateurs à reconnaître le fichier ou l’élément associé. Le nom d’affichage indique également le contenu approuvé et est utilisé comme filtre source de contenu.

Vous pouvez accepter le nom complet Atlassian Jira Cloud par défaut ou personnaliser la valeur pour utiliser un nom d’affichage que les utilisateurs de votre organization reconnaissent.

Pour plus d’informations sur les noms d’affichage et les descriptions des connecteurs, consultez Améliorer la découverte Copilot avec Microsoft 365 Copilot contenu des connecteurs.

Définir instance URL

Pour vous connecter à vos données cloud Jira, vous avez besoin de l’URL de instance Jira de votre organization. L’URL Jira instance de votre organization se présente généralement comme suit : https://<your-organization-domain>.atlassian.net.

Si vous n’avez pas encore de instance, consultez Atlassian Jira pour créer un instance de test.

Choisir le type d’authentification

Pour authentifier et synchroniser les problèmes de Jira, choisissez l’une des méthodes d’authentification prises en charge suivantes :

• 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 plus d’informations sur la façon de générer un jeton d’API, consultez Gérer les jetons d’API pour votre compte Atlassian.

• Atlassian Jira OAuth 2.0 (recommandé) : pour utiliser Jira OAuth pour l’authentification :

  1. Inscrivez une application dans Atlassian Jira afin que l’application Recherche Microsoft et Microsoft 365 Copilot puissent accéder à la instance. Pour plus d’informations, consultez Activer OAuth 2.0.
  2. Connectez-vous à la console Atlassian Developer avec votre compte d’administrateur Atlassian Jira.
  3. Choisissez Créer et sélectionnez Intégration OAuth 2.0.
  4. Fournissez un nom approprié pour l’application et créez-la.
  5. Accédez à Autorisations dans le volet de navigation à gauche. Sélectionnez Ajouter pour l’API Jira , puis sélectionnez Configurer. Sous Autorisations granulaires, ajoutez les étendues requises.
  6. Accédez à Autorisation à partir du volet de navigation sur la gauche pour ajouter l’URL de rappel :
     1. Pour Microsoft 365 Entreprise :https://gcs.office.com/v1.0/admin/oauth/callback
     2. Pour Microsoft 365 Government : https://gcsgcc.office.com/v1.0/admin/oauth/callback
  7. Cliquez sur Enregistrer.
  8. Accédez à Paramètres dans le volet gauche pour obtenir l’ID client et le secret. Effectuez l’étape des paramètres de connexion à l’aide de l’ID client et du secret.

Déploiement

Pour effectuer un déploiement sur un public limité, choisissez le bouton bascule en regard de Déploiement sur une audience limitée et spécifiez les utilisateurs et les groupes sur lesquels déployer le connecteur. Pour plus d’informations, consultez Déploiement intermédiaire pour les connecteurs Microsoft 365 Copilot.

Choisissez Créer pour déployer la connexion. Le connecteur Atlassian Jira Cloud Copilot commence immédiatement à indexer du contenu.

Les valeurs par défaut du connecteur sont les suivantes :

Utilisateurs

• Autorisations d’accès : seules les personnes ayant accès au contenu dans la source de données.
• Mapper les identités : identités de source de données mappées à l’aide d’ID de Microsoft Entra.

Content

• Projets de site : tous les projets sont indexés.
• Filtrer les données : tous les problèmes sont indexés. Aucun filtre de temps ou critère JQL n’est appliqué.
• Gérer les propriétés : pour case activée propriétés par défaut et leur schéma, consultez Personnaliser les paramètres de contenu

Sync

• Analyse incrémentielle : Fréquence : toutes les 15 minutes
• Analyse complète : Fréquence : Tous les jours

Après avoir créé votre connexion, vous pouvez consulter les status dans la section Connecteurs du Centre d’administration Microsoft 365.

Personnaliser les paramètres (facultatif)

Vous pouvez personnaliser les valeurs par défaut pour les paramètres du connecteur Atlassian Jira Cloud. Pour personnaliser les paramètres, dans la page du connecteur dans le Centre d’administration, choisissez Configuration personnalisée.

Personnaliser les paramètres utilisateur

Autorisations d’accès

Le connecteur Atlassian Jira Cloud Copilot 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.

Mappage des identités

La méthode par défaut pour mapper vos identités de source de données avec Microsoft Entra ID consiste à rendre l’ID d’e-mail des utilisateurs Jira identique au nom d’utilisateur principal (UPN) ou à l’adresse e-mail des utilisateurs dans Microsoft Entra ID. Si le mappage par défaut ne fonctionne pas pour votre organization, vous pouvez fournir une formule de mappage personnalisée. Pour plus d’informations, consultez Mapper vos identités AD non Azure.

• Choisissez l’option Microsoft Entra ID si l’ID d’e-mail des utilisateurs Jira est identique à l’UPN des utilisateurs dans Microsoft Entra ID.
• Choisissez l’option Non Microsoft Entra ID si l’ID de messagerie des utilisateurs Jira est différent de l’UPN et de l’adresse e-mail des utilisateurs dans Entra ID.

Personnaliser les paramètres de contenu

Choisir des projets et filtrer les données

• Projets de site : 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 sont indexés. Les nouveaux projets et problèmes sont indexés lors de l’analyse suivante après leur création.
  • Si vous choisissez des projets individuels, seuls les problèmes Jira dans les projets sélectionnés sont indexés.

• Filtrer les données : vous pouvez choisir de filtrer les problèmes Jira indexés de deux manières :
  • Spécifiez la période de modification du problème. Cette option indexe uniquement les problèmes Jira créés ou modifiés au cours de la période sélectionnée sur une base propagée en fonction de l’analyse actuelle.
  • Utilisez le filtre JQL pour indexer uniquement des types de problèmes Jira spécifiques à l’aide issueType in (Bug, Improvement)de .

Gérer les propriétés

Vous pouvez ajouter ou supprimer des propriétés disponibles à partir de votre source de données Jira, affecter un schéma à la propriété (définir si une propriété peut faire l’objet d’une recherche, s’il est interrogeable, récupérable ou refinable), modifier l’étiquette sémantique et ajouter un alias à la propriété. Le tableau suivant répertorie les propriétés sélectionnées par défaut.

Afficher un aperçu des données

Utilisez le bouton d’aperçu des résultats pour vérifier les exemples de valeurs des propriétés sélectionnées et du filtre de requête.

Personnaliser les intervalles de synchronisation

L’intervalle d’actualisation détermine la fréquence à laquelle vos données sont synchronisées entre la source de données et l’index du connecteur Atlassian Jira Cloud Copilot. Voici les deux types d’intervalles d’actualisation :

• Analyse incrémentielle : toutes les 15 minutes
• Analyse complète : tous les jours

Vous pouvez modifier les valeurs par défaut de l’intervalle d’actualisation. Pour plus d’informations, consultez Recommandations pour les paramètres de synchronisation.

Contenu connexe

• Vue d’ensemble du connecteur Atlassian Jira Cloud
• Résoudre les problèmes liés au connecteur Atlassian Jira Cloud
• Configurer des connecteurs Copilot dans le Centre d’administration Microsoft 365