Permission Schemes
What are permission schemes?
Permission schemes allow you to limit or extend users' access to information and actions. On External Share for Jira, you can benefit from space (project) and work item (issue) level permission schemes.
You can find out more about permission schemes here.
How to apply permission schemes
As an External Share admin (a Jira admin or a user with the "External Share - Administer app" global permission), you can open the global settings of External Share.
Click on the “Apps” dropdown menu
Select the “External Share” option
Select the “Global settings” option
Select the “Permissions” tab
On the permissions page, you can enable permission schemes.
External Share - Permission scheme
Permission |
Description |
|---|---|
External Share - Administer app |
Makes the user an External Share admin, with the same access as a Jira admin. The user can change all app settings (for example "Global Settings", "API Keys" and "SSO Configuration"), see, edit and delete all shares in the Global View, and work with External Share in every space they can open in Jira, even when permission schemes are enabled. |
External Share - View all shares in Global View |
Lets the user see shares created by other users in the Global View. Access is read-only: the user can edit and delete only their own shares, or the shares the permission scheme lets them manage. |
Jira admins are always External Share admins. They do not need the "External Share - Administer app" permission.
Like a Jira admin, an External Share admin can see and edit shares from spaces they cannot browse in Jira. Pickers in the app (for example spaces and boards) still show only what the user can see in Jira.
Leaving the permission fields empty will deny access to all users.
Jira admins and users with the "External Share - Administer app" global permission always have access to space settings and to all shares, whatever the permission scheme says.
Space administrators must also be granted permissions through the permission scheme to access External Share features. They do not have automatic access. If they can access features without the proper permissions, please report it to our support team.
Do I need to use permission schemes?
Permission schemes help you add permission to different operations for users; if you do not need to customize permissions, default permissions will be respected.
Default permissions
When Jira Permission Scheme is disabled
When groups and space roles are empty, all users will have access to all operations, including space-level access.
When Jira Permission Scheme is enabled
By default, no users have access to External Share operations. The space admin must first add permissions.
Error Message
Once the permission scheme is enabled, if a person without the necessary permissions tries to create, edit, or delete a share, an error message will appear.
Error message “You do not have permission to create share”