Tutorial: Create Jira credentials

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

This tutorial shows you how to create Jira credentials. You can use your new Jira credentials to configure the Jira issue integration in GitLab for Jira Data Center or Jira Server.

To create Jira credentials, here’s what we’re going to do:

  1. Create a Jira user.
  2. Create a Jira group for the user.
  3. Create a permission scheme for the group.

Prerequisites:

Create a Jira user

To create a Jira user:

  1. On the top bar, in the upper-right corner, select Administration ( ) > User management.
  2. Create a new user account with write access to your Jira projects.

    Alternatively, you can use an existing user account, provided the user belongs to a Jira group that has been granted the Administer Projects permission scheme.

    • In Email address, enter a valid email address.
    • In Username, enter gitlab.
    • In Password, enter a password (the Jira issue integration does not support SSO such as SAML).
  3. Select Create user.

Now that you’ve created a user named gitlab, it’s time to create a group for the user.

Create a Jira group for the user

To create a Jira group for the user:

  1. On the top bar, in the upper-right corner, select Administration ( ) > User management.
  2. On the left sidebar, select Groups.
  3. In the Add group section, enter a name for the group (for example, gitlab-developers), then select Add group.
  4. To add the gitlab user to the new gitlab-developers group, select Edit members. The gitlab-developers group appears as a selected group.
  5. In the Add members to selected group(s) section, enter gitlab.
  6. Select Add selected users. The gitlab user appears as a group member.

Now that you’ve added the gitlab user to a new group named gitlab-developers, it’s time to create a permission scheme for the group.

Create a permission scheme for the group

To create a permission scheme for the group:

  1. On the top bar, in the upper-right corner, select Administration ( ) > Issues.
  2. On the left sidebar, select Permission schemes.
  3. Select Add permission scheme.
  4. On the Add permission scheme dialog:
    • Enter a name for the scheme.
    • Optional. Enter a description for the scheme.
  5. Select Add.
  6. On the Permission schemes page, in the Actions column, select Permissions for the new scheme.
  7. Next to Administer Projects, select Edit.
  8. On the Grant permission dialog, for Granted to, select Group.
  9. From the Group dropdown list, select gitlab-developers, then select Grant.

You’ve done it! You can now use your new Jira username and password to configure the Jira issue integration in GitLab for Jira Data Center or Jira Server.