|
| 1 | +--- |
| 2 | +title: Atlassian Jira Cloud |
| 3 | +description: '' |
| 4 | +--- |
| 5 | + |
| 6 | +import useBaseUrl from '@docusaurus/useBaseUrl'; |
| 7 | + |
| 8 | +<img src={useBaseUrl('/img/platform-services/automation-service/app-central/logos/atlassian-jira-v2.png')} alt="atlassian-jira-v2" width="80"/> |
| 9 | + |
| 10 | +***Version: 1.0 |
| 11 | +Updated: March 20 , 2025*** |
| 12 | + |
| 13 | +Jira is a proprietary issue tracking product developed by Atlassian that allows bug tracking and agile project management. |
| 14 | + |
| 15 | +## Actions |
| 16 | + |
| 17 | +* **Add Comment to Issue** *(Notification)* - Add a comment to the specified issue. |
| 18 | +* **Create Issue** (*Notification*) - Create a new issue in the specified Jira project. |
| 19 | +* **Delete Issue** (*Containment*) - Delete the specified issue. |
| 20 | +* **Get Issue** *(Enrichment)* - Returns the details for an issue. |
| 21 | +* **Get Issue Comments** *(Enrichment)* - Get the comments of issue. |
| 22 | +* **List Issue Fields** *(Enrichment)* - List the issue fields. |
| 23 | +* **List Issue Transitions** *(Enrichment)* - Returns either all transitions or a transition that can be performed by the user on an issue, based on the issue's status. |
| 24 | +* **List Issue Types** *(Enrichment)* - List the types of issue. |
| 25 | +* **List Projects** *(Enrichment)* - List the current projects. |
| 26 | +* **List Statuses** *(Enrichment)* - Returns a list of the statuses. |
| 27 | +* **List Users** *(Enrichment)* - Returns a list of all users. |
| 28 | +* **Search Into Issues** *(Enrichment)* - Search Jira Issues. |
| 29 | +* **Update Issue** (*Notification*) - Update the specified issue field with the specified value. |
| 30 | + |
| 31 | +## Atlassian Jira Cloud configuration |
| 32 | + |
| 33 | +Sign in to [Jira](https://id.atlassian.com) with your Atlassian account. |
| 34 | + |
| 35 | +<img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-2.png')} style={{border:'1px solid gray'}} alt="atlassian-jira-v2-2" width="300"/> |
| 36 | + |
| 37 | +## Create an API token |
| 38 | + |
| 39 | +Create an API token from your Atlassian account: |
| 40 | +1. Log in to https://id.atlassian.com/manage-profile/security/api-tokens. |
| 41 | +1. Click **Create API token**. |
| 42 | +1. From the dialog that appears, enter a memorable and concise **Label** for your token and click **Create**. |
| 43 | +1. Click **Copy to clipboard**, then paste the token to your script, or elsewhere to save.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-3.png')} style={{border:'1px solid gray'}} alt="atlassian-jira-v2-3" width="300"/> |
| 44 | + |
| 45 | +## Revoke an API token |
| 46 | + |
| 47 | +A revoked token no longer works and is permanently removed from your account. If you revoke an API token currently being used, you can replace it with a new token. To revoke an API token: |
| 48 | +1. Log in to https://id.atlassian.com/manage-profile/security/api-tokens. |
| 49 | +1. Select **Revoke** next to the API token that you want to revoke. |
| 50 | +1. To revoke all API tokens for your account, select **Revoke all API tokens**. |
| 51 | + |
| 52 | +## Atlassian Jira Cloud in Automation Service and Cloud SOAR |
| 53 | + |
| 54 | +1. Access integrations in the [Automation Service](/docs/platform-services/automation-service/automation-service-integrations/#view-integrations) or [Cloud SOAR](/docs/cloud-soar/automation). |
| 55 | +1. After the list of the integrations appears, search for the integration and click on the row. |
| 56 | +1. The integration details will appear. Click on the **"+"** button to add a new resource.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-4.png')} style={{border:'1px solid gray'}} alt="atlassian-jira-v2-4" width="100"/> |
| 57 | +1. Label and populate all the required fields (\*). |
| 58 | + 1. **Label**. Add a name for the resource. |
| 59 | + 1. **URL API**. Enter your Atlassian site URL. For example, `https://your-atlassian-site.atlassian.net/`. |
| 60 | + 1. **Username**. Enter your email address. |
| 61 | + 1. **API Token**. Insert the previously copied token.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-8.png')} style={{border:'1px solid gray'}} alt="atlassian-jira-v2-8" width="400"/> |
| 62 | +1. Click **SAVE**. |
| 63 | +1. To make sure the resource is working, hover over the resource and then click the **TEST**.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-7.png')} style={{border:'1px solid gray'}} alt="atlassian-jira-v2-7" width="150"/> |
| 64 | +1. You should receive a successful notification in the bottom right corner.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/atlassian-jira-v2/atlassian-jira-v2-6.png')} style={{border:'1px solid gray'}} alt="atlassian-jira-v2-6" width="250"/> |
| 65 | + |
| 66 | +## Category |
| 67 | + |
| 68 | +Ticketing System |
| 69 | + |
| 70 | +## Change Log |
| 71 | + |
| 72 | +* March 20, 2025 - First upload |
0 commit comments