Comment ajouter Jira à Dropbox Dash

Admins Mis à jour Aug 26, 2025

In this article

person icon

 Les informations contenues dans cet article s’appliquent aux administrateurs de Dropbox Dash.

Vous pouvez ajouter le compte Atlassian Jira de votre entreprise à Dropbox Dash pour pouvoir accéder à vos tickets Jira et les rechercher par titre et métadonnées directement dans Dash. En synchronisant votre compte Jira avec Dash, vous accéderez rapidement à votre contenu et à vos réponses en un seul clic. 
highlighter icon

Remarques : 

  • Pour configurer Jira, définissez la visibilité par défaut de l’e-mail dans vos paramètres sur public. Découvrez comment configurer la confidentialité de votre adresse e-mail et pourquoi cette opération est sécurisée.Il s’agit d’une exigence pour les applications installées (comme Dash) afin d’accéder aux données d’autorisation. 
  • Les autorisations sur les données ingérées peuvent ne pas être complètes si la visibilité par défaut de l’e-mail n’est pas définie sur public ou si des utilisateurs individuels remplacent les paramètres de visibilité de l’e-mail sur leur compte Atlassian.
  • Dash ne peut prendre en charge que les comptes Jira avec un seul site. Si vous avez plusieurs sites Jira, Dash ne peut pas ingérer vos données Jira.

Autorisations de l’API

Lorsque vous ajoutez Jira, Dash demande les autorisations suivantes :

  • Accéder à vos données hors ligne : cette autorisation permet à Dash de maintenir vos données Jira à jour en arrière-plan, même lorsque vous ne les utilisez pas activement.
  • Afficher les informations de votre profil : cette autorisation permet à Dash d’identifier qui vous êtes dans Jira et d’adapter les résultats de recherche à vos autorisations et à votre identité.
  • Afficher les problèmes et les journaux de travail : cette autorisation permet à Dash d’indexer vos problèmes et votre historique de travail, afin que vous puissiez effectuer des recherches dans les tâches et les tickets.
  • Afficher les détails du projet : cette autorisation permet à Dash d’indexer les projets Jira.
  • Afficher la configuration du tableau : cette autorisation permet à Dash d’indexer les tableaux, les sprints et les epics Jira pour la recherche.
  • Afficher les utilisateurs et leurs rôles : cette autorisation garantit que Dash affiche uniquement ce à quoi chaque utilisateur a accès.
  • Afficher les adhésions de groupe : cette autorisation permet à Dash de vérifier les restrictions d’accès de groupe lors de l’affichage du contenu Jira dans les résultats de recherche.
  • Afficher les avatars : cette autorisation est utilisée pour afficher les avatars dans les résultats de recherche.

Présentation de la configuration

  1. Créez un compte de service administrateur.
  2. Ajoutez Jira à Dash à l’aide de l’une des deux méthodes d’authentification prises en charge :
    • Méthode 1 : méthode de la clé API 
    • Méthode 2 : méthode OAuth
highlighter icon

Remarque : l’avantage principal de l’authentification par clé API par rapport à OAuth dans Jira est qu’elle permet de gérer les autorisations de sécurité au niveau des tickets, dès lors que cette option est activée dans votre configuration Jira. Elles vous permettent également de connecter plusieurs instances Jira à Dash.

Comment créer un compte de service dans Jira

Pour ajouter Jira à Dash, un administrateur Jira doit authentifier et autoriser une intégration au niveau de l’entreprise entre Jira et Dash. Pour améliorer la sécurité et éviter les problèmes liés à l’intégration de Jira et de Dash (par exemple, si un administrateur quitte l’entreprise), il est recommandé de créer un compte de service administrateur non humain dans Jira pour cette intégration.

highlighter icon

Remarques :

  1. Connectez-vous à l’administration Atlassian en utilisant vos identifiants d’administrateur.
  2. Cliquez sur Répertoire.
  3. Cliquez sur Inviter des utilisateurs.
  4. Saisissez l’adresse e-mail de l’utilisateur du compte de service dans le champ Inviter par adresse e-mail….
  5. Sélectionnez l’accès au produit : Jira Software
  6. Cliquez sur Inviter des utilisateurs
    • Vous serez redirigé vers la page d’administration Atlassian pour les utilisateurs et devriez voir « svc-dropboxdash-atlassian-jira » en tant qu’utilisateur invité.
  7. Ouvrez le compte de messagerie de l’utilisateur « svc-dropboxdash-atlassian-jira » et recherchez l’invitation à rejoindre Jira.
  8. Cliquez sur Accepter l’invitation.
  9. Dans la fenêtre contextuelle, saisissez « svc-dropboxdash-atlassian-jira » dans le champ Nom complet.
  10. Saisissez un nouveau mot de passe dans le champ Mot de passe.
    • Notez le mot de passe dans un endroit sûr, comme votre coffre-fort de mots de passe.
  11. Cliquez sur Continuer.
  12. Il vous sera demandé de sélectionner le rôle qui décrit le mieux le travail de votre équipe. Sélectionnez une option appropriée dans le menu déroulant, puis cliquez sur Terminer.
highlighter icon

Remarque : l’étendue d’accès et de contrôle du compte de service doit être limitée à Jira. Si vous avez plusieurs produits Atlassian, vous devez définir les rôles de produit pour ceux qui ne sont pas spécifiques à Jira sur Aucun.

Méthode 1 : méthode de la clé API

Pour utiliser cette méthode d’authentification, créez un jeton API et une clé API d’organisation avant d’ajouter Jira à Dash.

  1. Créez un jeton API à l’aide d’un rôle d’administrateur de produit dans Jira. Découvrez comment créer un jeton API (sans champs d’applications).
highlighter icon

Remarques : 

  • Vous devez avoir accès à tous les projets que vous souhaitez synchroniser avec Dash. Si de nouveaux projets sont créés dans Jira et que votre compte y a accès, ces projets seront synchronisés automatiquement.
  • Il est recommandé de définir l’expiration de la clé API à un an (maximum). Assurez-vous de définir un rappel pour renouveler la clé avant son expiration afin d’éviter les interruptions de service.
  • Dash utilise les champs d’application suivants pour synchroniser les données Jira de votre organisation :
    • read:jira-work et read:issue:jira → afficher les tickets 
    • read:project:jira → afficher les projets 
    • read:board-scope:jira-software → afficher les tableaux et les tickets dans les tableaux
    • read:me → obtenir le profil de l’utilisateur authentifié
    • read:user:jira, read:avatar:jira, read:group:jira → afficher les utilisateurs, leurs avatars et les groupes d’utilisateurs
    • read:application-role:jira → afficher les rôles et les détails de l’application
    • read:issue-security-level:jira, read:issue-security-scheme:jira, read:field:jira, read:project-role:jira, read:project-category:jira → obtenir des données d’autorisation pour les tickets avec un niveau de sécurité 
    • read:jira-user → afficher les utilisateurs, obtenir les données d’autorisation pour les tickets sans niveau de sécurité
    • offline_access → permet à Dash de vous aider lorsque vous êtes hors ligne

2. Connectez-vous à votre compte administrateur Atlassian pour générer un jeton API d’organisation dans le portail d’administration. Découvrez comment créer une clé API (sans champs d’applications).

  • Remarque : il est recommandé de définir l’expiration de la clé API à un an (maximum). Assurez-vous de définir un rappel pour renouveler la clé avant son expiration afin d’éviter les interruptions de service.

3. Ajoutez Jira à Dash.


Pour ajouter Jira à Dash :

  1. Connectez-vous à dash.ai avec vos identifiants d’administrateur.
  2. Cliquez sur votre avatar (votre photo de profil ou vos initiales) en bas à gauche.
  3. Sélectionnez Interface d’administration.
  4. Cliquez sur Dash dans la barre latérale de gauche.
  5. Cliquez sur Applications.
  6. Cliquez sur l’onglet Plus d’applications
  7. Cliquez sur Ajouter à droite de Jira.
  8. Cliquez sur Jeton API dans la fenêtre contextuelle, puis cliquez sur Démarrer.
  9. Vérifiez la fenêtre À quoi vous attendre, puis cliquez sur Démarrer.
  10. Saisissez le sous-domaine :
    •  Le sous-domaine est l’URL de votre site Confluence sans https:// (par exemple, exempleequipe1.atlassian.net).
  11. Saisissez la clé API générée dans la section ci-dessus.
  12. Saisissez l’adresse e-mail du compte de service que vous avez créé dans la section précédente.
  13. Saisissez la clé API de l’organisation générée dans la section précédente.
  14. Cliquez sur Suivant, puis sur Terminé.
highlighter icon

Remarques :

  • La synchronisation peut prendre quelques jours, selon la taille du contenu.
  • Les administrateurs reçoivent un e-mail lorsque la synchronisation est terminée.

Méthode 2 : méthode OAuth

Pour utiliser la méthode OAuth, attribuez le rôle d’administrateur de l’organisation au compte de service, puis ajoutez Jira à Dash.

Pour ajouter le rôle d’administrateur de l’organisation au compte de service :

  1. Connectez-vous à l’administration Atlassian en utilisant vos identifiants d’administrateur.
  2. Cliquez sur Répertoire > Utilisateurs.
  3. Recherchez le compte de service, puis sélectionnez son avatar ou Afficher les détails.
  4. Cliquez sur Plus d’actions () en haut de la page, puis sélectionnez Attribuer un rôle d’administrateur de l’organisation.
  5. Cliquez sur Attribuer le rôle pour confirmer.


Pour ajouter Jira à Dash à l’aide de la méthode OAuth :

highlighter icon

Remarque : déconnectez-vous de votre compte Jira individuel avant d’essayer les étapes ci-dessous afin d’ajouter Jira à Dash à l’aide du compte de service que vous avez créé.

  1. Connectez-vous à dash.ai avec vos identifiants d’administrateur.
  2. Cliquez sur votre avatar (votre photo de profil ou vos initiales) en bas à gauche.
  3. Sélectionnez Interface d’administration.
  4. Cliquez sur Dash dans la barre latérale de gauche.
  5. Cliquez sur Applications.
  6. Cliquez sur l’onglet Plus d’applications
  7. Cliquez sur Ajouter à droite de Jira.
  8. Cliquez sur OAuth dans la fenêtre contextuelle, puis cliquez sur Démarrer.
  9. Suivez les étapes de connexion Atlassian avec votre compte de service svc-dropboxdash-jira, puis cliquez sur Accepter
highlighter icon

Remarque : si vous avez besoin d’une authentification multifacteur (MFA) pour les comptes de votre environnement, il se peut que vous soyez invité à fournir une authentification supplémentaire associée au compte de service.

10. Cliquez sur Terminé.

11. Cliquez sur l’onglet Vos applications.

Vous devriez maintenant voir Jira.

Cet article vous a-t-il été utile ?

Expliquez-nous pourquoi cela ne vous a pas aidé :

Merci pour votre retour !

Merci d'avoir donné votre avis !

Autres options pour obtenir de l'aide