Managing global permissions
This table lists the different global permissions and the functions they secure:
Global Permission | Explanation |
---|---|
JIRA System Administrators | Permission to perform all JIRA administration functions. |
JIRA Administrators | Permission to perform most JIRA administration functions. Note that a user with the JIRA Administrators permission will be able to log in at any time, but may have restricted functions depending on their application access. |
Browse Users | Permission to view a list of all JIRA user names and group names, share issues, and @mention people on issues. Used for selecting users/groups in popup screens. Enables auto-completion of user names in most 'User Picker' menus and popups. Note that the Assign User permissions also allows a limited version of this on a per-project basis. |
Create Shared Objects | Permission to share a filter or dashboard globally or with groups of users. Also used to control who can create an agile board. |
Manage Group Filter Subscriptions | Permission to manage (create and delete) group filter subscriptions. |
Bulk Change | Permission to execute the bulk operations within JIRA: |
Granting global permissions
- Choose > System.
- Select Global Permissions to open the Global Permissions page, which lists JIRA's global permissions.
The Add Permission box is shown at the bottom of the list (not displayed in the screen capture above). - In the Permission drop-down list, select the global permission you wish to grant.
- In the Group drop-down list, either:
- select the group to which you wish to grant the permission; or
- if you wish to grant the permission to non logged-in users, select Anyone. This is not recommended for production systems, or systems that can be accessed from the public Internet such as Cloud.
Please Note:If you have reached your user limit, you will be able to create new users but it won't have login permission.
- JIRA admin doesn't consume a license unless they've been granted specific JIRA application access. See Licensing and application access.
Removing global permissions
- Choose > System.
- Select Global Permissions to open the Global Permissions page, which lists JIRA's global permissions.
- For each global permission in JIRA (indicated on the left of this page), groups which currently have that permission are shown on the right (under the Users / Groups column).
- Locate the global permission you want to remove from a group as well as the group you want to remove that permission from (under Users / Groups) and click the Delete link next to that group.
About JIRA System Administrators and JIRA Administrators
People who have the JIRA System Administrators permission can perform all of the administration functions in JIRA, while people who have only the JIRA Administrators permission cannot perform functions which could affect the application environment or network. This separation is useful for organizations which need to delegate some administrative privileges (e.g. creating users, creating projects) to particular people, without granting them complete rights to administer the JIRA system.
Here is a list of administration tasks that only JIRA System Administrators (not JIRA Administrators) can perform:
- View or manage tasks from the the Systems menu.
- Configure JIRA's SMTP mail server for notifications (but they can configure POP/IMAP mail servers for the receipt of email messages that create issue comments and new issues, and fully administer email notification schemes).
- Configure a CVS source code repository (but they can associate a project with a configured repository).
- Configure listeners.
- Configure services (except for POP/IMAP services).
- Configure issue cloning.
- Change the index path (but they can reindex and optimize the index).
- Run the integrity checker.
- Access logging and profiling information.
- Access the scheduler.
- Export/backup JIRA data to XML.
- Import/restore JIRA data from XML.
- Import XML workflows into JIRA.
- Configure attachments (note that JIRA Administrators can set the size limits of attachments, enable thumbnails, and enable ZIP support).
- Add gadgets to the gadget directory.
- Configure user directories (e.g. LDAP).
- Configure Application Links that use an authentication type other than OAuth.
- View user sessions.
- Access license details.
- Grant/revoke the JIRA System Administrators global permission.
- Edit (or Bulk Edit) groups that have the JIRA System Administrators global permission.
- Edit, change the password of or delete a user who has the JIRA System Administrators global permission.
- Upload and/or install an add-on.
It is recommended that people who have the JIRA Administrators permission (and not the JIRA System Administrators permission) are not given direct access to the JIRA filesystem or database.
Separating JIRA System Administrators from JIRA Administrators in default JIRA installations
By default, the jira-administrators
groups has both the JIRA Administrators permission and the JIRA System Administrators permission. Also by default, the user account created during the JIRA setup wizard is a member of this jira-administrators
group.
If you need some people to have only the JIRA Administrators permission (and not the JIRA System Administrators permission), you will need to use two separate groups, e.g.:
- Create a new group (e.g. called
jira-system-administrators
). - Add to the
jira-system-administrators
group everyone who needs to have the JIRA System Administrators permission. - Grant the JIRA System Administrators permission to the
jira-system-administrators
group. - Remove the JIRA System Administrators permission from the
jira-administrators
group. - (Optional, but recommended for ease of maintenance) Remove from the
jira-administrators
group everyone who is a member of thejira-system-administrators
group.
Troubleshooting permissions with the JIRA admin helper
The JIRA admin helper can help you diagnose why a user can or cannot see a certain issue.
Note: For all of the following procedures, you must be logged in as a user with the JIRA Administrators global permission.
- Choose > System.
- Select Permission helper.
- Enter the username of the user (leave blank for anonymous users), an issue key (for example, an issue that the user can/cannot see) and the permission to check.
- Click Submit.