Cet article répond aux questions les plus fréquentes sur le fonctionnement de notre intégration des cartes Jira.
Comment l’authentification Jira-Miro fonctionne-t-elle ?
Consultez les articles du Centre d’assistance pour
- Jira Server sur site
- Jira Data Center sur site
-
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 pour le forfait Enterprise.
Prenez-vous en charge le TLS mutuel ?
Oui, en savoir plus.
Miro conservera-t-il des données de Jira de ses clients ?
Oui, Miro conserve les données des cartes qui sont ajoutées au tableau.
Quelle est la durée de conservation et comment les données seront-elles sécurisé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.
Pouvons-nous restreindre les informations récupérées de Miro ?
Nous n’avons trouvé aucune mention dans la documentation d’Atlassian expliquant comment limiter le partage des informations à certains champs seulement.
Pouvons-nous avoir un diagramme montrant le flux de données entre Jira et Miro ?
Des informations détaillées se trouvent dans cet article pour les développeurs Jira. 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 rafraîchissement 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 ?
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 - créer un nouveau ticket
PUT /rest/api/2/issue/id - mettre à jour un ticket
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à les cartes Jira avec Datacenter avec succès. 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 peut être trouvée ici.
Notez que ces adresses ne sont utilisées que pour communiquer avec le système Jira. Les adresses IP de Miro sont dynamiques et pour garantir le fonctionnement optimal 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 une option. Les niveaux de sécurité de Jira ne correspondent pas à ceux de Miro.
Pouvons-nous connecter Miro à Jira si nous utilisons un serveur Jira ?
Étant donné que Miro est un outil en ligne, vous pouvez seulement vous connecter à Jira lorsque votre instance est accessible sur l’Internet public.
Pouvons-nous connecter plusieurs instances Jira en même temps ?
Oui. Toutefois, gardez à l’esprit que connecter une instance Jira consiste à établir le lien initial, tandis qu’une connexion active fait référence à l’instance liée actuellement en cours d’utilisation. Une connexion active détermine d’où les cartes Jira sont importées lorsque vous ouvrez l’application Jira Cards, 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 à n’importe quelle 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 peut uniquement importer et interagir 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 le webhook automatique dans vos paramètres Miro, la création de webhooks se fera automatiquement. Si vous utilisez une autorisation au niveau de l’équipe avec Jira, alors Miro crée des webhooks par équipe. Si vous utilisez une autorisation au niveau de l’organisation, alors 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 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 ?
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 de 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 depuis 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 sur tous les plans payants et Education sans frais supplémentaires (plans Starter, Business, Education et Enterprise).
Un utilisateur peut-il accéder à toutes les cartes Jira sur le 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 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.
Atlassian a-t-il cessé le support pour Jira Server ?
Oui, Atlassian a cessé le support pour Jira Server depuis février 2024.
Miro Planification/Cartes Jira supporte-t-il les champs personnalisés de Jira : Types de ticket personnalisés et Dépendances personnalisées ?
Oui, les deux sont supportés. Si les champs Types de ticket personnalisés et Dépendances personnalisées sont configurés dans Jira et que Miro Planification est authentifié pour cette instance de Jira, alors ces champs personnalisés sont disponibles dans le planificateur.
Miro supporte-t-il OAuth 2.0 pour Jira Data Center ?
Oui. Voir Connecter à Jira Data Center en utilisant OAuth 2.0.
Comment puis-je 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 un Planning. C’est actuellement la seule façon de le faire.
Quels champs dans la table sont reliés à Jira ?
Champs système de Jira :
- Titre
- Description
- Date de fin (Date d’échéance dans Jira)
- Responsable
- État
Champs personnalisés de Jira :
- Date de début
- Estimation
Cliquez sur une cellule pour voir quels champs se synchronisent avec Jira. Tout champ qui se synchronise est accompagné d’un logo Jira. Tous les autres champs ne sont stockés que dans Miro et ne se synchronisent pas avec Jira.
Pourquoi ne puis-je pas modifier un champ dans la table ou le planning parmi les cinq champs Jira pris en charge ci-dessus ?
Il est possible que le champ ne soit pas présent dans l’écran de modification sur Jira.
Une vérification facile pour savoir si le champ est présent dans l’écran de modification ou non :
Sur Miro, ouvrez le panneau latéral pour la carte Jira. Vérifiez si le champ est présent dans le panneau latéral. Si le champ n’est pas présent, vous devez l’ajouter à l’écran de modification sur Jira.
Il peut arriver que certains champs soient modifiables dans Jira, mais absents de l’écran de modification de Jira. Dans ce cas, ces champs ne peuvent pas être modifiés sur Miro.
Est-ce que le champ que vous ne pouvez pas modifier est Date de début ou Estimation? Si c’est le cas :
Le champ peut être absent de Jira ou manquer à l’écran de modification (voir le point précédent).
Il peut y avoir un problème de cartographie pour la Date de début ou l’Estimation, car ce sont des champs Jira personnalisés.
Nous cartographions ces champs selon cette logique :
- Date de début : Nous vérifions les champs nommés : Start Date, StartDate, Target Start
- Évaluation : Nous vérifions les champs nommés : Story Points, Story point estimate, Story Point, StoryPoints, StoryPoint
- Si le champ Date de début ou Évaluation n’est pas nommé comme l’un des noms ci-dessus, cela pourrait expliquer pourquoi la modification ne fonctionne pas.
Pourquoi la modification de la date de début ou de l’estimation dans une table ou un planning Miro ne fonctionne-t-elle pas ou met-elle à jour le mauvais champ dans Jira ?
Nous nous appuyons actuellement sur une cartographie automatique pour les champs Date de début et Estimation dans Jira. Étant donné que ceux-ci sont personnalisables sur Jira, il se peut que plusieurs champs dans votre configuration Jira correspondent aux critères mentionnés ci-dessus.
Nous sélectionnons la première correspondance selon l’ordre des noms de champs mentionnés ci-dessus :
Par exemple, si un ticket Jira a à la fois les champs Story Points et Story point estimate, nous faisons correspondre le premier selon la liste ci-dessus, c’est-à-dire Story Points. Par conséquent, toute modification du champ Estimation dans la table mettra à jour le champ Story Points dans Jira, et non Story point estimate.
Pour l’instant, il n’y a pas de solution de contournement pour cela. Si vous rencontrez ce problème, veuillez envoyer vos avis à votre service d’assistance afin que nous puissions mieux comprendre vos besoins au fur et à mesure que nous développons des fonctionnalités de cartographie de champs plus avancées.
Pourquoi ne puis-je pas importer des cartes Jira de deux instances différentes dans une table ou un planning ?
Nous ne prenons actuellement en charge qu’une seule instance de Jira par table/planning. Une fois qu’une carte Jira est importée dans une table/planning, celle-ci est liée à cette instance spécifique de Jira.
Même si tous les enregistrements Jira sont supprimés, le lien vers l’instance Jira d’origine demeure. Pour importer des cartes à partir d’une instance Jira différente, vous devez créer une nouvelle table/un nouveau planning.
Pourquoi ne puis-je pas voir ou modifier les champs État et Responsable pour mes enregistrements Jira dans une table ou un planning ?
Actuellement, les champs État et Responsable de Jira ne sont pas pris en charge dans les tables et le planning. Nous avons décidé de désactiver ces champs dans les tables et le planning pour gérer les attentes, éviter les confusions et la perte potentielle de données. Les champs État et Responsable de Jira et leur contenu existent, mais n’apparaissent pas dans les tables ou le planning.
Vous pouvez toujours modifier ces champs directement dans les cartes Jira en utilisant le panneau latéral. Il suffit de glisser la ligne de la table ou du Planning sur le canevas pour faire réapparaître votre carte Jira.
Plus d’information :