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 : Comment installer et désinstaller 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 de mettre sur liste autorisée nos adresses IP, domaines et sous-domaines pour fournir à notre intégration le niveau d’accès nécessaire. 

Si vous utilisez Jira Server et une version plus ancienne, vérifiez que les fonctionnalités cachées ne bloquent pas 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 à partir 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 êtes sur Jira Server et que vous utilisez une version plus ancienne, vérifiez qu'aucune fonctionnalité cachée ne bloque l'accès à Miro.

Applicable à OAuth 1.0. (Serveur Jira & 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 êtes dans l'onglet Authentification sortante du menu de configuration.

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

- Si vous ne pouvez pas ignorer l'étape, ajoutez n'importe quelles valeurs temporaires. Vous pourrez les supprimer plus tard : une fois sur la page avec la liste de vos liens d'application, cliquez sur Modifier pour le lien Cartes Miro et supprimez les valeurs temporaires. 

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

L'URL Jira n'est pas valide /
Entrez l'URL de base 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 de passerelle NAT (et ports) à votre liste autorisée. 
*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 remplir le champ fort 'URL Jira' avec l'adresse que nous pouvons accéder, donc configurez un proxy inversé qui nous permet d'accéder et/ou suivez les étapes de ce guide Atlassian. 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 voudrez peut-être également prolonger la durée du délai d'attente sur votre serveur proxy.
La liste des points de terminaison peut être trouvée ici: FAQ sur les 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 pourrait être utile : entrez l'URL de votre Jira et consultez les résultats de la vérification de la connexion.
Exemple : le certificat peut être correct (le Certificat en vert) mais la chaîne de certificats du serveur peut être incomplète (Échange de clé en jaune), ce qui fait que notre système reçoit une réponse indiquant que le certificat doit être mis à jour.
Référez-vous à ce site 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 :

GET {JIRA_URL}/rest/api/2/serverInfo
(OAuth 1.0) POST {JIRA_URL}/plugins/servlet/oauth/request-token
(OAuth 1.0) POST {JIRA_URL}/plugins/servlet/oauth/access-token
(OAuth 2.0) POST {JIRA_URL}/plugins/servlet/oauth2/*

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 de Jira. Mettez à jour Jira vers la dernière version.

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

1. Perte momentanée de connexion. Cliquez sur Connecter à nouveau.

2. Jeton expiré envoyé lors de la procédure d'autorisation. Nettoyez les données mises en cache, commencez sur un environnement propre. En d'autres termes, incitez Jira à produire un nouveau jeton.

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 demande à Jira : la construction du chemin PKIX a échoué : chemin de certification valide introuvable vers la cible demandée

Il y a un problème avec votre certificat serveur.
 
En solution, nous vous suggérons de contacter votre service informatique et de leur 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 ex. 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.

Également, consultez Comment configurer un webhook pour les cartes Jira. 

Applicable à OAuth 1.0 et OAuth 2.0 (Jira Server & Data Center).

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 se mettent plus à jour. Par exemple :

- un tableau Miro a été déplacé ou téléchargé par sauvegarde dans une autre équipe

- les tickets Jira ont été déplacés d'un projet à un autre sur Jira

- vous n’avez pas accès aux projets où se trouvent les tickets Jira

- (Enterprise uniquement) le propriétaire du tableau est désactivé ou possède une licence gratuite restreinte

- (OAuth1.0 uniquement) les cartes Jira ne se trouvent pas dans la même instance Jira que celle que vous utilisez actuellement dans votre navigateur

Applicable à OAuth 1.0. (Serveur Jira & 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, 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 utiliser ces instructions comme solution de contournement.

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 renseigné 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 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 ticket.

- 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 ticket Jira/Modifier le ticket Jira

Impossible de créer un ticket Jira. Les champs obligatoires (...) ne sont pas pris en charge erreur lors de la création d’un ticket 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 les champs personnalisés en suivant les étapes de ce guide.

Si l’option Sélectionner les champs à afficher sur les cartes n’affiche pas les champs personnalisés de votre Jira, il est possible que certains des Écrans 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 nécessaires 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. Configurer les champs de carte Jira et supprimez ceux 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 de Création de Jira : le champ n'est pas disponible sur l'écran de Création 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, ils doivent se connecter à Jira > aller dans Paramètres > Tickets > Schémas de permissions > et vérifier le Champ Modifier le Rapporteur (veuillez ajouter l’Accès aux applications: Tout utilisateur connecté si cela n’apparaît pas dans 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.

Jira n'est pas disponible erreur dans les Paramètres de l'application Jira Cards

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 êtes sur Jira Server et une version plus ancienne, vérifiez qu'aucune fonctionnalité masquée ne bloque l'accès pour Miro.

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

Problèmes de webhook Jira erreur 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 apparaît en tant qu’URL

Le tableau est encore en train de charger. Peut se produire sur les grands tableaux ou sur ceux contenant de grandes images ou des 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

Pour voir les détails de la carte, cliquez sur la carte et choisissez agrandir pour voir les détails de la carte dans la barre latérale sur votre 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 de 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 à votre 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 nous connecter.

Assurez-vous que la permission « Parcourir les utilisateurs » est définie au niveau global dans Jira. En savoir plus sur la gestion des permissions globales.