Skip to content

Commit 92071ff

Browse files
committed
doc: Section explaining Jira OAuth app permissions [CF-2052]
1 parent c8466a3 commit 92071ff

File tree

1 file changed

+37
-0
lines changed

1 file changed

+37
-0
lines changed

docs/organizations/integrations/jira-integration.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,43 @@
44

55
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.
66

7+
## What permissions does Codacy need from my account?
8+
9+
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.
10+
11+
<table>
12+
<colgroup>
13+
<col width="25%"/>
14+
<col width="75%"/>
15+
</colgroup>
16+
<thead>
17+
<tr>
18+
<th>Classic scope</th>
19+
<th>Description</th>
20+
</tr>
21+
</thead>
22+
<tbody>
23+
<tr>
24+
<td><code>read:jira-user</code></td>
25+
<td>Codacy retrieves the Atlassian account ID and email of the user installing the integration.</td>
26+
</tr>
27+
<tr>
28+
<td><code>read:jira-work</code> and <code>write:jira-work</code></td>
29+
<td>
30+
Codacy retrieves issue details and metadata, and project details, to enable:
31+
<ul>
32+
<li>Creating Codacy security findings from Jira issues.</li>
33+
<li>Creating and managing issues in Jira from Codacy.</li>
34+
</ul>
35+
</td>
36+
</tr>
37+
<tr>
38+
<td><code>manage:jira-webhook</code></td>
39+
<td>Codacy creates webhooks to be notified of changes in the issues it's managing.</td>
40+
</tr>
41+
</tbody>
42+
</table>
43+
744
## Installing the Jira integration
845

946
To install the Jira integration:

0 commit comments

Comments
 (0)