Disponible pour : Jira Cloud, Jira Server (sur site) et Datacenter (également protégé par LDAP)
Installation par : admin d'équipe Miro et admin système Jira avec les autorisations administratives du projet
✏️ La méthode d'authentification OAuth1.0 suivante ne sera plus prise en charge dans Miro à partir du 31 juillet 2025. OAuth1.0 est un protocole d'authentification déprécié dans Jira et ne devrait pas être utilisé. Ce changement fait partie d'une transition plus large vers OAuth2.0, qui est recommandée conformément aux meilleures pratiques en matière de sécurité. Il est conseillé aux utilisateurs de migrer vers OAuth2.0 pour garantir la continuité du support et la compatibilité avec les services de Miro.
Configuration de Miro sur Jira
⚠️ Si des problèmes techniques apparaissent, veuillez vous référer à notre article sur Possible issues and how to resolve them.
💡 En savoir plus sur les cartes Jira dans les articles FAQ sur les cartes Jira et Comment configurer un webhook pour les cartes Jira.
✏️ Notez que les menus de Jira peuvent varier en fonction de la version de Jira que vous utilisez, cependant, le flux général devrait être le même. Les instructions ci-dessous peuvent également être trouvées sur cette page d’aide d’Atlassian.
Étape 1 - Lien d’application
Commencez par créer un lien avec l’application et configurez-le.
- Accédez à Paramètres Jira > Produits > Intégrations > Liens d'application > Créer un lien
Notez que l'interface de Jira peut différer en fonction de votre version de Jira
- Choisissez lien direct de l’application et saisissez https://miro.com/ dans le champ URL de l’application.
Important : vous devez entrer l’URL dans ce format exact. Cliquez sur Continuer.
Créer le lien
- Dans le menu suivant, cliquez simplement sur Continuer à nouveau.
- Dans le menu Réviser le lien, vérifiez bien que l’URL est toujours exactement https://miro.com/ et saisissez le nom de l’application de votre choix. Faites défiler vers le bas, et en bas, cochez la case Créer un lien entrant. Ignorez le reste des champs et cliquez sur Continuer.
Seul le champ Nom de l'application doit être rempli.
- Vous verrez ici les champs pour les valeurs Miro. Pour obtenir les valeurs, connectez-vous à Miro.
- Pour l'intégration au niveau de l'équipe, allez dans Paramètres de l'équipe > Applications et intégrations > Cartes Jira.
- Pour une intégration au niveau de l'organisation, allez dans Paramètres de l'entreprise > Applications > Gérer les applications > Cartes Jira > Paramètres.
Si vous n’avez pas de cartes Jira dans votre liste d'applications, faites défiler jusqu'au haut de la section, cliquez sur Installer des applications et procédez à l'installation de l'application à partir du Marketplace de Miro. Une fois que vous voyez les cartes Jira sur la liste, cliquez pour les ouvrir.
L’onglet du plugin s’ouvrira et vous pourrez voir l’étape 1 pour obtenir les valeurs requises :Valeurs des cartes Jira
Copiez les valeurs et ajoutez-les au menu Réviser le lien d'Atlassian.
- Vous verrez le message de traitement pendant un instant ou deux :
La dernière étape de la création du lien
Et cela termine les étapes du côté Atlassian. Le lien apparaîtra dans la liste de vos liens d’application.
Étape 2 - Connexion
Retournez à vos paramètres de carte Jira dans Miro et choisissez l’une des deux options : créer un webhook manuellement ou automatiquement. Si vous choisissez manuellement, décochez l'option. Veuillez voir plus d'informations dans cet article. Nous vous recommandons vivement d’utiliser le webhook automatique pour ne pas avoir à le réinitialiser en cas de grosses mises à jour du plugin.
Enfin, saisissez votre URL Jira et cliquez sur Connecter :
Connexion des cartes Jira
Pour obtenir l’URL de Jira, copiez l’URL de base de votre instance Jira. Nous acceptons les formats suivants :
https://name.domain/
https://name.domain:port/
https://IPaddress/
https://IPaddress:port/
Si votre URL Jira n’est pas acceptée, veuillez vous référer à cet article. Veuillez également vérifier que Miro dispose d’un accès suffisant à votre Jira pour établir la connexion.
Vous avez maintenant connecté votre instance Jira à votre équipe Miro.
⚠️ Bien qu'Atlassian ait arrêté le support de Jira Server à partir de février 2024, Miro continuera de soutenir l'intégration des cartes Jira pour Jira Server dans un avenir prévisible.
- Allez à https://your-jira-server/plugins/servlet/applinks/listApplicationLinks. Si "Liens d'application" n'est pas sélectionné, cliquez dessus.
Liens d'application du serveur Jira
- Cliquez sur Créer un lien. Sélectionnez « produit Atlassian » et fournissez l'URL de l'application, "https://miro.com". Cliquez sur Continuer.
Configuration de l'URL de l'application
- Vous serez dirigé vers la boîte de dialogue "Lier des applications". Ajoutez un Nom d'application (par exemple, Miro Jira Card) et sélectionnez "Application Générique" pour le Type d'application.
Vous devriez voir l'URL de votre application Jira sous "Vous créez un lien depuis :", et vous devriez voir https://miro.com sous "Vers cette application :". Cliquez sur Continuer.Configurer les détails des applications de liaison
- La configuration du lien va être traitée. Lorsque cela se termine, vous verrez votre nouveau lien dans la zone "Liens d'application" de Jira Server.
Votre application configurée dans Jira Server
- Ensuite, vous devrez configurer les détails de votre application. Cliquez sur l’icône du crayon pour votre application afin de modifier les détails de l’application.
- Dans la boîte de dialogue Configurer, cliquez sur l'option Authentification entrante. Renseignez la clé du consommateur, le nom du consommateur, la clé publique et éventuellement une description.
- Pour l'intégration au niveau de l'équipe, cette information est disponible dans Paramètres de l'équipe > Applications et intégrations > Cartes Jira.
- Pour une intégration au niveau de l'organisation, cette information est disponible sur Paramètres de l'entreprise > Applications > Gérer les applications > Cartes Jira > Paramètres.
Configurer les détails d'authentification entrants dans Jira Server
Détails du lien application Jira dans Miro
- Faites défiler jusqu'à la fin des options d'authentification entrante et cliquez sur Enregistrer. Votre statut de vérification devrait maintenant être confirmé, et ce serveur Jira peut désormais être utilisé dans Miro avec des cartes Jira. Assurez-vous de choisir "Jira Server" et "OAuth 1.0" du côté Miro.
Autorisation de l’utilisateur
Une fois l'intégration connectée, chacun de vos utilisateurs finaux doit connecter son profil Jira personnel pour établir les autorisations appropriées - cela garantit que l'accès de chaque utilisateur du côté Miro est exactement le même que du côté de votre instance Jira. Lorsque les utilisateurs finaux essaient d’importer ou de modifier une carte Jira pour la première fois, il leur sera demandé de se connecter à Jira à l’aide de leurs identifiants individuels.
Une fois cela fait, les utilisateurs peuvent ajouter des tâches sous forme de cartes sur le tableau blanc. Toute modification apportée dans Jira est répercutée dans les cartes Jira sur le tableau.
✏️ Si un utilisateur n'a pas d'identifiants Jira et qu'il a accès au tableau sur lequel la carte a été ajoutée, il verra le titre de la carte, le type de ticket, la priorité, l'assigné et tous les attributs configurés pour s'afficher sur la carte Jira. Cependant, ils ne pourront pas développer la carte pour voir les autres attributs et la modifier à moins d’en avoir l’autorisation. Si l'utilisateur ne se connecte pas avec ses identifiants Jira, il ne verra pas l'avatar de l'assigné et l'aspect général de la carte sera différent.
Utilisation d'une instance Jira pour plusieurs équipes Miro
Vous pouvez installer des cartes au niveau de l’équipe ou au niveau de l'organisation. Si vous avez plusieurs équipes, vous pouvez tirer parti des paramètres au niveau de l'organisation pour éviter de répéter la procédure de configuration pour chaque équipe. Le lien d'application existant est utilisé pour toutes les équipes.
Une fois que vous connectez votre équipe ou organisation à une instance Jira, un nouveau WebHook est créé dans vos WebHooks Jira pour cette équipe ou organisation Miro. Créer un WebHook établit un canal pour les demandes de mise à jour.
Si vous spécifiez des paramètres au niveau de l'organisation, les équipes déjà connectées conservent leurs paramètres actuels. Cependant, ils peuvent passer aux paramètres du niveau organisationnel à tout moment.
De plus, si nécessaire, les équipes peuvent contourner les paramètres au niveau de l'organisation afin de se connecter à une instance Jira différente.
Si vous êtes un client Enterprise qui souhaite migrer plusieurs connexions au niveau de l'équipe vers la connexion par défaut au niveau de l'organisation, contactez l'équipe chargée de votre compte.
⚠️ Si vous voulez connecter plusieurs équipes séparément, nous vous recommandons de donner à chaque webhook un nom unique. Allez sur votre page Jira WebHooks et modifiez chaque webhook nouvellement créé.
La connexion de plusieurs instances Jira à une seule équipe Miro n’est pas prise en charge.
Désactiver le plugin
Pour l'intégration au niveau de l'équipe, allez dans Paramètres de l’équipe > Applications et intégrations > Cartes Jira. Puis sélectionnez Supprimer pour l’équipe.
Pour une intégration au niveau de l'organisation, afin de restreindre l'utilisation de l'application Jira, allez dans Paramètres de l'entreprise > Applications > Gérer les applications > Cartes Jira. Ensuite, déplacez le commutateur en position d'arrêt.
⚠️ Si vous désactivez Jira pour l'organisation, alors les utilisateurs de toutes les équipes Enterprise ne pourront pas utiliser les cartes Jira. Pour en savoir plus sur la gestion et la restriction des applications, consultez Gestion des applications.
Plus d'informations : Voir Comment utiliser les cartes Jira.