# AQUILA - Atlassian Account Integration

##### <span style="color: rgb(53, 152, 219);">**What are API token scopes?**</span>

<span style="color: rgb(0, 0, 0);">Scopes define what actions an API token is allowed to perform in Atlassian apps such as Jira and Confluence. They provide security by limiting the permissions of the token. You can create tokens with scopes (recommended) or without scopes (for apps that do not support scoped tokens).</span>

##### <span style="color: rgb(53, 152, 219);">**Creating an API token with scopes:**</span>

1. <span style="color: rgb(0, 0, 0);">Log in to <span style="color: rgb(132, 63, 161);">[https://id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens)</span></span>
2. <span style="color: rgb(0, 0, 0);">Select "Create API token with scopes"</span>
3. <span style="color: rgb(0, 0, 0);">Enter a descriptive name for the token (for example: AQUILA - Monitoring)</span>
4. <span style="color: rgb(0, 0, 0);">Choose an expiration date for the token (between 1 and 365 days)</span>
5. <span style="color: rgb(0, 0, 0);">Select the application (Jira or Confluence)</span>
6. <span style="color: rgb(0, 0, 0);">Select the scopes or permissions the token should have</span>
    
    
    - <span style="color: rgb(0, 0, 0);">Example for Jira: **read:audit-log:jira**</span>
    - <span style="color: rgb(0, 0, 0);">Example for Confluence: **read:audit-log:confluence**</span>
7. <span style="color: rgb(0, 0, 0);">Click "Create"</span>
8. <span style="color: rgb(0, 0, 0);">Copy the token and save it securely. You cannot view it again after this step. If you lose it, you will need to generate a new token.</span>

<p class="callout warning">**<span style="color: rgb(0, 0, 0);">Required credentials for Jira Integration access:</span>**</p>

- <span style="color: rgb(0, 0, 0);">**API URL**: Base Jira API URL without the path</span>
- <span style="color: rgb(0, 0, 0);">**Jira User Identifier**: Your Atlassian email address</span>
- <span style="color: rgb(0, 0, 0);">**Jira API Token**: The API token you created</span>

<span style="color: rgb(0, 0, 0);">*If you need further assistance, kindly contact our support at* <span style="color: rgb(53, 152, 219);">***support@cytechint.com***</span> *for prompt assistance and guidance.*</span>