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 scope | +Description | +
|---|---|
read:jira-user |
+ Codacy 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:
+
|
+
manage:jira-webhook |
+ Codacy creates webhooks to be notified of changes in the issues it's managing. | +