How to create dedicated user with limited access

How to create dedicated user with limited access

How to create dedicated user with limited access

How to create dedicated user with limited access

Screenful needs to access your project data in Jira in order to populate the dashboards. The recommended solution is to use credentials of an existing user that is known to have access to the Jira agile board. If this is not possible or desirable, follow the steps below to set permissions so that you can limit the access to only those projects that you need to. 

Notice that you need an Administrator level permissions in order to perform the tasks below!

Screenful needs to access your project data in Jira in order to populate the dashboards. The recommended solution is to use credentials of an existing user that is known to have access to the Jira agile board. If this is not possible or desirable, follow the steps below to set permissions so that you can limit the access to only those projects that you need to. 

Notice that you need an Administrator level permissions in order to perform the tasks below!

Screenful needs to access your project data in Jira in order to populate the dashboards. The recommended solution is to use credentials of an existing user that is known to have access to the Jira agile board. If this is not possible or desirable, follow the steps below to set permissions so that you can limit the access to only those projects that you need to. 

Notice that you need an Administrator level permissions in order to perform the tasks below!

Create a new user and a user group

  1. Go to User Management

  2. Create new user for Screenful (using an email address that you own)

  3. Create an "integrations" usergroup (no permissions to start).

  4. Assign Screenful user as a member of the integrations group

Create a new user and a user group

  1. Go to User Management

  2. Create new user for Screenful (using an email address that you own)

  3. Create an "integrations" usergroup (no permissions to start).

  4. Assign Screenful user as a member of the integrations group

Grant Jira access for the user group

  1. Select Applications from the Jira Administration menu on top right corner

  2. Select Application access from the left menu

  3. Click on Add group and then grant access.

Now the newly created user can log in but cannot see or access any projects in Jira. To grant visibility to projects, you now need to assign the group to each of the projects that the user needs to see. 

Grant Jira access for the user group

  1. Select Applications from the Jira Administration menu on top right corner

  2. Select Application access from the left menu

  3. Click on Add group and then grant access.

Now the newly created user can log in but cannot see or access any projects in Jira. To grant visibility to projects, you now need to assign the group to each of the projects that the user needs to see. 

Assign the user group to a project

  1. Click on Projects

  2. Select the project by clicking the name

  3. Select Users and roles from the left side menu

  4. Add user group to a role by assigning Group to Role on project menu

  5. Make sure that the selected permission scheme for the project allows Project Role to Browse projects.

Note that the Permission Scheme, while global, is being applied to this project specifically. Giving the user "browse on projects" will only apply to projects on which they have been assigned a role (see 2 above). So this new user can only in fact browse this specific project.


Assign the user group to a project

  1. Click on Projects

  2. Select the project by clicking the name

  3. Select Users and roles from the left side menu

  4. Add user group to a role by assigning Group to Role on project menu

  5. Make sure that the selected permission scheme for the project allows Project Role to Browse projects.

Note that the Permission Scheme, while global, is being applied to this project specifically. Giving the user "browse on projects" will only apply to projects on which they have been assigned a role (see 2 above). So this new user can only in fact browse this specific project.


Repeat with all the projects included in the agile board

The filter query associated with an agile board defines which projects are used as a source for issues to be included in the board. In order to see all the issues, the user must have access to all those projects. Therefore, you need to look at the filter query and repeat step 3 (Assign group to a project) with all the projects included in the query. 

That's it! You can test this now by logging in as Screenful user. You should be able to access the project and its issues. 

If you're using self-hosted Jira, you also need to make sure that the Jira API is accessible from outside your network.

Repeat with all the projects included in the agile board

The filter query associated with an agile board defines which projects are used as a source for issues to be included in the board. In order to see all the issues, the user must have access to all those projects. Therefore, you need to look at the filter query and repeat step 3 (Assign group to a project) with all the projects included in the query. 

That's it! You can test this now by logging in as Screenful user. You should be able to access the project and its issues. 

If you're using self-hosted Jira, you also need to make sure that the Jira API is accessible from outside your network.

Common questions

I've done the step above but still can't access the tasks in the board?
Please check your board filter settings