This article should be completed only after these instructions: How to configure the Jira integration for evidence generation

It is possible to configure permissions for specific Jira spaces to grant access to the Complyance service account.

Jira space types

There are two types of spaces in Jira:

1. Team-managed
2. Company-managed

They differ in how their permissions are configured. Therefore, the first step in setting up permissions is to determine which type of space you are working with. In the space navigation panel, click the three dots next to the space you want to configure. At the bottom of the popover, you will see the type of the space.

The following instructions describe how to configure each type of space. Throughout the examples, the service account used for the integration is referred to as Complyance.

Configuring a team-managed space

1. From the main Jira dashboard, click the three dots next to the team-managed space you want to configure, then select Space settings from the popover.

   

2. Select Access.

   

3. On the Access screen, review the current access level.

   Team-managed spaces have three access levels:

   • Open: Anyone on your Jira site can view, create, and edit work items in this space.
   • Limited: Anyone on your Jira site can view and comment on work items, but cannot create or edit them.
   • Private: Only Jira admins and people explicitly added to the space can see the space or its work items.

   

   If the space’s access level is Open or Limited, no further configuration is required. Data in such spaces is visible to all users on your Jira site, including the Complyance service account.

4. If the space’s access level is Private, click the Add people button.

   

5. In the popup, search for the Complyance service account, select the Viewer role, and click Add 1 person.

   

6. Verify that the Complyance service account now appears in the list with the Viewer role.

   

Configuring a company-managed space

Configuring permissions for company-managed spaces requires several steps. After completing them, the Complyance service account will be able to view issues in the space.

1. Creating a space role

1. From the main Jira dashboard, click the cog icon in the top right corner and select System.

   

2. Select Space roles.

   

3. Complete the space role form:

   • Name: Complyance Space Role
   • Description: A space role that represents the Complyance integration

   Click Add Space Role.

   

4. Verify that the Complyance Space Role has been created.

   

2. Updating the permission scheme

1. From the main Jira dashboard, click the three dots next to the company-managed space you want to configure and select Space settings.

   

2. Select Permissions.

   

3. In the top right corner, click the Actions button and choose Edit permissions.

   

4. In the Permission schemes screen, scroll to the Browse Projects permission. Check whether it is granted to Any logged in user. If it is, no further changes are required because the Complyance service account already has access. Otherwise, click Update on the right.

   

5. In the popup, select Space Role, choose Complyance Space Role, and click Update.

   

6. Verify that the space role has been added to the Browse Projects permission.

   

3. Adding the service account to the space

1. From the main Jira dashboard, click the three dots next to the company-managed space you want to configure and select Space settings.

   

2. Select People.

   

3. Click the Add people button.

   

4. In the popup, search for the Complyance service account, assign the Complyance Space Role, and click Add 1 person.

   

5. Verify that the Complyance service account has been added to the space with the Complyance Space Role.