FAQ sur les cartes Jira – Centre d'aide de Miro

Cet article répond aux questions les plus fréquentes sur le fonctionnement de notre intégration des cartes Jira.

Apprenez-en plus en lisant ces autres articles sur les cartes Jira :

Question	Réponse
Sécurité
Comment l’authentification Jira-Miro fonctionne-t-elle ?	Le protocole utilisé est : OAuth 1.0 pour Jira Server (sur site) OAuth 1.0 pour Jira Data Center (sur site) OAuth 1.0 ou OAuth 2.0 pour Jira Cloud (3LO) (peut être sélectionné dans la page des paramètres des cartes Jira)
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 les forfaits Enterprise.
Prenez-vous en charge le TLS mutuel ?	Oui, apprenez-en plus ici.
Miro conservera-t-il les données clients de Jira ? Si oui, pendant combien de temps ces données sont-elles conservées et quelles mesures Miro prend-il pour les protéger ?	Oui, Miro conserve les données des cartes Jira qui sont ajoutées au tableau. 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.
Existe-t-il un moyen de restreindre les informations qui peuvent être extraites à partir de Miro ? Supposons que nous ne voulons voir que le titre et le statut d’une carte, pouvons-nous empêcher les utilisateurs de Miro de voir les autres champs, la description ou les pièces jointes par exemple ?	Nous n’avons trouvé aucune mention dans la documentation d’Atlassian expliquant comment limiter le partage des informations à certains champs seulement.
Pouvons-nous consulter un diagramme présentant le flux de données entre Jira et Miro, par exemple lors de l’authentification, d’une utilisation normale, etc. ?	Vous trouverez des informations détaillées dans cet article de Jira Developers (uniquement disponible en anglais). 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 du côté d’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 rafraichissement dure 90 jours (si vous passez 90 jours sans utiliser l’intégration, vous devrez vous ré-authentifier).
Un jeton d’accès unique est-il utilisé pour l’ensemble des accès clients à Jira ou des jetons séparés sont-ils utilisés individuellement pour chaque utilisateur ?	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 de terminaison 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 une grande partie de notre clientèle utilise 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 qu’il ne s’agit que des adresses utilisées pour communiquer avec le système Jira. Les adresses IP de l’application Miro sont dynamiques, et pour garantir l’efficacité des fonctionnalités des tableaux de Miro (dont certaines concernent les cartes Jira), nous vous demandons d’ajouter nos domaines à votre liste d’autorisations.
Pouvons-nous intégrer Jira à Miro, mais bloquer dans Miro 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 à Miro.
Général
Pouvons-nous connecter Miro à Jira si nous utilisons un serveur Jira fermé aux réseaux extérieurs ou une instance Jira disponible uniquement localement ?	Miro est un outil en ligne. Vous ne pouvez configurer l’intégration que si votre Jira est ouvert à l’Internet public. Il n’y a aucune solution alternative pour ce cas de figure.
Pouvons-nous connecter plusieurs instances Jira à une équipe Miro ?	Pour OAuth 1.0 (Jira Server et Data Center), non, il n’est possible de connecter qu’une instance Jira par équipe. Pour OAuth 2.0, oui, vous pouvez connecter des instances supplémentaires à partir de la page de vos paramètres d’intégration Jira et passer de l’une à l’autre.
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 si elle n’est pas modifiée de notre côté. Contactez 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 ?	Applicable à OAuth 1.0 (Jira Server et Data Center) uniquement : Oui, la création d’un webhook se fait automatiquement si vous utilisez l’option de webhook automatique dans les paramètres de Miro. Un webhook est créé lors de l’autorisation de l’équipe avec Jira. Les webhooks sont donc créés par équipe.
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 complexes, 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 ?	Si vous désactivez la connexion de votre instance Jira, les cartes liées à cette instance resteront sur les tableaux Miro (pas de perte de données), mais elles ne seront plus mises à jour.
Que se passera-t-il avec les cartes Jira existantes si nous les transférons d’un projet à un autre du côté de 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 le 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). Si vous cliquez sur une carte, vous verrez le message suivant : « 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 à prévoir pour l’intégration des cartes Jira ?	Les cartes Jira sont disponibles avec tous les forfaits payants et Education sans frais supplémentaires (forfaits Starter, Business, Education et Enterprise).
Si un utilisateur se rend sur un tableau Miro et se connecte à Jira, aura-t-il accès à tous les détails des cartes Jira figurant sur le tableau ou uniquement aux détails auxquels il a accès conformément aux autorisations dont il dispose sur son compte Jira ?	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 Jira, 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.

Articles dans cette section

Sécurité

Général

Articles associés