Tutoriel : créer des identifiants Jira

Dans ce tutoriel, vous allez configurer un utilisateur Jira dédié et lui accorder les autorisations dont l'intégration des tickets Jira a besoin. Toutes les étapes sont effectuées dans Jira, pas dans GitLab.

Une fois ce tutoriel terminé, utilisez le nom d'utilisateur et le mot de passe Jira que vous avez créés ici pour configurer l'intégration des tickets Jira dans GitLab.

Pour créer des identifiants Jira :

1. Créer un utilisateur Jira.
2. Créer un groupe Jira pour l'utilisateur.
3. Créer un schéma d'autorisations pour le groupe.
4. Attribuer le schéma d'autorisations à vos projets.

Avant de commencer {#before-you-begin}

• Vous devez disposer de la Jira administrators ou Jira System administrators autorisation globale.

Créer un utilisateur Jira {#create-a-jira-user}

Pour créer un utilisateur Jira :

1. Dans le coin supérieur droit, sélectionnez Administration > User management.

2. Créez un nouveau compte utilisateur avec un accès en écriture à vos projets Jira :

   • Dans Adresse de courriel, saisissez une adresse e-mail valide.
   • Dans Nom d'utilisateur, saisissez gitlab.
   • Dans Mot de passe, saisissez un mot de passe. L'intégration des tickets Jira ne prend pas en charge l'authentification unique (SSO) telle que SAML.

3. Sélectionnez Créer un utilisateur.

Vous pouvez également utiliser un compte utilisateur existant, à condition que l'utilisateur appartienne à un groupe disposant des autorisations requises.

Maintenant que vous avez créé un utilisateur nommé gitlab, il est temps de créer un groupe pour cet utilisateur.

Créer un groupe Jira pour l'utilisateur {#create-a-jira-group-for-the-user}

Pour créer un groupe Jira pour l'utilisateur :

1. Dans le coin supérieur droit, sélectionnez Administration > User management.
2. Dans la barre latérale gauche, sélectionnez Groupes.
3. Dans la section Ajouter un groupe, saisissez un nom pour le groupe (par exemple, gitlab-developers), puis sélectionnez Ajouter un groupe.
4. Pour ajouter l'utilisateur gitlab au groupe gitlab-developers, sélectionnez Edit members. Le groupe gitlab-developers apparaît en tant que groupe sélectionné. <!-- vale gitlab_base.BadPlurals = NO -->
5. Dans la section Add members to selected group(s), saisissez gitlab. <!-- vale gitlab_base.BadPlurals = YES -->
6. Sélectionnez Add selected users. L'utilisateur gitlab apparaît en tant que membre du groupe.

Maintenant que vous avez ajouté l'utilisateur gitlab au groupe gitlab-developers, il est temps de créer un schéma d'autorisations pour le groupe.

Créer un schéma d'autorisations pour le groupe {#create-a-permission-scheme-for-the-group}

L'intégration des tickets Jira a besoin d'autorisations pour parcourir les projets, créer et modifier des tickets, et ajouter des commentaires. N'accordez que les autorisations requises pour ces actions.

Pour créer un schéma d'autorisations :

1. Dans le coin supérieur droit, sélectionnez Administration > Tickets.

2. Dans la barre latérale gauche, sélectionnez Permission schemes.

3. Sélectionnez Add permission scheme.

4. Dans la boîte de dialogue Add permission scheme, remplissez les champs.

5. Sélectionnez Ajouter.

6. Sur la page Permission schemes, dans la colonne Actions, sélectionnez Autorisations pour le nouveau schéma.

7. Pour chacune des autorisations suivantes, sélectionnez Éditer, accordez l'autorisation au groupe gitlab-developers, puis sélectionnez Grant :

   • Browse Projects
   • Create Issues
   • Edit Issues
   • Add Comments

Maintenant que vous avez configuré le schéma d'autorisations, il est temps de l'assigner à vos projets Jira.

Assigner le schéma d'autorisations à vos projets {#assign-the-permission-scheme-to-your-projects}

Un schéma d'autorisations n'a aucun effet tant qu'il n'est pas associé à au moins un projet. Répétez ces étapes pour chaque projet Jira auquel vous souhaitez que l'intégration des tickets Jira accède.

Pour assigner le schéma d'autorisations à un projet :

1. Dans le coin supérieur droit, sélectionnez Administration > Projets.
2. Sélectionnez le projet que vous souhaitez configurer.
3. Dans Paramètres du projet, sélectionnez Autorisations.
4. Sélectionnez Actions > Use a different scheme.
5. Sélectionnez le schéma que vous avez créé, puis sélectionnez Associate.

Vous avez réussi ! Rendez-vous maintenant dans GitLab et configurez l'intégration des tickets Jira en utilisant le nom d'utilisateur et le mot de passe gitlab que vous avez créés ici.