JIRA Service Desk permissions

JIRA Service Desk provides a standard permission scheme (JIRA Service Desk Permission scheme for [project]) that automatically gives your JIRA Service Desk users the correct permissions for the project role they are in.

For example, adding agents to your service desk will add users to the Service Desk Team role. This role gives them access to JIRA Service Desk and also allows them to work on issues. 

This page introduces how the users on the People tab of a service desk match to project roles and the permissions they have. 

On this page

Related pages

What permissions does each role have?

With the standard permission scheme, the different roles on your service desk have different levels of access as shown below. 

Agent - JIRA Service Desk
Agents can:
  • Access both the Customer Portal and the service desk interface in JIRA
  • View the Customer Portal, queues, reports and SLA metrics for the service desks they have access to 
  • Access and edit issues in the service desks they are assigned to
  • Add, edit and delete customer-facing and private comments to issues
  • Manage content in the knowledge base

Customer
Customers can:
  • Create requests and track their own requests
  • Add public comments to their own requests
  • Add attachments to their own requests

Administrator
In addition to what agents can do, administrators can also: 
  • Add agents, collaborators and customers to a service desk
  • Remove agents, collaborators and customers agents from a service desk
  • Configure request types and the Customer Portal
  • Create and edit reports 
  • Create SLAs for measuring progress
  • Connect a Confluence knowledge base to a service desk
  • Configure the email channel a service desk

Collaborator
Collaborators can:
  • View issues, comments and attachments
  • Add attachments and delete their own attachments
  • Add internal comments to issues and delete their own comments
  • Watch and vote for issues

How are permissions associated with each role? 

Each type of user displayed on the People tab of your service desk matches a JIRA project role, and the project permissions for each type of user are assigned to the JIRA project roles in the permission scheme.

To learn about the permissions assigned to each role, see Standard permissions

Table: User and project role mapping

UserJIRA project role
Agentsthe Service Desk Team role
Customers

the Service Desk Customers role

Note: The permissions to this role are granted through the Service Desk Customer - Portal Access security type. The security type checks this role to determine who are customers. For details about this security type, see the following section.

Collaborators

the Service Desk Collaborators role 

Service desk administratorsthe Administrators role


Screenshot: How the users on the People tab map to the JIRA project roles in the JIRA administration console



About the Service Desk Customer - Portal Access security type

The permissions assigned to customers are granted to the Service Desk Customer - Portal Access security type instead of the Service Desk Customers role. The Service Desk Customer - Portal Access security type gives people access to the Customer Portal only (not JIRA). This security type checks the Service Desk Customers role to determine who are customers. So in summary, the security type and the role work hand in hand to make sure that customers get the permissions they need to use the Customer Portal and cannot access JIRA.

For example, if you want your customers to be able to create requests through your Customer Portal, grant the Create Issues permission to the Service Desk Customer - Portal Access security type, not the Service Desk Customers role.

Why does the security type have more permissions than what customers can do?

In the standard permission scheme, the Service Desk Customer - Portal Access security type has more permissions in place than the functionality available for customers to use. For example, the security type has the Edit Own Comments permission, but customers cannot do this on the Customer Portal. This is because JIRA Service Desk built the functions that we think are the most commonly used by service desk customers. We will evaluate the feature requests and expand the functions gradually. With the permissions in place now, future functionality additions to the Customer Portal will be easier because you will not have to modify permission schemes to make use of new functions in most cases. You can join the discussion on new features at our issue tracker:    Getting issues... .

Using custom permission schemes

If you want to customize the standard permission scheme, make sure that the roles have the mandatory permissions. See Using custom permission schemes.

Last modified on Feb 12, 2015

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.