doc-locale/fr-fr/integration/jira/connect-app.md
{{< details >}}
{{< /details >}}
[!note] Pour la documentation administrateur, consultez Administration de l'application GitLab pour Jira Cloud.
Avec l'application GitLab pour Jira Cloud, vous pouvez connecter GitLab et Jira Cloud pour synchroniser les informations de développement en temps réel. Vous pouvez consulter ces informations dans le panneau de développement Jira.
Vous pouvez utiliser l'application GitLab pour Jira Cloud pour associer des groupes principaux ou des sous-groupes. Il n'est pas possible d'associer directement des projets ou des espaces de nommage personnels.
Pour configurer l'application GitLab pour Jira Cloud sur GitLab.com, installez l'application GitLab pour Jira Cloud.
Après avoir configuré l'application, vous pouvez utiliser la chaîne d'outils de projet développée et maintenue par Atlassian pour associer des dépôts GitLab à des projets Jira. La chaîne d'outils de projet n'affecte pas la façon dont les informations de développement sont synchronisées entre GitLab et Jira Cloud.
Pour Jira Data Center ou Jira Server, utilisez le connecteur Jira DVCS développé et maintenu par Atlassian.
Après avoir associé un groupe, les données GitLab suivantes sont synchronisées avec Jira pour tous les projets de ce groupe lorsque vous mentionnez un ID de ticket Jira :
{{< details >}}
{{< /details >}}
Prérequis :
Pour installer l'application GitLab pour Jira Cloud :
GitLab for Jira Cloud.Vous pouvez également obtenir l'application directement sur l'Atlassian Marketplace.
Vous pouvez maintenant configurer l'application GitLab pour Jira Cloud.
<i class="fa-youtube-play" aria-hidden="true"></i> Pour une vue d'ensemble, consultez l'installation de l'application GitLab pour Jira Cloud depuis l'Atlassian Marketplace pour GitLab.com.
<!-- Video published on 2024-10-30 -->La vidéo ci-dessus présente l'ancienne interface Universal Plugin Manager qui peut ne pas être disponible sur les instances Jira Cloud plus récentes. Les instructions suivantes couvrent à la fois les anciennes et nouvelles interfaces de gestion des applications.
{{< details >}}
{{< /details >}}
{{< history >}}
{{< /history >}}
Prérequis :
Vous pouvez synchroniser des données de GitLab vers Jira en associant l'application GitLab pour Jira Cloud à un ou plusieurs groupes GitLab. Pour configurer l'application GitLab pour Jira Cloud :
<!-- markdownlint-disable MD044 -->Dans Jira, sélectionnez les points de suspension horizontaux ({{< icon name="ellipsis_h" >}}) à côté de Apps et sélectionnez Manage your apps.
Accédez à l'application en utilisant l'une de ces méthodes :
Pour les instances avec gestion centralisée des applications :
<gitlab.example.com>) si vous avez installé l'application manuellement.Pour les instances avec gestion d'applications héritée :
<gitlab.example.com>) si vous avez installé l'application manuellement.Facultatif. Pour associer GitLab Self-Managed à Jira, sélectionnez Change GitLab version.
Sélectionnez Sign in to GitLab.
[!note] Les utilisateurs Enterprise dont l'authentification par mot de passe est désactivée pour leur groupe doivent d'abord se connecter à GitLab avec l'URL d'authentification unique de leur groupe.
GitLab vous demande de vous connecter pour associer des groupes, mais ne lie pas la configuration à un utilisateur spécifique. L'instance GitLab reçoit un jeton de Jira qui est utilisé pour mettre à jour les informations dans Jira. Pour plus d'informations, consultez Accès de GitLab à Jira.
Sélectionnez Autoriser. Une liste de groupes est maintenant visible.
Sélectionnez Associer des groupes.
Pour associer un groupe, sélectionnez Lien.
Après avoir associé un groupe GitLab :
{{< history >}}
enable_jira_connect_configuration. Désactivés par défaut.enable_jira_connect_configuration supprimé.{{< /history >}}
[!note] Cette fonctionnalité a été ajoutée en tant que contribution de la communauté et est développée et maintenue uniquement par la communauté GitLab.
Prérequis :
Vous pouvez connecter GitLab à votre projet de service informatique pour suivre vos déploiements.
La configuration s'effectue dans GitLab, dans l'intégration de l'application GitLab pour Jira Cloud. L'intégration est activée pour un groupe, ses sous-groupes et ses projets dans GitLab après qu'un groupe GitLab a été associé.
L'activation et la désactivation de l'intégration de l'application GitLab pour Jira Cloud s'effectuent entièrement de manière automatique via l'association de groupes, et non via le formulaire d'intégrations GitLab ou l'API.
Dans Jira Service Management :
Dans GitLab :
Vous pouvez mapper jusqu'à 100 services.
Pour plus d'informations sur le suivi des déploiements dans Jira, consultez configurer le suivi des déploiements.
{{< details >}}
{{< /details >}}
{{< history >}}
{{< /history >}}
[!note] Cette fonctionnalité a été ajoutée en tant que contribution de la communauté et est développée et maintenue uniquement par la communauté GitLab.
Vous pouvez configurer le contrôle d'accès aux déploiements pour transmettre les demandes de changement de GitLab à Jira Service Management pour approbation. Grâce au contrôle d'accès aux déploiements, tout déploiement GitLab vers vos environnements sélectionnés est automatiquement envoyé à Jira Service Management et n'est déployé que s'il est approuvé.
Pour créer un jeton de compte de service dans GitLab, vous devez d'abord créer un jeton d'accès personnel. Ce jeton authentifie le jeton de compte de service utilisé pour gérer les déploiements GitLab dans Jira Service Management.
Pour créer le jeton de compte de service :
Pour activer le contrôle d'accès aux déploiements :
Dans GitLab :
production, staging, testing, development). Utilisez uniquement des lettres minuscules.Dans Jira Service Management :
Pour ajouter le compte de service à vos environnements protégés dans GitLab :
Créer un utilisateur de compte de service :
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" --data "name=<name_of_your_choice>&username=<username_of_your_choice>" "<https://gitlab.com/api/v4/groups/<group_id>/service_accounts"
Ajouter le compte de service à un groupe ou un projet en utilisant votre jeton d'accès personnel :
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
--data "user_id=<service_account_id>&access_level=30" "https://gitlab.com/api/v4/groups/<group_id>/members"
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
--data "user_id=<service_account_id>&access_level=30" "https://gitlab.com/api/v4/projects/<project_id>/members"
Générer un jeton de compte de service en utilisant votre jeton d'accès personnel :
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>"
"https://gitlab.com/api/v4/groups/<group_id>/service_accounts/<service_account_id>/personal_access_tokens" --data "scopes[]=api,read_user,read_repository" --data "name=service_accounts_token"
La plupart des mises à jour de l'application sont automatiques. Pour plus d'informations, consultez la documentation Atlassian.
Si l'application nécessite des autorisations supplémentaires, vous devez approuver manuellement la mise à jour dans Jira.
{{< history >}}
{{< /history >}}
L'application GitLab pour Jira Cloud a été migrée d'Atlassian Connect vers Atlassian Forge. Ce changement fait suite à l'annonce de fin de support des applications Connect par Atlassian.
Toutes les fonctionnalités existantes continuent de fonctionner, notamment :
Si vous avez installé l'application GitLab pour Jira Cloud depuis l'Atlassian Marketplace :
Si vous avez précédemment installé l'application GitLab pour Jira Cloud manuellement avec le workflow Connect basé sur l'App descriptor URL, vous devez migrer vers la méthode basée sur Forge. Atlassian a désactivé les installations privées basées sur Connect le 31 mars 2026, donc l'ancien workflow ne fonctionne plus.
Pour migrer et conserver vos données existantes :
Ces étapes garantissent que la nouvelle application Forge conserve le connect.app.key d'origine. Jira utilise cette clé, conjointement avec le nouvel ID d'application Forge, pour reconnaître les deux installations comme liées, afin que vos données de développement précédemment synchronisées restent intactes.
Après la conversion, suivez les instructions d'installation manuelle basée sur Forge pour publier une copie privée de l'application Forge GitLab pour Jira Cloud sous votre propre compte développeur Atlassian.
Pour plus d'informations sur la transition de Connect vers Forge, consultez le guide Atlassian sur l'adoption de Forge.
L'application GitLab pour Jira Cloud connecte GitLab et Jira. Les données doivent être partagées entre les deux applications, et l'accès doit être accordé dans les deux sens.
Lorsque vous configurez l'application GitLab pour Jira Cloud, GitLab reçoit un shared secret token de la part de Jira. Le jeton accorde à GitLab les portées d'application READ, WRITE et DELETE pour le projet Jira. Ces portées sont nécessaires pour mettre à jour les informations dans le panneau de développement du projet Jira. Le jeton n'accorde pas à GitLab l'accès à d'autres produits Atlassian en dehors du projet Jira dans lequel l'application a été installée.
Le jeton est chiffré avec AES256-GCM et stocké sur GitLab. Lorsque l'application GitLab pour Jira Cloud est désinstallée de votre projet Jira, GitLab supprime le jeton.
Jira n'obtient aucun accès à GitLab.
Pour toutes les données envoyées à Jira, consultez Données GitLab synchronisées avec Jira.
Pour plus d'informations sur les propriétés de données spécifiques envoyées à Jira, consultez les classes de sérialisation impliquées dans la synchronisation des données.
GitLab reçoit un événement de cycle de vie de Jira lorsque l'application GitLab pour Jira Cloud est installée ou désinstallée. L'événement inclut un jeton pour vérifier les événements de cycle de vie ultérieurs et pour s'authentifier lors de l'envoi de données à Jira. Les requêtes d'événements de cycle de vie provenant de Jira sont vérifiées.
Pour les instances GitLab Self-Managed qui utilisent l'application GitLab pour Jira Cloud depuis l'Atlassian Marketplace, GitLab.com gère les événements de cycle de vie et les transfère à l'instance GitLab Self-Managed. Pour plus d'informations, consultez Gestion des événements de cycle de vie de l'application par GitLab.com.
Les données envoyées à Jira sont stockées par Jira et affichées dans le panneau de développement Jira.
Lorsque l'application GitLab pour Jira Cloud est désinstallée, Jira supprime définitivement ces données. Ce processus s'effectue de manière asynchrone et peut prendre jusqu'à plusieurs heures.
Pour plus d'informations, consultez les détails sur la confidentialité et la sécurité de la fiche Atlassian Marketplace.
Lorsque vous utilisez l'application GitLab pour Jira Cloud, vous pouvez rencontrer les problèmes suivants.
Pour le dépannage administrateur, consultez Administration de l'application GitLab pour Jira Cloud.
Failed to link group {#error-failed-to-link-group}Lorsque vous connectez l'application GitLab pour Jira Cloud, vous pouvez obtenir cette erreur :
Failed to link group. Please try again.
Un 403 Forbidden est renvoyé si les informations utilisateur ne peuvent pas être récupérées depuis Jira en raison de permissions insuffisantes.
Pour résoudre ce problème, assurez-vous de satisfaire à certaines exigences utilisateur Jira.
Si l'utilisateur Jira possède des privilèges d'administrateur mais n'est pas explicitement membre du groupe site-admins ou org-admins, consultez Erreur : l'utilisateur Jira n'est pas un administrateur de site ou d'organisation.
Jira Code peut ne pas fonctionner après que vous avez associé l'application GitLab pour Jira Cloud à un groupe GitLab. Pour résoudre ce problème, vous devez configurer à la fois Bitbucket et Jira.
Dans Bitbucket :
Dans Jira :
Vos dépôts devraient maintenant apparaître dans Jira Code.
Pour plus d'informations, consultez le ticket JRACLOUD-95847.