Problèmes éventuels avec les cartes Jira et le module complémentaire Jira

L’application Cartes Jira est installée, mais votre équipe Miro n’est pas connectée à Jira.

Veuillez suivre ce guide d’installation : Paramétrer et désactiver les cartes Jira. Si vous n’êtes pas admin d’équipe, demandez à l’admin de le faire. 

Requête à Jira... échec : le délai a été dépassé / Hôte inconnu / Connexion refusée

Jira est uniquement accessible sur votre intranet (vous utilisez les mauvaises adresses IP pour communiquer avec le système Jira).

Assurez-vous d’ajouter à votre liste d’autorisations notre adresse IP, nos domaines et nos sous-domaines pour octroyer le niveau d’accès requis à notre intégration. 

Si vous utilisez une ancienne version du serveur Jira, vérifiez qu’aucune fonctionnalité du mode sombre ne bloque l’accès à Miro.

Applicable à OAuth 1.0. (Serveur Jira et Centre de données) uniquement.

Le lien d’application dans Jira n’est pas configuré correctement

- Vous avez manqué certaines étapes dans la configuration du lien ou du webhook

- Vous avez installé le module complémentaire Jira au lieu de configurer le lien pour les cartes Jira.

Essayez d’installer l’intégration des cartes Jira en partant de zéro. 

Si vous avez choisi de créer le webhook manuellement, essayez de le créer automatiquement.

Applicable à OAuth 1.0. (Serveur Jira et Centre de données) uniquement.

Le lien d’application dans votre instance Jira n’est pas configuré correctement ou le jeton a expiré. Vérifiez le lien de l’application et reconnectez l’intégration.

- Le lien de l’application dans Jira a été reconfiguré.

- Le jeton a expiré.

- Le jeton a été révoqué.

Assurez-vous que votre lien d’application est configuré correctement et essayez de reconnecter Miro aux cartes Jira.

Si vous utilisez une version de Jira hautement protégée ou si vous utilisez un serveur proxy, assurez-vous d’ajouter à votre liste d’autorisations notre adresse IP, nos domaines et nos sous-domaines pour fournir le niveau d’accès requis à notre intégration. 

Si vous utilisez une ancienne version du serveur Jira, vérifiez qu’aucune fonctionnalité du mode sombre ne bloque l’accès à Miro.

Applicable à OAuth 1.0. (Serveur Jira et Centre de données) uniquement.

Le lien de votre application demande plus de valeurs que l’URL, la clé du consommateur, le nom du consommateur, la clé publique.

Vous regardez l’onglet Authentification sortante du menu de configuration.

- Passez à l’onglet Incoming Authentification entrante. L’authentification sortante ne nécessite pas de configuration.

- Si vous ne pouvez pas ignorer l’étape, ajoutez des valeurs temporaires, quelles qu’elles soient. Vous pourrez les supprimer plus tard : sur la page avec la liste de vos liens d’application, cliquez sur Modifier pour modifier le lien Cartes Miro et supprimer les valeurs temporaires. 

Applicable à OAuth 1.0. (Serveur Jira et Centre de données) uniquement.

L’URL Jira n’est pas valide /
Saisissez l’URL de base de Jira /
Mauvaise requête. Désérialisation.

Votre Jira est sur un réseau privé / le pare-feu de votre entreprise bloque les connexions réseau externes.

Ajoutez nos adresses IP passerelles NAT (ainsi que les ports) à votre liste d’autorisations. 
*Notez que si vous vérifiez nos adresses IP en utilisant nslookup, les résultats renverront les adresses de notre équilibreur de charge, qui peuvent varier au fil du temps.

Vous utilisez un serveur proxy / Vos URL Jira externes et internes ne coïncident pas.

Assurez-vous de saisir dans le champ URL de Jira une adresse à laquelle nous pouvons accéder. Aussi, configurez un serveur proxy inverse pour nous permettre d’y accéder et/ou suivez les étapes de ce guide d’Atlassian (disponible uniquement en anglais). Avec cette solution, l’intégration pourra connecter et transmettre avec succès les demandes entre Jira et Miro si vos URL externes et internes sont différentes.
Vous pouvez également prolonger la valeur du délai d’attente sur votre serveur proxy.
Vous trouverez la liste des points de terminaison sur la FAQ des cartes Jira.

Il y a un problème avec votre certificat SSL (les certificats auto-signés ne sont pas pris en charge).

Vérifiez le certificat SSL actif sur le serveur Jira. Cet outil (disponible uniquement en anglais) pourrait être utile : entrez votre URL Jira et regardez les résultats de la vérification de connexion.
Exemple : le certificat est peut-être valide (Certificate (Certificat) en vert), mais la chaine de certificats du serveur est peut-être incomplète (Key exchange (Échange de clé) en jaune) et notre système reçoit donc une réponse indiquant que le certificat doit être mis à jour.
Merci de consulter ce site (disponible uniquement en anglais) pour résoudre les problèmes.

Votre Jira utilise l’authentification unique (peut également entraîner l’erreur L’authentification entrante n’est pas configurée correctement).

Assurez-vous que votre processus d’authentification unique ne s’applique pas aux demandes de connexion de notre intégration. Pour y parvenir, les points de terminaison suivants doivent être exclus des processus d’authentification unique :

POST {JIRA_URL}/plugins/servlet/oauth/request-token
POST {JIRA_URL}/plugins/servlet/oauth/access-token
GET {JIRA_URL}/rest/api/2/serverInfo

Comportement inattendu lors de l’installation

Vous utilisez la version 6.4 ou antérieure de Jira.

Nos cartes ne fonctionneront pas avec ces versions en raison de ce bug sur Jira (page en anglais uniquement). Mettez à jour Jira vers la dernière version.

L’autorisation de l’application a échoué. Essayez d’autoriser à nouveau l’application. 

Une perte de connexion momentanée. Cliquez sur Connecter pour vous connecter à nouveau. 

Applicable à OAuth 1.0. (Serveur Jira et Centre de données) uniquement.

Erreur Jira : « Vous n’avez pas les autorisations pour créer un Webhook ’Miro’ ».

Vous n’avez pas les droits d’admin sur Jira. Demandez à votre admin Jira de vous attribuer le rôle d’admin afin que vous puissiez configurer l’intégration.

Échec de la requête à Jira : la construction du chemin PKIX a échoué : impossible de trouver un chemin de certification valide vers la cible demandée.

Il y a un problème avec votre certificat de serveur.
 
Pour résoudre le problème, nous vous suggérons de contacter votre département informatique et de lui demander de vérifier les certificats de votre côté (recharger les serveurs Web, s’assurer que les certificats sont publiquement approuvés, etc.). 

Incapacité d’autoriser dans Jira via Miro.
Erreur : exceptions 
(par exemple, io.netty.handler.timeout.ReadTimeoutException)

Cela peut se produire en raison d’une mauvaise configuration de l’infrastructure Jira lorsque l’infrastructure d’installation indique la prise en charge du protocole HTTP/2, mais qu’aucun transfert de données n’a lieu lorsque vous tentez de l’utiliser. Vérifiez vos paramètres HTTP/2 dans les fichiers de configuration de votre serveur Web pour vous assurer qu’ils sont configurés correctement.

Si nécessaire, désactivez temporairement la prise en charge HTTP/2 dans la configuration de votre serveur pour assurer la compatibilité ascendante et la non-interruption du service jusqu’à ce que le problème soit résolu.

Les cartes Jira ne se mettent pas à jour

Applicable à OAuth 1.0. (Serveur Jira et Centre de données) uniquement.

Vous utilisez un webhook manuel.

Veuillez désactiver l’intégration et la reconnecter en utilisant un webhook automatique. Si tout fonctionne correctement avec un webhook automatique, cela signifie que le webhook manuel n’a pas été configuré correctement.

Consultez aussi l’article l’article Comment configurer un webhook pour les cartes Jira. 

Applicable à OAuth 1.0. (Serveur Jira et Centre de données) uniquement.

Si vous utilisez un webhook automatique :

La première étape de dépannage consiste à reconnecter l’intégration. Si cela ne corrige pas le problème, plusieurs raisons peuvent expliquer pourquoi les cartes Jira ne sont plus actives :

- Un tableau Miro a été déplacé/téléchargé à partir d’une sauvegarde dans une équipe depuis une autre.

- Les tickets Jira qui ne se mettent pas mis à jour ont été déplacés d’un projet à un autre sur Jira.

- Vous n’avez pas accès aux projets dans lesquels se trouvent les tickets Jira.

- Les cartes qui ne se mettent pas à jour ne se trouvent pas dans la même instance Jira que celle que vous utilisez actuellement sur votre navigateur.

Applicable à OAuth 1.0. (Serveur Jira et Centre de données) uniquement.

Les cartes Jira ont cessé de se mettre à jour sans qu’aucun changement n’ait été apporté de votre côté, et lorsque vous essayez de reconnecter, vous voyez le message d’erreur Le lien de l’application dans Jira n’est pas configuré correctement.

Le message d’erreur peut apparaître lorsque Miro est incapable de solliciter un Jira connecté en raison d’une erreur d’autorisation. Cela peut se produire si l’utilisateur qui a configuré l’intégration révoque son jeton ou si Jira est configuré avec une courte durée de vie du jeton émis, qui devient donc tout simplement invalide par la suite et doit être reconnecté pour récupérer un nouveau jeton d’autorisation valide avec lequel Miro accède à Jira.

L’option Modifier la carte renvoie une fenêtre vide

Applicable à OAuth 1.0. (Serveur Jira et Centre de données) uniquement.

Vous utilisez la version Jira 7.6 et ultérieure.

Pour des raisons de sécurité, Atlassian peut ne pas autoriser l’intégration de contenu dans des iFrames, ce qui pourrait également affecter les fenêtres contextuelles qui permettent de modifier vos cartes Jira. Vous pouvez suivre ces instructions (disponibles uniquement en anglais) pour contourner le problème.

Impossible d’ajouter des cartes Jira

Applicable à OAuth 1.0. (Serveur Jira et Centre de données) uniquement.

Vous avez créé un webhook manuel et n’avez pas enregistré les informations de configuration.

Vérifiez si le champ URL Jira est rempli dans les Paramètres Miro. Assurez-vous de cliquer sur Connecter.

L’icône Modifier ne s’affiche pas.

Applicable à OAuth 1.0. (Serveur Jira et Centre de données) uniquement.

Vous utilisez la version 7.6 ou ultérieure du serveur Jira.

L’icône Modifier peut ne pas s’afficher en raison d’une mise à jour de sécurité dans cette version.

Votre profil n’est pas autorisé à modifier le ticket Jira en question.

Vérifiez si vous avez accès au mode édition après avoir ouvert le ticket sur Jira.

Vous obtenez le message : Vous n’êtes pas connecté et n’avez pas les autorisations requises pour agir en tant qu’invité sur le ticket sélectionné. Veuillez vous connecter.

En raison de la manière dont notre intégration utilise les cookies, votre Jira pourrait ne pas vous permettre de vous connecter à partir de cette page.

Connectez-vous à Jira dans un autre onglet du navigateur.
Assurez-vous de vérifier que les cookies tiers sont autorisés dans votre navigateur.

Votre Jira fonctionne avec l’authentification unique et votre fournisseur d’identité (IdP) ne permet pas l’authentification via des iframes.

Si vous travaillez sur l’application de bureau Miro, nous vous recommandons de passer sur la version pour navigateur sur miro.com.

Aucune option pour convertir/créer une carte Jira dans Miro lorsque vous choisissez certains projets :

- Aucune donnée dans le champ type du sujet.

- Le bouton Convertir/Créer est inactif.

Vous n’avez pas accès au projet dans Jira. Vérifiez si vous pouvez obtenir un droit d’accès.

Impossible de créer un ticket Jira lorsque vous essayez de convertir/créer une nouvelle carte Jira :

Vous n’avez pas les droits nécessaires pour créer des tickets Jira.

Contactez votre admin Jira et demandez-lui de vous accorder les autorisations nécessaires sur Jira. Voici à quoi cela devrait ressembler :

Certains champs personnalisés ne sont pas affichés dans le menu Convertir en sujet Jira/Modifier le sujet Jira.

Impossible de créer un sujet Jira. Erreur Les champs obligatoires (...) ne sont pas pris en charge lors de la création d’un sujet Jira dans Miro.

Les champs ne sont pas activés sur le sélecteur de tableaux de cartes Jira.

Utilisez notre sélecteur Jira intégré pour configurer des champs personnalisés en suivant les étapes de ce guide.

Si Sélectionner les champs à afficher sur les cartes n’affiche pas les champs personnalisés de Jira, il est possible que certains des écrans (page disponible uniquement en anglais) configurés pour les projets de votre instance Jira cachent les champs de Miro.

Allez dans Paramètres du projet > Écrans > Schéma d’écran par défaut et vérifiez si les champs requis sont autorisés.

Miro ne prend pas en charge les champs de types de données complexes.

Miro prend en charge les champs personnalisés de base mais pas les complexes. Configurez les champs de cartes Jira et supprimez les champs qui ne sont pas pris en charge.

Vous ne pouvez pas choisir le Rapporteur lors de la modification/création d’une carte Jira.

Il n’y a pas de champ Rapporteur dans les métadonnées Créer de Jira : le champ n’est pas disponible sur l’écran Créer (article disponible uniquement en anglais) de Jira pour le projet sélectionné.

Allez dans Paramètres du projet > Écrans et vérifiez si le champ Rapporteur existe dans l’écran Créer.

Vous n’avez pas les autorisations nécessaires pour définir le rapporteur pour les tickets du projet sélectionné. 

Demandez à l’admin Jira de vérifier vos niveaux d’accès et assurez-vous de disposer de l’autorisation nécessaire pour définir/modifier le champ Rapporteur dans le projet sélectionné. Pour ce faire, l’admin doit se connecter à Jira > aller dans Paramètres > Tickets > Schémas d’autorisations > et cocher le champ Modifier le rapporteur (ajoutez l’accès à l’application : Tout utilisateur connecté au cas où vous ne l’auriez pas sur la liste :

Le champ du rapporteur n’est pas modifiable pour des besoins d’audit et est défini sur la personne qui a créé le ticket.

L’indisponibilité du champ est un comportement attendu.

Certains champs sont affichés dans le mode modification d’une carte, mais ne s’affichent pas sur les cartes Jira sur les tableaux.

Miro ne reçoit pas de mises à jour de Jira.

• Changez de réseau.
• Reconnectez l’intégration.

Applicable à OAuth 1.0. (Serveur Jira et Centre de données) uniquement.

Erreur Jira n’est pas disponible dans les paramètres de l’application des cartes Jira

1. Demandez à l’admin d’équipe de désactiver et de reconnecter l’intégration.

2. Votre Jira est sous protection (pare-feu, bloqueurs de sécurité, etc.) et ne peut être atteint par Miro.

Si les cartes Jira se synchronisent en même temps entre Miro et Jira, cela signifie que Jira peut nous envoyer des webhooks. C’est pourquoi vous pouvez voir les mises à jour sur vos tableaux.

Pour y remédier, nous vous suggérons de discuter du problème avec les membres de votre service informatique et de leur demander de revérifier que Miro dispose bien des autorisations requises. 

Si vous utilisez une ancienne version du serveur Jira, vérifiez qu’aucune fonctionnalité du mode sombre ne bloque l’accès à Miro.

Applicable à OAuth 1.0. (Serveur Jira et Centre de données) uniquement.

Erreur Problèmes de webhook Jira dans les paramètres de l’application des cartes Jira

- Vous avez modifié/supprimé un webhook du côté de Jira.
- Miro reçoit la réponse « Bad request » (Requête incorrecte) de Jira.

Lorsque vous utilisez Ctrl + V (pour Windows)/Cmd + V (pour Mac) pour coller le lien d’un ticket Jira sur le tableau, il ne se transforme pas en une carte Jira mais apparait en tant qu’URL.

Le tableau est encore en train de charger. Peut se produire sur les grands tableaux et les tableaux avec de grandes images ou documents PDF. 

Patientez au moins 10 secondes après avoir ouvert le tableau et laissez-le se charger complètement. Ensuite, essayez de coller à nouveau le lien.

La description n’est pas visible sur les cartes Jira sur le tableau.

La description d’une carte peut être masquée si vous effectuez un zoom arrière. Pour voir la description, vous devrez peut-être développer la carte ou faire un zoom avant (la description devient partiellement visible avec un zoom triple du tableau).

« Affichage de 0 sprints correspondants sur 0 » lorsque vous essayez de rechercher et de trouver des sprints disponibles.

1. Cela se produit lorsque vous n’avez pas de sprints actifs/futurs (car ils sont tous fermés/terminés). 

2. Votre filtre dans Jira n’inclut pas les projets. Ajoutez un projet nécessaire au JQL pour le filtre des tableaux et les sprints apparaîtront à la fois dans Jira et dans Miro.

Applicable à OAuth 1.0. (Serveur Jira et Centre de données) uniquement.

Échec de la connexion SSL avec...

Cette erreur signifie que Miro n’a pas accès à Jira.

Contactez vos admins d’équipe Miro et demandez-leur de vérifier si votre champ URL de base de Jira dans les paramètres des cartes Jira contient l’adresse à laquelle nous pouvons vous connecter.

Assurez-vous que la permission « Parcourir les utilisateurs » est définie au niveau global dans Jira. En savoir plus sur la façon de gérer les autorisations globales (uniquement disponible en anglais). 

Malheureusement, du fait que notre plugin utilise des cookies, Jira ne vous permettra pas de vous connecter à partir de cette page.

Connectez-vous à Jira dans un autre onglet du navigateur.

Après avoir cliqué sur le bouton Installer sur la page des modules complémentaires, il se peut que vous rencontriez l’erreur suivante :

Perte momentanée de connexion.

Dans ce cas, il suffit de réessayer l’installation une minute plus tard.

Pendant ou après la configuration du module complémentaire Jira, vous n’arrivez pas à accéder à la page suivante à une étape donnée.

Quelque chose dans vos cookies ou dans votre cache interrompt le processus.

Effacez la mémoire de votre navigateur pour le domaine atlassian.com et réessayez.

Après une installation réussie, vos utilisateurs de Jira qui ne sont pas enregistrés sur Miro voient le menu de connexion Miro au lieu du tableau intégré.

Les politiques de Jira bloquent certaines des fonctionnalités du plugin. 

Malheureusement, ce comportement est causé par la dernière mise à jour de l’API Jira et ne peut pas être corrigé pour le moment.

Le module complémentaire ne se souvient pas de votre autorisation et vous demande à chaque fois de vous connecter.  

Lorsque vous essayez d’ajouter des tableaux à un ticket Jira, le sélecteur de tableaux affiche l’erreur : « Désolé, l’intégration n’est pas disponible ».

Les cookies tiers sont bloqués dans votre navigateur.

Pour y remédier, suivez les instructions sur l’activation des cookies dans votre navigateur. Cela se produit principalement avec Mozilla et Safari en raison de leurs nouvelles politiques de sécurité.
Pour Safari, cette solution peut également s’avérer utile.