diff --git a/docs/organizations/integrations/jira-integration.md b/docs/organizations/integrations/jira-integration.md index c80146dd4e..867d61156d 100644 --- a/docs/organizations/integrations/jira-integration.md +++ b/docs/organizations/integrations/jira-integration.md @@ -4,6 +4,43 @@ Integrate Jira with Codacy to be able to create Jira tickets directly from Codacy findings, and import your Jira issues for [Security and risk management](../managing-security-and-risk.md) to manage them all in one place as security items. +## What permissions does Codacy need from my account? + +Codacy requests only the necessary [permissions/scopes from your Atlassian account](https://developer.atlassian.com/cloud/jira/platform/scopes-for-oauth-2-3LO-and-forge-apps/) to collect and create issues in your Jira instance and [keeps your information secure](https://security.codacy.com/). See below the detailed list of permissions. + + + + + + + + + + + + + + + + + + + + + + + + + + +
Classic scopeDescription
read:jira-userCodacy retrieves the Atlassian account ID and email of the user installing the integration.
read:jira-work and write:jira-work + Codacy retrieves issue details and metadata, and project details, to enable: +
    +
  • Creating Codacy security findings from Jira issues.
  • +
  • Creating and managing issues in Jira from Codacy.
  • +
+
manage:jira-webhookCodacy creates webhooks to be notified of changes in the issues it's managing.
+ ## Installing the Jira integration To install the Jira integration: