Dépannage du connecteur Jira DVCS

{{< details >}}

• Édition : Gratuite, GitLab Premium, GitLab Ultimate
• Offre : GitLab.com, GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

Lorsque vous utilisez le connecteur Jira DVCS, vous pouvez rencontrer les problèmes suivants.

Jira ne peut pas accéder au serveur GitLab {#jira-cannot-access-the-gitlab-server}

Si vous remplissez le formulaire Add New Account, autorisez l'accès et recevez cette erreur, Jira et GitLab ne peuvent pas se connecter. Aucun autre message d'erreur n'apparaît dans les journaux :

Error obtaining access token. Cannot access https://gitlab.example.com from Jira.

Bogue de jeton de session dans Jira {#session-token-bug-in-jira}

Lorsque vous utilisez GitLab 15.0 ou une version ultérieure avec Jira Server, vous pouvez rencontrer un bogue de jeton de session dans Jira. Ce bogue affecte Jira Server 8.20.8, 8.22.3, 8.22.4, 9.4.6 et 9.4.14.

Pour résoudre ce problème, assurez-vous d'utiliser Jira Server 8.20.11 ou une version ultérieure, ou 9.1.0 ou une version ultérieure.

Problèmes SSL et TLS {#ssl-and-tls-problems}

Les problèmes liés à SSL et TLS peuvent générer ce message d'erreur :

Error obtaining access token. Cannot access https://gitlab.example.com from Jira.

• L'intégration des tickets Jira nécessite que GitLab se connecte à Jira. Tout problème TLS résultant d'une autorité de certification privée ou d'un certificat auto-signé est résolu sur le serveur GitLab, car GitLab est le client TLS.
• Le panneau de développement Jira nécessite que Jira se connecte à GitLab, ce qui fait de Jira le client TLS. Si le certificat de votre serveur GitLab n'est pas émis par une autorité de certification publique, ajoutez le certificat approprié (tel que le certificat racine de votre organisation) au Java Truststore sur Jira Server.

Pour plus d'informations sur la configuration de Jira, consultez la documentation Atlassian et le support Atlassian.

• Ajoutez un certificat au truststore.
  • L'approche la plus simple est keytool.
  • Ajoutez des racines supplémentaires au Truststore par défaut de Java (cacerts) pour permettre à Jira de faire également confiance aux autorités de certification publiques.
  • Si l'intégration cesse de fonctionner après la mise à niveau du runtime Java de Jira, le Truststore cacerts a peut-être été remplacé lors de la mise à niveau.
• Résolvez les problèmes de connectivité jusqu'à la négociation TLS incluse, à l'aide de la classe Java SSLPoke.
• Téléchargez la classe depuis la base de connaissances Atlassian vers un répertoire sur Jira Server, tel que /tmp.
• Utilisez le même runtime Java que Jira.
• Transmettez tous les paramètres liés au réseau avec lesquels Jira est appelé, tels que les paramètres de proxy ou un Truststore racine alternatif (-Djavax.net.ssl.trustStore) :

${JAVA_HOME}/bin/java -Djavax.net.ssl.trustStore=/var/atlassian/application-data/jira/cacerts -classpath /tmp SSLPoke gitlab.example.com 443

Le message Successfully connected indique une négociation TLS réussie.

En cas de problèmes, la bibliothèque Java TLS génère des erreurs que vous pouvez rechercher pour obtenir plus de détails.

Erreur de portée lors de la connexion à Jira avec DVCS {#scope-error-when-connecting-to-jira-with-dvcs}

The requested scope is invalid, unknown, or malformed.

Résolutions potentielles :

1. Vérifiez que l'URL affichée dans le navigateur après la redirection depuis Jira dans la configuration du connecteur Jira DVCS inclut scope=api dans la chaîne de requête.
2. Si scope=api est absent de l'URL, modifiez la configuration du compte GitLab. Vérifiez le champ Périmètre d'accès et assurez-vous que la case api est cochée.

Erreur : 410 Gone {#error-410-gone}

Lorsque vous vous connectez à Jira et synchronisez les dépôts, vous pouvez obtenir une erreur 410 Gone. Ce problème survient lorsque vous utilisez le connecteur Jira DVCS et que votre intégration est configurée pour utiliser GitHub Enterprise.

Pour plus d'informations, consultez le ticket 340160.

Problèmes de synchronisation {#synchronization-issues}

Si Jira affiche des informations incorrectes, comme des branches supprimées, vous devrez peut-être resynchroniser les informations :

1. Dans Jira, sélectionnez Jira Administration > Applications > DVCS accounts.
2. Pour le compte (groupe ou sous-groupe), sélectionnez Refresh repositories dans le menu {{< icon name="ellipsis_h" >}} (points de suspension).
3. Pour chaque projet, à côté de la date de Dernière activité :
   • Pour effectuer une resynchronisation partielle, sélectionnez l'icône de synchronisation.
   • Pour effectuer une synchronisation complète, appuyez sur Shift et sélectionnez l'icône de synchronisation.

Pour plus d'informations, consultez la documentation Atlassian.

Erreur : Sync Failed {#error-sync-failed}

Si vous obtenez une erreur Sync Failed dans Jira lorsque vous actualisez les données du dépôt pour des projets spécifiques, vérifiez les journaux de votre connecteur Jira DVCS. Recherchez les erreurs qui surviennent lors de l'exécution de requêtes vers des ressources API dans GitLab. Par exemple :

Failed to execute request [https://gitlab.com/api/v4/projects/:id/merge_requests?page=1&per_page=100 GET https://gitlab.com/api/v4/projects/:id/merge_requests?page=1&per_page=100 returned a response status of 403 Forbidden] errors:
{"message":"403 Forbidden"}

Si vous obtenez une erreur 403 Forbidden, ce projet peut avoir certaines fonctionnalités GitLab désactivées. Dans l'exemple précédent, la fonctionnalité de merge requests est désactivée.

Pour résoudre le problème, activez la fonctionnalité concernée :

1. Dans la barre supérieure, sélectionnez Rechercher ou accéder à et trouvez votre projet.
2. Dans la barre latérale gauche, sélectionnez Paramètres > Généralités.
3. Développez Visibilité, fonctionnalités du projet, autorisations.
4. Utilisez les bascules pour activer les fonctionnalités selon vos besoins.

Trouver les journaux de webhook dans un projet lié à DVCS {#find-webhook-logs-in-a-dvcs-linked-project}

Pour trouver les journaux de webhook dans un projet lié à DVCS :

1. Dans la barre supérieure, sélectionnez Rechercher ou accéder à et trouvez votre projet.
2. Dans la barre latérale gauche, sélectionnez Paramètres > Webhooks.
3. Faites défiler jusqu'à Project hooks.
4. À côté du journal qui pointe vers votre instance Jira, sélectionnez Éditer.
5. Faites défiler jusqu'à Événements récents.

Si vous ne trouvez pas les journaux de webhook dans votre projet, vérifiez votre configuration DVCS pour détecter d'éventuels problèmes.