debian-mirror-gitlab/doc/integration/jira/jira_server_configuration.md

stage	group	info
Manage	Import and Integrate	To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments

Jira Server credentials (FREE)

To integrate Jira with GitLab, you should create a separate Jira user account for your Jira projects to access projects in GitLab. This Jira user account must have write access to your Jira projects. To create the credentials:

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

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

After you select a Jira user account, configure the integration in GitLab to use the account.

Create a Jira Server user

To create a Jira Server user:

1. Sign in to your Jira instance as a Jira administrator.
2. On the top bar, in the upper-right corner, select the gear icon, then select User Management.
3. Create a new user account manually with write access to projects in Jira.
   • Email address: You should use a valid email address.
   • Username: Set the username to gitlab.
   • Password: You must set a password because the Jira issue integration does not support SSO such as SAML.
4. 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 Server group for the user

To create a Jira Server group for the user:

1. Sign in to your Jira instance as a Jira administrator.
2. On the top bar, in the upper-right corner, select the gear icon, then select User Management.
3. On the left sidebar, select Groups.
4. In the Add group section, enter a Name for the group (for example, gitlab-developers), then select Add group.
5. To add the gitlab user to the gitlab-developers group, select Edit members. The gitlab-developers group appears as a selected group.

1. In the Add members to selected group(s) section, enter gitlab.
2. 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. Sign in to your Jira instance as a Jira administrator.
2. On the top bar, in the upper-right corner, select the gear icon, then select Issues.
3. On the left sidebar, select Permission Schemes.
4. Select Add Permission Scheme, enter a Name and (optionally) a Description, then select Add.
5. In the permissions scheme list, locate your new permissions scheme, and select Permissions.
6. Next to Administer Projects, select Edit.
7. From the Group dropdown list, select gitlab-developers, then select Grant.

You need the new Jira username and password when you configure the integration in GitLab.