Skip to content

Commit 1e9885d

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

File tree

1 file changed

+33
-0
lines changed

1 file changed

+33
-0
lines changed

docs/organizations/integrations/jira-integration.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,39 @@
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+
</tbody>
38+
</table>
39+
740
## Installing the Jira integration
841

942
To install the Jira integration:

0 commit comments

Comments
 (0)