Atlassian Jira V2

Version: 2.10
Updated: September 2 , 2024

Jira is a proprietary issue tracking product developed by Atlassian that allows bug tracking and agile project management.

Actions

• Add Comment to Issue (Notification) - Add a comment to the specified issue.
• Add Issue Attachments To Incident (Enrichment) - Add attachment from Jira issue to Cloud SOAR Incident.
• Check Issue Status Schedule (Scheduled) - To wait for or check a status update of a Jira ticket/issue.
• Create Issue (Notification) - Create a new issue in the specified Jira project.
• Delete Issue (Containment) - Delete the specified issue.
• Download Attachment (Enrichment) - Returns the contents of an attachment in an encoded format that can be used for further analysis selecting output.raw in your playbooks.
• Get Issue (Enrichment) - Returns the details for an issue.
• Issues Jira Daemon (Daemon) - Daemon to pull Jira issues.
• List Issue Types (Enrichment) - List issue types.
• List Issue Fields (Enrichment) - List the issue fields.
• List Projects (Enrichment) - List the current projects.
• List Statuses (Enrichment) - Returns a list of the statuses.
• List 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.
• List Users (Enrichment) - Returns a list of all users
• Search Into Issues (Enrichment) - Search Jira Issues.
• Update Issue (Notification) - Update the specified issue field with the specified value.
• Update Transition Issue (Notification) - Update transition issue based on the issue's status.

Atlassian Jira V2 configuration

Sign in to Jira with your Atlassian account.

Create an API token

Create an API token from your Atlassian account:

1. Log in to https://id.atlassian.com/manage-profile/security/api-tokens.
2. Click Create API token.
3. From the dialog that appears, enter a memorable and concise Label for your token and click Create.
4. Click Copy to clipboard, then paste the token to your script, or elsewhere to save.
   

Revoke an API token

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:

1. Log in to https://id.atlassian.com/manage-profile/security/api-tokens.
2. Select Revoke next to the API token that you want to revoke.
3. To revoke all API tokens for your account, select Revoke all API tokens.

Atlassian Jira V2 in Automation Service and Cloud SOAR

1. Access integrations in the Automation Service or Cloud SOAR.
2. After the list of the integrations appears, search for the integration and click on the row.
3. The integration details will appear. Click on the "+" button to add a new resource.
   
4. Label and populate all the required fields (*).
   1. Label. Add a name for the resource.
   2. URL API. Enter your Atlassian site URL. For example, https://your-atlassian-site.atlassian.net/.
   3. Username. Enter your email address.
   4. API Token. Insert the previously copied token.
      
5. Optional fields in the resource are used for actions.
   • Populate Jira Project Name when using the Issues Jira Daemon action.
   • Populate Cloud SOAR API URL and Cloud SOAR JWT (token) when using the Add Issue Attachment To Incident action.
6. Click SAVE.
7. To make sure the resource is working, hover over the resource and then click the TEST.
   
8. You should receive a successful notification in the bottom right corner.
   

Category

Ticketing System

Change Log

• June 22, 2022 - First upload
• December 19, 2022
  • Solved an issue for which the Search Into Issues action could not work correctly searching by JQL
  • Added hint for Host
• March 27, 2023 (v2.2)
  • Updated integration: (Updated the integration Fields with Environmental Variables and improved error handling)
  • Deprecated Endpoint updated
  • Changed action type from Containment to Notification
• June 27, 2023 (v2.3) - Removed leading/trailing spaces
• June 28, 2023 (v2.4) - Visibility of the Resource fields changed
• July 4, 2023 (v2.5)
  • Updated Actions:
    • Create Issue
    • Update Issue
    • Update Issue Status
• May 2, 2024 (v2.6) - A new scheduled action has been added for Jira integration to wait for/check the status update of a Jira ticket
• May 13, 2024 (v2.7) - A new JSON Custom field has been added to update the issue status Action
• May 23, 2024 (v2.8) - Updated the Add Issue Attachments To Incident action
• June 20, 2024 (v2.9) - New action: Download Attachment
• September 2, 2024 (v2.10) - Updated the Update Issue action