Documentation

Repository/Integration Project Permissions

Integrations and/or repositories can be associated with one or more Jira projects to restrict which users can view development information. All newly-connected repositories or integrations are associated with all Jira projects by default.

Project permissions in repository settings

Restrict to projects – One or more projects can be mapped to this repository to make Git Commits tabs available in the Issue pages of the associated projects.

Associate with all projects – Enable this option to associate this repository to all projects. Disable this option if you want to use the existing mapped projects from the Restrict to projects field. The default setting is enabled (checked).

Jira Server / Data Center

Click the Advanced twisty to see the option to enable/disable limitation of commits shown in Git Commits tab in Jira issue pages, Git Commits page and all across the Git Integration for Jira app by project association.

This only applies when project associations are set. If the Associate with all projects option is enabled, this feature is ignored.

If this option is enabled for a git repository and there are project associations set, the git data is not shown from that repository in any project except those from the project association list.

Unless the issue is from a project association list, some data are not shown such as:

  • Commits, branches and tags in the Issue sidebar.
  • Commits in Git Commits tab.
  • Commits in Git Commits page.
  • Commits and branches in Git Roll Up tab.
  • Commits in Project/Issue pages.
  • Commits in Compare pages. User read/view permission restriction also applies.

Limit git data for upgrade and installation defaults:

ConditionRepositoryResult
Upgrade to new app versionHas several repositories with project associationsDefaults to OFF because there is no sudden change in behavior
Upgrade to new app versionAdds a new repository and set project associationsDefaults to ON because it is a new repository
Installs app for the first timeAdds a new repository and set project associationsDefaults to ON because it is a new repository

There are several types of project permission levels, namely:

  • Repository level
  • Integration level
  • Repository level within integration

Repository Level

You can configure the project permissions for single connection repositories:

  1. On the git repository configuration page, click Actions > Edit repository settings.
  2. On the page that appears, scroll down to Project Permissions.
  3. Uncheck (turn off) the Associate with all projects setting.
  4. Click on the Restrict to projects field then select one or more projects from the list.
  5. Click Update to save the settings.

The same process can also be applied for single repository connections in Jira Cloud.

Integration level

You can configure the project permissions for integration (multiple repository connection):

  1. On the git repository configuration page, click Actions > Edit integration feature settings.
  2. On the page that appears, scroll down to Project Permissions.
  3. Uncheck (turn off) the Associate with all projects setting.
  4. Click on the Restrict to projects field then select one or more projects from the list.
  5. Click Update to save the settings.

The same process can also be applied for integration connections in Jira Cloud -- Actions > Edit integration settings.

Repository level within Integration

You can configure the project permissions for repositories within integration:

  1. On the git repository configuration page, click Actions > Show integration repositories.The Tracked folder dialog is dispayed. Click a repository name to open its repository settings.
  2. On the page that appears, scroll down to Project Permissions.
  3. Uncheck (turn off) the Associate with all projects setting.
  4. Click on the Restrict to projects field then select one or more projects from the list.
  5. Click Update to save the settings.

The same process can also be applied for integration connections in Jira Cloud -- Actions > Show integration repositories.

Setting Project Permissions in Jira Cloud

Project permissions are now available in Git Integration for Jira Cloud. The default setting for new repository/integration connections is Associated with all Jira projects.

Watch the video below to learn different settings for each project permissions level.

Get new product notifications and feature updates from BigBrassBand LLC.

Subscribe to our mailing list