Skip to main content

Integrate a new Jira Data Center source

info

For now, only real-time scanning is supported to detect secrets in issues and comments. All detectors are supported, with the exception of these 2 generic detectors, in order to limit the risk of false positives:

Setting up and configuring this integration is limited to users with an Owner or Manager access level. Jira Data Center site installation is only open to workspaces under the Business plan, but uninstallation is open to all. Alternatively, you can install and test secret detection in Jira Data Center with a 30-day trial. Any secret incidents created during this period will remain accessible in your incident dashboard after the trial period.

GitGuardian integrates natively with Jira Data Center via an administrator Personal Access Token that you can create from your Jira Data Center sites. Note that GitGuardian only has read access to your projects.

Setup your Jira Data Center integration

You can install GitGuardian on multiple Jira Data Center sites to monitor your projects.

  1. Make sure you're logged as an administrator in the Jira Data Center site you want to install
  2. Go to the Profile page Jira Data Center profile
  3. Go to the Personal Access Tokens section and click Create token to create a new PAT Jira Data Center PAT
  4. Provide a Token Name, an optional Expiry date and click CreateJira Data Center PAT form
  5. Copy your new PAT and click CloseJira Data Center PAT copy
  6. In the GitGuardian platform, navigate to the Integrations page
  7. Click on the Install button on the Jira Data Center card in the Ticketing section Jira Data Center card
  8. Click on the Install button of the Jira Data Center integration page
  9. Paste your Jira Data Center site URL, your Administrator Personal Access Token and click AddJira Data Center integration

That's it! Your Jira Data Center site is installed and we are now monitoring all issues and comments of your projects for secrets.

info

Jira allows the creation of up to 10 PATs. GitGuardian automatically renews PATs before they expire. To do this, you must have at least 2 PAT slots free. Otherwise, an error message will warn you that the integration is no longer functional.

Uninstall your Jira Data Center site

To uninstall a Jira Data Center site:

  1. In the GitGuardian platform, navigate to the Integrations page
  2. Click on the Jira Data Center card in the Ticketing section
  3. Click on the bin icon next to the Jira Data Center site to be uninstalled
  4. Confirm by clicking on the Yes, uninstall button in the confirmation modal Jira Data Center uninstall

That's it! Your Jira Data Center site is now uninstalled.

Privacy

Country-specific laws and regulations may require you to inform your Jira Data Center users that your projects are being scanned for secrets. Here is a suggestion for a message you may want to use:

As part of our internal information security process, the company scans the Jira Data Center projects for potential secrets leaks using GitGuardian. All data collected will be processed for the purpose of detecting potential leaks. To find out more about how we manage your personal data and to exercise your rights, please refer to our employee/partner privacy notice. Please note that only projects relating to the company’s activity and business may be monitored and that users shall refrain from sharing personal or sensitive data not relevant to the project’s purpose.

How can I help you ?