FAQ sur les cartes Jira

Comment l’authentification Jira-Miro fonctionne-t-elle ?

Consultez les articles du Centre d’assistance pour

• Jira Server sur site
  • OAuth 2.0
  • (par un tiers) OAuth 2.0
• Jira Data Center sur site
  • OAuth 2.0
  • (par un tiers) OAuth 2.0
• Jira Cloud
  Sélectionnez depuis la page des paramètres des cartes Jira.
  • OAuth 2.0 (3LO)

Les données sont-elles sécurisées lorsqu’elles transitent entre Jira et Miro ?

Nous utilisons le protocole de sécurité TLS. Il crypte les messages HTTP avant leur transmission et décode les messages à leur arrivée. Nous prenons également en charge le TLS mutuel dans le forfait Enterprise.

Prenez-vous en charge le TLS mutuel ?

Oui, apprenez-en plus.

Miro conservera-t-il les données clients de Jira ?

Oui, Miro conserve les données des cartes Jira qui sont ajoutées au tableau.

Quelle est la durée de conservation et comment les données seront-elles protégées ?

Pour OAuth 1.0. (Jira Server ou Data Center) en outre, les données sont mises à jour si les webhooks sont paramétrés pendant la configuration du plugin des cartes Jira. La période de conservation des données est illimitée. Seuls les protocoles de sécurité généraux de Miro sont appliqués.

Peut-on restreindre les informations récupérées depuis Miro ?

Nous n’avons trouvé aucune mention dans documentation d’Atlassian expliquant comment limiter les informations à quelques champs seulement.

Pouvons-nous avoir un diagramme présentant le flux de données entre Jira et Miro ?

Des informations détaillées se trouvent dans cet article de Jira Developers. Nous mettons en œuvre notre intégration conformément à la documentation d’Atlassian.

Comment le jeton est-il géré ?

OAuth 1.0 : seul le jeton d’accès est utilisé. Le jeton d’accès est conservé pendant 5 ans, sauf s’il est révoqué (aucune option de personnalisation, cette politique étant définie par Atlassian. Vous pouvez révoquer le jeton du côté de Jira à partir de l’interface utilisateur Web). N’oubliez pas que chaque nouveau jeton empêche l’intégration de fonctionner et nécessite de relancer la connexion.

OAuth 2.0 : le jeton d’accès dure 1 heure. Le jeton de rafraîchissement dure 90 jours (si vous passez 90 jours sans utiliser l’intégration, vous devrez vous réauthentifier).

Un seul jeton d’accès est-il utilisé pour l’ensemble des accès du client à Jira ?

Chaque utilisateur Miro qui souhaite importer, créer ou modifier des cartes Jira doit se connecter avec ses propres identifiants Jira. Toutes les actions citées ci-dessus ne peuvent être accomplies que pour le compte d’identifiants Jira individuels.

Comment les jetons de requêtes, les jetons d’accès, les clés privées et les autres secrets/identifiants OAuth sont-ils sécurisés ?

Au cours de l’intégration, seuls les jetons d’accès sont utilisés. Ils sont stockés de manière sécurisée dans la base de données et ne sont utilisés que du côté du serveur.

Pour OAuth 1.0 (Jira Server et Data Center), l’authToken n’est utilisé que pour le webhook. Il ne s’agit pas du jeton d’authentification utilisé par OAuth. Les requêtes sont envoyées par l’intermédiaire d’une connexion cryptée. La clé secrète est générée automatiquement et est associée par équipe.

Quels points d’extrémité votre intégration utilise-t-elle ?

POST /rest/api/2/issue - create new issue

PUT /rest/api/2/issue/id - update issue

GET /rest/api/2/user/picker?query=xx

GET /rest/api/2/myself

GET /rest/api/2/filter/favourite

GET /rest/api/2/issue/picker

GET /rest/api/2/serverInfo

GET /rest/api/2/issue/$key

GET /rest/api/2/issue/createmeta

GET /rest/api/2/issue/$key/editmeta

GET /rest/api/2/priority

GET /rest/api/2/issuetype

GET /rest/api/2/mypermissions

Pour OAuth 1.0. (Jira Server et Data Center), nous utilisons en plus :

POST /rest/webhooks/1.0/webhook

Les cartes fonctionneront-elles avec Jira Data Center ?

Oui. Nous sommes approuvés par Atlassian et de nombreux clients utilisent déjà avec succès les cartes Jira avec Data Center. La procédure d’installation est la même.

Quelles adresses IP utilisez-vous pour communiquer avec le système Jira ?

La liste de nos adresses IP statiques se trouve ici.

Notez que ces adresses ne sont utilisées que pour communiquer avec le système Jira. Les adresses IP de l’application Miro sont dynamiques, et pour garantir le bon fonctionnement de toutes les fonctionnalités des tableaux de Miro (dont certaines liées aux cartes Jira), nous vous demandons d’ajouter nos domaines à votre liste d’autorisations.

Pouvons-nous intégrer Jira à Miro, mais bloquer les tickets Jira dont le niveau de sécurité est défini sur « Privé » ?

Non, ce n’est pas possible. Les niveaux de sécurité de Jira ne correspondent pas à ceux de Miro.

Pouvons-nous connecter Miro à Jira si nous utilisons un serveur Jira ?

Miro est un outil en ligne. Vous ne pouvez configurer l’intégration que si votre instance Jira est ouverte à l’Internet public.

Pouvons-nous connecter plusieurs instances Jira en même temps ?

Oui. Cependant, gardez à l’esprit que connecter une instance Jira consiste à établir le lien initial, tandis qu’une connexion active désigne l’instance liée actuellement utilisée. Une connexion active définit d’où les Cartes Jira sont importées lorsque vous ouvrez l’application Cartes Jira, et pour quelle instance les utilisateurs sont autorisés. Pour un utilisateur donné, il ne peut y avoir qu’une (1) connexion active à la fois. Avec OAuth 2.0, un utilisateur peut modifier n’importe quelle carte Jira associée à une instance liée pour laquelle il est déjà authentifié. Pour tout autre protocole d’authentification, une équipe entière partage une instance active et ne peut importer ni interagir qu’avec les cartes de cette instance. Vous pouvez définir plusieurs paramètres au niveau de l’organisation et basculer entre les connexions actives au niveau de l’équipe.

Quel est le processus de migration de Server vers Cloud  ?

Comme votre URL de base Jira changera inévitablement lors de la migration vers Cloud, l’intégration cessera de fonctionner sans modification de notre côté. Veuillez contacter le service d’assistance Miro pour obtenir de l’aide.

Miro créera-t-il un webhook par équipe, par projet ou par instance Miro ?

Si vous activez Webhook automatique dans vos paramètres Miro, la création de webhooks se fait automatiquement. Si vous utilisez l’autorisation au niveau de l’équipe avec Jira, Miro crée des webhooks par équipe. Si vous utilisez l’autorisation au niveau de l’organisation, Miro crée des webhooks par organisation.

Le plugin des cartes Jira prend-il en charge les projets nouvelle génération ?

Oui.

Notez que pour l’instant, aucun lien ou champ Epic n’est disponible lors de la création d’une carte Jira pour un projet nouvelle génération du côté de Miro.

Les champs personnalisés de Jira sont-ils pris en charge ?

Oui, nous prenons en charge presque tous les champs personnalisés des types de base. Si vous avez un champ de type de données complexe, il pourrait ne pas être pris en charge et provoquer un comportement inattendu lors de la mise à jour ou de la création de cartes Jira sur le tableau.

Que se passera-t-il avec les cartes Jira existantes si nous basculons sur une autre instance Jira ?

Actuellement, lorsque vous déplacez des tickets Jira d’un projet à un autre dans Jira, ils ne sont plus mis à jour du côté de Miro.

Pour contourner ce problème, nous vous suggérons de copier l’URL d’un ticket Jira (Ctrl/Cmd+C) et de la coller sur un tableau Miro (Ctrl/Cmd+V). Ainsi, une carte Jira affichera les nouvelles valeurs et sera mise à jour automatiquement.

Si un tableau est déplacé vers une autre équipe Miro, qu’adviendra-t-il des cartes Jira présentes sur ce tableau ?

Les cartes Jira resteront sur le tableau, mais personne ne pourra les modifier (même si la même instance Jira est configurée pour l’équipe cible).

En cliquant sur une carte, vous verrez un message : "La carte Jira a été importée d’un autre compte". Si vous souhaitez rendre les cartes modifiables, importez-les à nouveau sur le tableau.

Y a-t-il des frais supplémentaires pour l’intégration des cartes Jira ?

Les cartes Jira sont disponibles sur tous les forfaits payants et sur le forfait Education sans frais supplémentaires (Starter, Business, Education et Enterprise).

Un utilisateur peut-il accéder à toutes les cartes Jira du tableau ?

Les autorisations relatives à l’intégration des cartes Jira garantissent que les utilisateurs ne peuvent créer et modifier des cartes que dans les projets Jira auxquels ils ont accès.

Tous les widgets d’un tableau Miro sont visibles par tous les utilisateurs qui ont accès à ce tableau. Ainsi, si une personne ne dispose pas d’identifiants Jira ou des bons identifiants, elle verra la carte Jira réduite sur le tableau Miro (son titre ainsi que quelques autres champs), mais elle ne pourra pas développer la carte pour en consulter le contenu complet ou pour la modifier.

Atlassian a-t-il mis fin au support de Jira Server ?

Oui. Atlassian a mis fin au support de Jira Server à compter de février 2024.

Miro Planification/cartes Jira prend-il en charge les champs personnalisés Jira : types de ticket personnalisés et dépendances personnalisées ?

Oui, les deux sont pris en charge. Si les champs Types de ticket personnalisés et Dépendances personnalisées sont configurés dans Jira, et si Miro Planification est authentifié pour cette instance Jira, alors ces champs personnalisés sont disponibles dans Miro Planification.

Miro prend-il en charge OAuth 2.0 pour Jira Data Center ?

Oui. Voir Se connecter à Jira Data Center à l’aide d’OAuth 2.0.

Comment importer des tickets Jira dans les Tables et le Planning ?

Vous pouvez glisser-déposer une ou plusieurs cartes Jira directement dans une Table ou dans le Planning. C’est actuellement la seule façon de procéder.

Quels champs de la Table sont liés à Jira ?

Champs système Jira :

• Titre
• Description
• Date de fin (Date d’échéance dans Jira)
• Responsable
• Statut

Champs Jira personnalisés : - Tout champ personnalisé que vous ajoutez via Ajouter des champs Jira, ainsi que les champs automatiquement mappés suivants : Date de début, Estimation. Pour ajouter des champs personnalisés à une Table, cliquez sur le bouton plus (+) en haut de la Table et sélectionnez Ajouter des champs Jira. Ensuite, choisissez le champ personnalisé que vous souhaitez synchroniser.

Quels champs de la table ne se synchronisent pas avec Jira ?

Cliquez sur une cellule pour voir quels champs se synchronisent avec Jira. Tout champ synchronisé est repéré par le logo Jira. Tous les autres champs sont stockés uniquement dans Miro et ne sont pas synchronisés avec Jira.

Pourquoi ne puis‑je pas modifier un champ de la table ou du Planning parmi les cinq champs Jira pris en charge ci‑dessus ?

Il se peut que le champ n’apparaisse pas dans l’écran de modification sur Jira.

Un moyen simple pour vérifier si le champ apparaît dans l’écran de modification :

Dans Miro, ouvrez le panneau latéral de la carte Jira. Vérifiez si le champ figure dans ce panneau. Si le champ n’y figure pas, vous devez ajouter le champ à l’écran de modification sur Jira.

Il existe quelques cas rares où les champs sont modifiables dans Jira mais n’apparaissent pas dans l’écran de modification de Jira. Dans ce cas, ces champs ne peuvent pas être modifiés depuis Miro.

Le champ que vous ne pouvez pas modifier est‑il Start date ou Estimate ? Si oui :

Le champ peut ne pas être présent dans Jira ou manquer à l’écran d’édition (voir point précédent)

Il peut y avoir un problème de cartographie pour la Date de début ou l’Estimation car il s’agit de champs Jira personnalisés.

Nous cartographions ces champs selon la logique suivante :

• Date de début : Nous vérifions les champs nommés : Start Date, StartDate, Target Start
• Estimation : Nous vérifions les champs nommés : Story Points, Story point estimate, Story Point, StoryPoints, StoryPoint
• Si le champ Date de début ou Estimation ne porte pas l’un des noms ci‑dessus, cela peut expliquer pourquoi la modification ne fonctionne pas.

Pourquoi la modification de la Date de début ou de l’Estimation dans la Table ou le Planning Miro ne fonctionne‑t‑elle pas ou met‑elle à jour le mauvais champ dans Jira ?

Nous nous appuyons actuellement sur une cartographie automatique des champs Start Date et Estimate dans Jira. Comme ces champs sont personnalisés dans Jira, il se peut qu’il existe plusieurs champs dans votre configuration Jira correspondant aux critères mentionnés ci‑dessus.

Nous sélectionnons la première correspondance selon l’ordre des noms de champs indiqué ci‑dessus :

Par exemple, si un ticket Jira comporte à la fois les champs Story Points et Story point estimate, nous associons en priorité celui qui apparaît en premier dans la liste ci‑dessus, à savoir Story Points. Par conséquent, toute modification du champ Estimate dans la Table mettra à jour le champ Story Points dans Jira, et non le champ Story point estimate.

Pour l’instant, il n’existe pas de solution de contournement pour cela. Si vous rencontrez ce problème, envoyez des retours à votre service d’assistance afin que nous puissions mieux comprendre vos besoins lors du développement de fonctionnalités de cartographie des champs plus avancées.

Pourquoi ne puis‑je pas importer des cartes Jira provenant de deux instances différentes dans une Table ou un Planning ?

Nous ne prenons actuellement en charge qu’une seule instance Jira par table/Planning. Une fois qu’une carte Jira est importée dans une table/Planning, celle-ci est liée à cette instance Jira spécifique.

Même si tous les enregistrements Jira sont supprimés, le lien vers l’instance Jira d’origine reste. Pour importer des cartes depuis une autre instance Jira, vous devez créer une nouvelle table/Planning.

Pourquoi ne puis-je pas voir ou modifier les champs État et Responsable de mes enregistrements Jira dans une table ou dans le Planning ?

Actuellement, les champs État et Responsable de Jira ne sont pas pris en charge dans les tables et dans le Planning. Nous avons décidé de désactiver ces champs dans les tables et dans le Planning pour gérer les attentes, éviter toute confusion et prévenir toute perte de données. Les champs État et Responsable de Jira et leur contenu existent, mais ils n’apparaissent pas dans les tables ni dans le Planning.

Vous pouvez toujours modifier ces champs directement dans les cartes Jira via le panneau latéral. Il suffit de faire glisser la ligne depuis la table ou le Planning sur le canevas pour faire réapparaître votre carte Jira.