Commencer avec l'intégration Jira

Configurer l'intégration Jira est rapide et facile. Ce document vous guidera à travers la configuration nécessaire qui permettra à votre organisation entière de profiter de cette puissante intégration.

Connexion à Jira Cloud

Pour commencer, une connexion authentifiée à votre instance Jira doit être établie par un Administrateur du Portail de Compte axe. Cette connexion sera utilisée dans toute votre organisation, il est donc important que l'utilisateur qui établit la connexion ait accès à chaque projet auquel vous souhaitez envoyer des problèmes.

1. Accédez à la page « CONFIGURATION » dans le Portail de Compte axe
2. Cliquez sur le lien « Intégrations » dans la navigation « Configuration »
3. Cliquez sur le bouton « Ajouter une nouvelle connexion à Jira Cloud »
4. Une nouvelle fenêtre contextuelle (consentement OAuth) sera lancée dans laquelle vous serez invité à vous connecter (si vous avez déjà une session Jira active, cette étape sera ignorée)
5. Une fois authentifié avec Jira, il vous sera demandé de choisir une instance Jira à connecter dans la liste déroulante « Utiliser l'application sur »
6. Cliquez sur « Accepter » une fois que vous avez choisi une instance Jira
7. La fenêtre contextuelle se fermera et une boîte de dialogue de confirmation sera affichée
8. Confirmez l'instance Jira à laquelle vous souhaitez vous connecter dans le menu déroulant
9. Cliquez sur « Terminer »
10. Un message « Connecté avec succès à Jira » apparaîtra une fois connecté

Connexion à Jira Data Center

1. Accédez à la page « CONFIGURATION » dans le Portail de Compte axe
2. Cliquez sur le lien « Intégrations » dans la navigation « Configuration »
3. Cliquez sur le bouton « Ajouter une nouvelle connexion à Jira Data Center »
4. Cliquez sur le bouton « Configurer les paramètres » (sous le texte « Connexion non configurée »)
5. Fournissez votre URL de Jira Data Center (par exemple https://jira.mycompany.com)
6. Fournissez votre clé de consommateur (doit correspondre à ce que vous saisissez dans Jira).
7. Dans Jira Data Center...
   • Cliquez sur le bouton « Paramètres » (icône d'engrenage en haut à droite de la page)
   • Cliquez sur le lien « Applications »
   • Cliquez sur le lien « Liens d'application »
   • Entrez https://www.deque.com comme URL dans le champ de saisie de texte
   • Cliquez sur le bouton « Créer un nouveau lien »
   • Cliquez sur le bouton « Continuer »
     • Si vous voyez un avertissement similaire à « Aucune réponse n'a été reçue de l'URL que vous avez saisie » ou concernant les redirections, vous pouvez l'ignorer en toute sécurité. L'URL elle-même n'est pas utilisée pour une validation quelconque ; c'est simplement un champ requis pour que la connexion soit correctement configurée
   • Fournissez un Nom d'application (par exemple « Intégration Deque Jira » ; vous devrez fournir cette même valeur dans la page des paramètres de Jira Data Center)
   • Cochez la case « Créer un lien entrant »
   • Cliquez sur le bouton « Continuer »
   • Entrez une valeur dans le champ Clé Consommateur (par exemple « DequeOAuthKey »)
   • Entrez une valeur dans le champ Nom du consommateur champ (par exemple, « Deque Jira Integration »)
   • Entrez la clé publique affichée dans la page « Paramètres du centre de données Jira » dans le Champ Clé Publique
8. De retour sur la page des paramètres du centre de données Jira dans le Portail de Compte axe...
   • entrez la même Clé Consommateur que celle saisie dans le centre de données Jira
   • Cliquez sur le bouton « Enregistrer »
   • Cliquez sur le bouton « Connecter à l'intégration »
   • Dans la fenêtre contextuelle, connectez-vous au centre de données si ce n'est pas déjà fait
   • Cliquez sur « Autoriser »
   • Fermez la fenêtre

Prérequis pour la connexion Jira Cloud depuis l'instance Deque sur site

Enregistrer l'application cliente Jira

1. Accédez à https://developer.atlassian.com/console/myapps/
2. Cliquez sur le bouton « Créer » et choisissez l'intégration « OAuth 2.0 »
3. Fournissez un nom (par exemple, « Acme Corp - axe sur site - Intégration Jira Cloud »)
4. Cochez la case Je m'engage à respecter les conditions d'utilisation des développeurs d'Atlassian et cliquez sur le bouton « Créer »
5. Dans l'onglet « Distribution », cliquez sur « Modifier » et sélectionnez « Partage » pour le « Statut de Distribution »
   • Définissez « Nom du fournisseur » sur « Deque »
   • Définissez « Politique de confidentialité » sur «https://www.deque.com/privacy-policy/»
   • Définissez « Votre application stocke-t-elle des données personnelles ? » sur « Non »
   • Enregistrez les modifications
6. Dans l'onglet « Permissions », cliquez sur le bouton « Ajouter » (à côté de « Jira API »)
7. Une fois qu'il est prêt à être configuré (patientez un moment), le bouton « Ajouter » sera remplacé par un nouveau bouton « Configurer »
   • Si le bouton « Configurer » n'apparaît pas, essayez de recharger la page
8. Cliquez sur « Configurer »
9. Cliquez sur « Modifier les portées »
   • cochez les cases suivantes : « read:jira-work », « read:jira-user », « write:jira-work » et « manage:jira-webhook »
10. Dans l'onglet « Autorisation », cliquez sur le bouton « Ajouter »
11. Définissez « URL de rappel » sur «https://axe.deque.com/jira-direct/connected»
12. Cliquez sur le bouton « Enregistrer les modifications »
13. Téléchargez cette image (clic droit > enregistrer l'image sous) :
14. Dans l'onglet « Paramètres », cliquez sur « Changer d'avatar » et sélectionnez le logo axe que vous venez d'enregistrer
15. Dans la section « Détails d'authentification », enregistrez l'« ID Client » et le « Secret » car ils sont utilisés dans le cadre de votre installation sur site
16. Une fois votre installation Deque sur site terminée, suivez les étapes ci-dessus pour établir la connexion au cloud Jira

Déconnexion d'une connexion active

Cliquer sur « Déconnecter de Jira » invalidera la session d’authentification active précédemment établie avec Jira. De plus, les utilisateurs ne pourront plus envoyer de problèmes à l'instance Jira qui a été déconnectée.

Pour reconnecter une connexion déconnectée, cliquez sur le bouton « Connecter à Jira » qui vous guidera à travers les étapes de connexion à nouveau.

Suppression d'une connexion

Une fois qu'une connexion a été déconnectée, vous pouvez la supprimer en cliquant sur « Supprimer la connexion Jira ».

Modèles

Une fois qu'une connexion a été établie, des modèles peuvent être créés pour standardiser la façon dont les problèmes axe sont associés aux champs Jira. Les modèles aident à garantir une création cohérente des problèmes au sein de votre organisation.

Pour des informations détaillées sur la création, la gestion et l'utilisation des modèles, consultez notre documentation des modèles.

Envoi de problèmes à Jira

Une fois que vous avez établi une connexion Jira et créé des modèles, vous pouvez commencer à envoyer des problèmes axe à Jira. Le processus vous permet d'envoyer des problèmes individuels ou des groupes de problèmes pour créer des tickets Jira.

• Envoi de problèmes à partir de l'extension axe DevTools vers Jira
• Envoi de problèmes à partir d'axe Monitor vers Jira
• Envoi de problèmes à partir d'Axe Developer Hub vers Jira