Disponible pour : Jira Cloud, Jira Server (sur site) et Datacenter (également protégé par LDAP)
Installation par : Le responsable d’équipe de Miro et l’administrateur système Jira avec des autorisations administratives du projet
✏️ La méthode d'authentification OAuth1.0 suivante ne sera plus prise en charge dans Miro à partir du 1er juillet 2025. OAuth1.0 est un protocole d'authentification obsolète dans Jira et ne doit pas être utilisé. Ce changement fait partie d'une transition plus large vers OAuth2.0, recommandée conformément aux meilleures pratiques de sécurité. Nous conseillons 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 les problèmes éventuels et comment les résoudre.
💡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 être différents 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 dans l'aide d'Atlassian.
Étape 1 - Lien d’application
Commencez par créer un lien avec l'application et configurez-le.
- Rendez-vous dans Paramètres Jira > Produits > Intégrations > Liens d'application > Créer un lien</strong>:
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 la page 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, accédez à Paramètres de l'entreprise > Applications > Gérer les applications > Cartes Jira > Paramètres.
Si vous n'avez pas les cartes Jira dans votre liste d'applications, faites défiler vers le 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 dans la liste, cliquez pour les ouvrir.
L’onglet du plugin s’ouvrira et vous pouvez voir l'Étape 1 pour obtenir les valeurs requises :Valeurs des cartes Jira
Copiez les valeurs et ajoutez-les au menu Atlassian Lien de révision.
- Vous verrez le message de traitement pendant un instant ou deux :
La dernière étape de la création du lien
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. Pour plus d’informations, consultez 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, veuillez copier l’URL de base de votre instance Jira. Nous prenons en charge les formats suivants :
https://name.domain/
https://name.domain:port/
https://IPaddress/
https://IPaddress:port/
Si votre URL Jira n’est pas acceptée, référez-vous à 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 cessé de prendre en charge Jira Server à partir de février 2024, Miro continuera de prendre en charge l'intégration des cartes Jira pour Jira Server pour l'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 "Atlassian product" 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 de l'application (par exemple, Miro Jira Card) et sélectionnez "Application générique" pour le Type d'application.
Vous devriez voir votre URL de l'application Jira sous "Vous créez un lien de :", et vous devriez voir https://miro.com sous "Vers cette application:". Cliquez sur Continuer.Configuration des détails des applications de Liaison
- La configuration du lien sera traitée. Lorsque ce sera terminé, 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 de votre application pour modifier les détails de l’application.
- Dans la boîte de dialogue Configurer, cliquez sur l’option Authentification entrante. Remplissez les champs Clé du consommateur, Nom du consommateur, Clé publique et éventuellement une description.
- Pour l'intégration au niveau de l'équipe, ces informations sont disponibles dans Paramètres de l'équipe > Applications et intégrations > Cartes Jira.
- Pour l'intégration au niveau de l'organisation, ces informations sont disponibles dans 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 d'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 les cartes Jira. Veillez à choisir "Jira Server" et "OAuth 1.0" du côté de 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 problème, 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 ni 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 du destinataire et l'aspect général de la carte sera différent.
Utiliser une instance Jira pour plusieurs équipes Miro
Vous pouvez installer les cartes au niveau de l'équipe ou 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.
Après avoir connecté 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 au niveau de l'organisation à tout moment.
De plus, si nécessaire, les équipes peuvent outrepasser les paramètres définis au niveau de l'organisation pour se connecter à une autre instance Jira.
Si vous êtes client Enterprise et que vous souhaitez 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 souhaitez 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. Sélectionnez ensuite Supprimer pour l’équipe.
Pour l'intégration au niveau de l'organisation, pour restreindre l'utilisation de l'application Jira, allez dans Paramètres d'entreprise > Applications > Gérer les applications > Cartes Jira. Ensuite, déplacez le commutateur vers la position éteinte.
⚠️ Si vous désactivez Jira pour l'organisation, 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.