Commit f205ce09 authored by Craig Norris's avatar Craig Norris

Merge branch '324250-move-first-two-pages' into 'master'

Move pages to new subfolder for jira

See merge request gitlab-org/gitlab!57005
parents 5bb08276 b38c5587
---
stage: Create
group: Ecosystem
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
---
# Create an API token in Jira on Atlassian cloud **(FREE)**
For [integrations with Jira](../../user/project/integrations/jira.md), an API token is needed when integrating with Jira
on Atlassian cloud. To create an API token:
1. Log in to [`id.atlassian.com`](https://id.atlassian.com/manage-profile/security/api-tokens) with your email address.
NOTE:
It is important that the user associated with this email address has *write* access
to projects in Jira.
1. Click **Create API token**.
![Jira API token](../../user/project/integrations/img/jira_api_token_menu.png)
1. Click **Copy**, or click **View** and write down the new API token. It is required when [configuring GitLab](../../user/project/integrations/jira.md#configure-gitlab).
![Jira API token](../../user/project/integrations/img/jira_api_token.png)
The Jira configuration is complete. You need the newly created token, and the associated email
address, when [configuring GitLab](../../user/project/integrations/jira.md#configure-gitlab).
---
stage: Create
group: Ecosystem
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
---
# Create Jira Server username and password **(FREE)**
For [integrations with Jira](../../user/project/integrations/jira.md), you must create a user account in Jira to have access to
all projects that need to integrate with GitLab.
The Jira user account created for the integration must have write access to
your Jira projects.
As an example, the following process creates a user named `gitlab` and that's a
member of a new group named `gitlab-developers`:
1. Sign in to your Jira instance as an administrator, and
then go to the gear icon and select **User Management**.
![Jira user management link](../../user/project/integrations/img/jira_user_management_link.png)
1. Create a new user account (for example, `gitlab`) with write access to
projects in Jira. Enter the user account's name and a valid e-mail address,
because Jira sends a verification email to set up the password.
Jira creates the username by using the email prefix. You can change the
username later, if needed. The GitLab integration doesn't support SSO (such
as SAML). You need to create an HTTP basic authentication password. You can
do this by visiting the user profile, looking up the username, and setting a
password.
![Jira create new user](../../user/project/integrations/img/jira_create_new_user.png)
1. From the sidebar, select **Groups**.
![Jira create new user](../../user/project/integrations/img/jira_create_new_group.png)
1. In the **Add group** section, enter a **Name** for the group (for example,
`gitlab-developers`), and then select **Add group**.
1. Add the `gitlab` user to the `gitlab-developers` group by selecting **Edit members**.
The `gitlab-developers` group should be listed in the leftmost box as a
selected group. In the **Add members to selected group(s)** area, enter `gitlab`.
![Jira add user to group](../../user/project/integrations/img/jira_add_user_to_group.png)
Select **Add selected users**, and `gitlab` should appear in the **Group member(s)**
area. This membership is saved automatically.
![Jira added user to group](../../user/project/integrations/img/jira_added_user_to_group.png)
1. To give the newly-created group 'write' access, you must create a permission
scheme. To do this, in the admin menu, go to the gear icon and select **Issues**.
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
select **Permissions**. Next to **Administer Projects**, select **Edit**. In
the **Group** list, select `gitlab-developers`.
![Jira group access](../../user/project/integrations/img/jira_group_access.png)
The Jira configuration is complete. Write down the new Jira username and its
password, as you need them when [configuring GitLab](../../user/project/integrations/jira.md#configure-gitlab).
...@@ -74,13 +74,13 @@ The process for configuring Jira depends on whether you host Jira on your own se ...@@ -74,13 +74,13 @@ The process for configuring Jira depends on whether you host Jira on your own se
Jira Server supports basic authentication. When connecting, a **username and password** are Jira Server supports basic authentication. When connecting, a **username and password** are
required. Connecting to Jira Server via CAS is not possible. For more information, see required. Connecting to Jira Server via CAS is not possible. For more information, see
[set up a user in Jira Server](jira_server_configuration.md). [set up a user in Jira Server](../../../integration/jira/jira_server_configuration.md).
#### Jira on Atlassian cloud #### Jira on Atlassian cloud
Jira on Atlassian cloud supports authentication through an API token. When connecting to Jira on Jira on Atlassian cloud supports authentication through an API token. When connecting to Jira on
Atlassian cloud, an **email and API token** are required. For more information, see Atlassian cloud, an **email and API token** are required. For more information, see
[set up a user in Jira on Atlassian cloud](jira_cloud_configuration.md). [set up a user in Jira on Atlassian cloud](../../../integration/jira/jira_cloud_configuration.md).
### Configure GitLab ### Configure GitLab
......
--- ---
stage: Create redirect_to: '../../../integration/jira/jira_cloud_configuration.md'
group: Ecosystem
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
--- ---
# Create an API token in Jira on Atlassian cloud **(FREE)** This document was moved to [another location](../../../integration/jira/jira_cloud_configuration.md).
For [integrations with Jira](jira.md), an API token is needed when integrating with Jira <!-- This redirect file can be deleted after <2021-06-18>. -->
on Atlassian cloud. To create an API token: <!-- Before deletion, see: https://docs.gitlab.com/ee/development/documentation/#move-or-rename-a-page -->
1. Log in to [`id.atlassian.com`](https://id.atlassian.com/manage-profile/security/api-tokens) with your email address.
NOTE:
It is important that the user associated with this email address has *write* access
to projects in Jira.
1. Click **Create API token**.
![Jira API token](img/jira_api_token_menu.png)
1. Click **Copy**, or click **View** and write down the new API token. It is required when [configuring GitLab](jira.md#configure-gitlab).
![Jira API token](img/jira_api_token.png)
The Jira configuration is complete. You need the newly created token, and the associated email
address, when [configuring GitLab](jira.md#configure-gitlab).
--- ---
stage: Create redirect_to: '../../../integration/jira/jira_server_configuration.md'
group: Ecosystem
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
--- ---
# Create Jira Server username and password **(FREE)** This document was moved to [another location](../../../integration/jira/jira_server_configuration.md).
For [integrations with Jira](jira.md), you must create a user account in Jira to have access to <!-- This redirect file can be deleted after <2021-06-18>. -->
all projects that need to integrate with GitLab. <!-- Before deletion, see: https://docs.gitlab.com/ee/development/documentation/#move-or-rename-a-page -->
The Jira user account created for the integration must have write access to
your Jira projects.
As an example, the following process creates a user named `gitlab` and that's a
member of a new group named `gitlab-developers`:
1. Sign in to your Jira instance as an administrator, and
then go to the gear icon and select **User Management**.
![Jira user management link](img/jira_user_management_link.png)
1. Create a new user account (for example, `gitlab`) with write access to
projects in Jira. Enter the user account's name and a valid e-mail address,
because Jira sends a verification email to set up the password.
Jira creates the username by using the email prefix. You can change the
username later, if needed. The GitLab integration doesn't support SSO (such
as SAML). You need to create an HTTP basic authentication password. You can
do this by visiting the user profile, looking up the username, and setting a
password.
![Jira create new user](img/jira_create_new_user.png)
1. From the sidebar, select **Groups**.
![Jira create new user](img/jira_create_new_group.png)
1. In the **Add group** section, enter a **Name** for the group (for example,
`gitlab-developers`), and then select **Add group**.
1. Add the `gitlab` user to the `gitlab-developers` group by selecting **Edit members**.
The `gitlab-developers` group should be listed in the leftmost box as a
selected group. In the **Add members to selected group(s)** area, enter `gitlab`.
![Jira add user to group](img/jira_add_user_to_group.png)
Select **Add selected users**, and `gitlab` should appear in the **Group member(s)**
area. This membership is saved automatically.
![Jira added user to group](img/jira_added_user_to_group.png)
1. To give the newly-created group 'write' access, you must create a permission
scheme. To do this, in the admin menu, go to the gear icon and select **Issues**.
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
select **Permissions**. Next to **Administer Projects**, select **Edit**. In
the **Group** list, select `gitlab-developers`.
![Jira group access](img/jira_group_access.png)
The Jira configuration is complete. Write down the new Jira username and its
password, as you need them when [configuring GitLab](jira.md#configure-gitlab).
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment