jira_server_configuration.md 3.43 KB
Newer Older
1
---
Kati Paizee's avatar
Kati Paizee committed
2 3
stage: Ecosystem
group: Integrations
4 5 6
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
---

7
# Jira Server credentials **(FREE)**
8

9
To [integrate Jira with GitLab](index.md), you must
10 11 12
create a 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, you must:
13

14 15 16
1. [Create a Jira Server user](#create-a-jira-server-user).
1. [Create a Jira Server group](#create-a-jira-server-group) for the user to belong to.
1. [Create a permission scheme for your group](#create-a-permission-scheme-for-your-group).
17

18
## Create a Jira Server user
19

20
This process creates a user named `gitlab` and adds it to a new group named `gitlab-developers`:
21

22 23 24 25 26 27
1. Sign in to your Jira instance as an administrator.
1. In the upper right corner of the top menu, go to the gear icon and
   select **User Management**.
1. Create a new user account (`gitlab`) with write access to
   projects in Jira.
   - **Email address**: Jira requires a valid email address, and sends a verification
Mike Russo's avatar
Mike Russo committed
28
     email, which is required to set up the password.
29 30 31 32 33 34
   - **Username**: Jira creates the username by using the email prefix. You can change
     this username later.
   - **Password**: You must create a password, because the GitLab integration doesn't
     support SSO, such as SAML. To create the password, visit the user profile, look up
     the username, and set a password.
1. Select **Create user**.
35

36
After you create the user, create a group for it.
37

38
## Create a Jira Server group
39

40 41
After you [create a Jira Server user](#create-a-jira-server-user), you can create a
group to assign permissions to the user:
42

43 44 45
1. Sign in to your Jira instance as an administrator.
1. In the upper right corner of the top menu, go to the gear icon and
   select **User Management**.
46 47
1. From the sidebar, select **Groups**.

48
   ![Jira create new user](img/jira_create_new_group.png)
49 50 51

1. In the **Add group** section, enter a **Name** for the group (for example,
   `gitlab-developers`), and then select **Add group**.
52
1. To add the `gitlab` user to the `gitlab-developers` group, select **Edit members**.
53
   The `gitlab-developers` group should be listed in the leftmost box as a
54 55 56 57 58
   selected group.
1. In the **Add members to selected group(s)** area, enter `gitlab`.
1. Select **Add selected users**.
Jira saves your selection, and `gitlab` should appear in the **Group member(s)**
area.
59

60
![Jira added user to group](img/jira_added_user_to_group.png)
61

62
Next, create a permission scheme for your group.
63

64
## Create a permission scheme for your group
65

66
After creating the group in Jira, grant permissions to the group by creating a permission scheme:
67

68 69 70
1. Sign in to your Jira instance as an administrator.
1. In the upper right corner of the top menu, go to the gear icon and
   select **Issues**.
71 72 73 74
1. From the sidebar, select **Permission Schemes**.
1. Select **Add Permission Scheme**, enter a **Name** and (optionally) a
   **Description**, and then select **Add**.
1. In the permissions scheme list, locate your new permissions scheme, and
75 76
   select **Permissions**.
1. Next to **Administer Projects**, select **Edit**. In
77 78
   the **Group** list, select `gitlab-developers`.

79
   ![Jira group access](img/jira_group_access.png)
80

81 82
Write down the new Jira username and its
password, as you need them when
83
[configuring GitLab](configure.md).