2019-09-30 21:07:59 +05:30
|
|
|
# Creating a username and password for Jira Server
|
2018-12-13 13:39:08 +05:30
|
|
|
|
|
|
|
We need to create a user in Jira which will have access to all projects that
|
2019-09-04 21:01:54 +05:30
|
|
|
need to integrate with GitLab.
|
2018-12-13 13:39:08 +05:30
|
|
|
|
|
|
|
As an example, we'll create a user named `gitlab` and add it to the `Jira-developers`
|
|
|
|
group.
|
|
|
|
|
|
|
|
NOTE: **Note**
|
2019-09-04 21:01:54 +05:30
|
|
|
It is important that the Jira user created for the integration is given 'write'
|
|
|
|
access to your Jira projects. This is covered in the process below.
|
2018-12-13 13:39:08 +05:30
|
|
|
|
2019-09-04 21:01:54 +05:30
|
|
|
1. Log in to your Jira instance as an administrator and under **Jira Administration**
|
2018-12-13 13:39:08 +05:30
|
|
|
go to **User Management** to create a new user.
|
|
|
|
|
2019-09-30 21:07:59 +05:30
|
|
|

|
2018-12-13 13:39:08 +05:30
|
|
|
|
2019-02-15 15:39:39 +05:30
|
|
|
1. The next step is to create a new user (e.g., `gitlab`) who has write access
|
2018-12-13 13:39:08 +05:30
|
|
|
to projects in Jira. Enter the user's name and a _valid_ e-mail address
|
|
|
|
since Jira sends a verification e-mail to set up the password.
|
|
|
|
_**Note:** Jira creates the username automatically by using the e-mail
|
2019-02-15 15:39:39 +05:30
|
|
|
prefix. You can change it later, if needed. Our integration does not support SSO (such as SAML). You will need to create
|
2019-09-30 21:07:59 +05:30
|
|
|
an HTTP basic authentication password. You can do this by visiting the user
|
|
|
|
profile, looking up the username, and setting a password._
|
2018-12-13 13:39:08 +05:30
|
|
|
|
2019-09-30 21:07:59 +05:30
|
|
|

|
2018-12-13 13:39:08 +05:30
|
|
|
|
2019-09-04 21:01:54 +05:30
|
|
|
1. Create a `gitlab-developers` group. (We will give this group write access to Jira
|
|
|
|
projects in a later step). Go to the **Groups** tab on the left, and select **Add group**.
|
2018-12-13 13:39:08 +05:30
|
|
|
|
2019-09-30 21:07:59 +05:30
|
|
|

|
2018-12-13 13:39:08 +05:30
|
|
|
|
2019-09-30 21:07:59 +05:30
|
|
|
Give it a name and click **Add group**.
|
2018-12-13 13:39:08 +05:30
|
|
|
|
2019-09-04 21:01:54 +05:30
|
|
|
1. Add the `gitlab` user to the `gitlab-developers` group by clicking **Edit members**.
|
|
|
|
The `gitlab-developers` group should be listed in the leftmost box as a selected group.
|
|
|
|
Under **Add members to selected group(s)**, enter `gitlab`.
|
2018-12-13 13:39:08 +05:30
|
|
|
|
2019-09-30 21:07:59 +05:30
|
|
|

|
|
|
|
|
2019-09-04 21:01:54 +05:30
|
|
|
Click **Add selected users** and `gitlab` should appear in the **Group member(s)** box.
|
|
|
|
This membership is saved automatically.
|
2019-09-30 21:07:59 +05:30
|
|
|
|
|
|
|

|
2019-09-04 21:01:54 +05:30
|
|
|
|
|
|
|
1. To give the newly-created group 'write' access, you need to create a **Permission Scheme**.
|
|
|
|
To do this, click the gear icon and select **Issues**. Then click **Permission Schemes**.
|
|
|
|
Click **Add Permission Scheme** and enter a **Name** and, optionally, a **Description**.
|
2019-09-30 21:07:59 +05:30
|
|
|
|
2019-09-04 21:01:54 +05:30
|
|
|
1. Once your permission scheme is created, you'll be taken back to the permissions scheme list.
|
2019-09-30 21:07:59 +05:30
|
|
|
Locate your new permissions scheme and click **Permissions**. Next to **Administer Projects**,
|
2019-09-04 21:01:54 +05:30
|
|
|
click **Edit**. In the resulting dialog box, select **Group** and select `gitlab-developers`
|
|
|
|
from the dropdown.
|
2018-12-13 13:39:08 +05:30
|
|
|
|
2019-09-30 21:07:59 +05:30
|
|
|

|
2018-12-13 13:39:08 +05:30
|
|
|
|
|
|
|
The Jira configuration is complete. Write down the new Jira username and its
|
|
|
|
password as they will be needed when [configuring GitLab in the next section](jira.md#configuring-gitlab).
|