Atlassian Jira

Details
Content
Dependencies
Version History

Use the Jira integration to manage issues and create Cortex XSOAR incidents from Jira projects.

This pack enables you to manage issues in Jira and exchange information between Jira and Cortex XSOAR.

What does this pack do?

This pack enables you to

Create, edit, delete, and query Jira issues.
Add information to Jira issues in the form of links, comments, and attachments.
Get information concerning boards, and sprints.
Create Cortex XSOAR incidents from Jira issues.
Mirror information from Jira to Cortex XSOAR and vice versa.

The pack includes the Atlassian Jira v2, and Atlassian Jira v3 integration, the Jira Incident, and JiraV3 Incident incident type, incident fields, incident layouts to display all of the Jira information, and 6 scripts:

JiraCreateIssue-example: Simplifies the process of creating a new issue in Jira.
JIRAPrintIssue: Prints a Jira issue in the War Room.
script-JiraChangeTransition: Gets the new Jira status and updates the Cortex XSOAR incident status by applying a transition.
script-JiraListTransition: Lists all possible transitions for a given issue.
script-JiraChangeStatus: Gets the new Jira status and updates the Cortex XSOAR incident status by choosing a specific status.
script-JiraListStatus: Lists all possible statuses for a given issue.

How does this pack work?

Create an instance of the Atlassian Jira v2, or Atlassian Jira v3 integration and start fetching and ingesting incidents.

This pack enables you to manage issues in Jira and exchange information between Jira and Cortex XSIAM.

What does this pack do?

This pack enables you to

Create, edit, delete, and query Jira issues.
Add information to Jira issues in the form of links, comments, and attachments.
Get information concerning boards, and sprints.
Create Cortex XSIAM incidents from Jira issues.
Mirror information from Jira to Cortex XSIAM and vice versa.

JiraCreateIssue-example: Simplifies the process of creating a new issue in Jira.
JIRAPrintIssue: Prints a Jira issue in the War Room.
script-JiraChangeTransition: Gets the new Jira status and updates the Cortex XSIAM incident status by applying a transition.
script-JiraListTransition: Lists all possible transitions for a given issue.
script-JiraChangeStatus: Gets the new Jira status and updates the Cortex XSIAM incident status by choosing a specific status.
script-JiraListStatus: Lists all possible statuses for a given issue.

How does this pack work?

Create an instance of the Atlassian Jira v2, or Atlassian Jira v3 integration and start fetching and ingesting incidents.

Automations

Name	Description
JiraV3ConvertAttachmentsToTable	This script is used to convert Jira attachments to a table.
JiraV3ConvertCommentsToTable	This script is used to convert Jira comments to a table.
JiraV3ConvertSubtasksToTable	This script is used to convert Jira subtasks to a table.
JiraCreateIssue-example	This script is used to simplify the process of creating a new Issue in Jira. You can specify custom fields using the `customFields` argument.
JiraAddComment	Use this script to add a comment with a tag (the "Comment tag to Jira" defined in the instance configuration) as an entry in XSOAR, which will then be mirrored as a comment to a Jira issue. This script should be run within an incident.
JiraListStatus	This script lists all possible statuses for a given Jira issue. Works only for Jira v3.
JiraChangeStatus	This script changes the status field of a Jira incident. It gets the new Jira status of the remote Jira issue and updates the Cortex XSOAR incident status.
script-JiraChangeTransition	This script applies the transition supplied by the user from the Jira Transitions incident field. It gets the new Jira status after applying the transition and updates the Cortex XSOAR incident status.
JIRAPrintIssue	Pretty print JIRA issue into the incident war room
script-JiraListTransition	This script lists all possible transitions for a given Jira issue.

Classifiers

Name	Description
classifier-mapper-incoming-JiraV2	Jira V2 mirror in classifier.
classifier-mapper-outgoing-Jira	Jira V2 mirror out classifier.
classifier-mapper-incoming-JiraV3	Jira V3 mirror in classifier.
JiraV3 Outgoing Mapper

Incident Fields

Name	Description
Jira Estimate	The estimated timeline of a Jira issue in seconds. Please take a look at your `Time tracking settings` in Jira to identify what is considered an hour and a week.
Jira Reporter Email
Jira Transitions
Jira Summary	The issue's summary
Jira Issue Key
Jira Component	The components of a Jira issue.
Jira Status	The name of the status
Jira Issue Type	The issue type of the Jira issue.
Jira ID
Jira Comment	The comments returned from a Jira issue.
Jira Subtask	The subtasks of a Jira issue.
Created Time
Jira Labels
Jira Priority	The issue's priority
Jira Due Date	The due date for the issue (in the format 2018-03-11)
Jira Project	The Jira project where the issue resides in.
Jira Attachments
Jira Description	This issue's description
Jira Reporter Name
JiraV3 Status	This will show the current status of the Jira issue, and when pressed, a list of possible statuses will be shown.

Incident Types

Name	Description
JiraV3 Incident
Jira Create Issue and Mirror
Jira Incident

Integrations

Name	Description
Atlassian Jira v3	Use the Jira integration to manage issues, create Cortex XSOAR incidents from Jira projects, and mirror issues to existing issue incidents in Cortex XSOAR. The integration now supports both OnPrem, and Cloud instances.
Atlassian Jira v2 (Deprecated)	Deprecated. Use the Atlassian Jira v3 integration instead

Layouts

Name	Description
JiraV3 Incident Layout
Jira Incident Layout

Playbooks

Name	Description
Jira Ticket State Polling	Use Jira Incident State Polling as a sub-playbook when required to pause the execution of a master playbook until the Jira ticket state is either resolved or closed. This playbook implements polling by continuously running the jira-get-issue command until the state is either resolved or closed.
Mirror Jira Ticket	Mirror Jira Ticket is designed to serve as a sub-playbook, which enables ticket mirroring with Jira.
Create Jira Issue	Create Jira issue allows you to open new issues. When creating the issue, you can decide to update based on on the issue's state, which will wait for the issue to resolve or close with StatePolling. Alternatively, you can select to mirror the Jira issue and incident fields. To apply either of these options, set the SyncTicket value in the playbook inputs to one of the following options: StatePolling Mirror Leave Blank to use none When creating Jira issues through XSOAR, using the mirroring function, make sure that you exclude those issues when fetching incidents. To exclude these issues, tag the relevant issues with a dedicated label and exclude that label from the JQL query (Labels!=).

Automations

Name	Description
JiraV3ConvertAttachmentsToTable	This script is used to convert Jira attachments to a table.
JiraCreateIssue-example	This script is used to simplify the process of creating a new Issue in Jira. You can specify custom fields using the `customFields` argument.
JiraV3ConvertSubtasksToTable	This script is used to convert Jira subtasks to a table.
script-JiraListTransition	This script lists all possible transitions for a given Jira issue.
script-JiraChangeTransition	This script applies the transition supplied by the user from the Jira Transitions incident field. It gets the new Jira status after applying the transition and updates the Cortex XSIAM incident status.
JiraChangeStatus	This script changes the status field of a Jira incident. It gets the new Jira status of the remote Jira issue and updates the Cortex XSIAM incident status.
JiraAddComment	Use this script to add a comment with a tag (the "Comment tag to Jira" defined in the instance configuration) as an entry in XSOAR, which will then be mirrored as a comment to a Jira issue. This script should be run within an incident.
JiraV3ConvertCommentsToTable	This script is used to convert Jira comments to a table.
JIRAPrintIssue	Pretty print JIRA issue into the incident war room
JiraListStatus	This script lists all possible statuses for a given Jira issue. Works only for Jira v3.

Classifiers

Name	Description
JiraV3 Outgoing Mapper
classifier-mapper-outgoing-Jira	Jira V2 mirror out classifier.
classifier-mapper-incoming-JiraV2	Jira V2 mirror in classifier.
classifier-mapper-incoming-JiraV3	Jira V3 mirror in classifier.

Incident Fields

Name	Description
Jira Issue Type	The issue type of the Jira issue.
Jira ID
Jira Summary	The issue's summary
Jira Reporter Name
Jira Reporter Email
Jira Comment	The comments returned from a Jira issue.
Jira Priority	The issue's priority
Jira Estimate	The estimated timeline of a Jira issue in seconds. Please take a look at your `Time tracking settings` in Jira to identify what is considered an hour and a week.
Jira Status	The name of the status
Jira Component	The components of a Jira issue.
Jira Attachments
Jira Transitions
Jira Description	This issue's description
Jira Labels
Jira Project	The Jira project where the issue resides in.
Jira Issue Key
JiraV3 Status	This will show the current status of the Jira issue, and when pressed, a list of possible statuses will be shown.
Jira Due Date	The due date for the issue (in the format 2018-03-11)
Jira Subtask	The subtasks of a Jira issue.

Incident Types

Name	Description
Jira Create Issue and Mirror
Jira Incident
JiraV3 Incident

Integrations

Name	Description
Atlassian Jira v2 (Deprecated)	Deprecated. Use the Atlassian Jira v3 integration instead
Jira Event Collector	Jira logs event collector integration for Cortex XSIAM.
Atlassian Jira v3	Use the Jira integration to manage issues, create Cortex XSIAM incidents from Jira projects, and mirror issues to existing issue incidents in Cortex XSIAM. The integration now supports both OnPrem, and Cloud instances.

Modeling Rules

Name	Description
JiraEventCollector

Parsing Rules

Name	Description
Jira Parsing Rule

Playbooks

Name	Description
Create Jira Issue	Create Jira issue allows you to open new issues. When creating the issue, you can decide to update based on on the issue's state, which will wait for the issue to resolve or close with StatePolling. Alternatively, you can select to mirror the Jira issue and alert fields. To apply either of these options, set the SyncTicket value in the playbook inputs to one of the following options: StatePolling Mirror Leave Blank to use none When creating Jira issues through XSOAR, using the mirroring function, make sure that you exclude those issues when fetching alerts. To exclude these issues, tag the relevant issues with a dedicated label and exclude that label from the JQL query (Labels!=).
Mirror Jira Ticket	Mirror Jira Ticket is designed to serve as a sub-playbook, which enables ticket mirroring with Jira.
Jira Ticket State Polling	Use Jira Alert State Polling as a sub-playbook when required to pause the execution of a master playbook until the Jira ticket state is either resolved or closed. This playbook implements polling by continuously running the jira-get-issue command until the state is either resolved or closed.

Required Content Packs (3)

Pack Name	Pack By
Base	By: Cortex XSOAR
Common Playbooks	By: Cortex XSOAR
Common Scripts	By: Cortex XSOAR

Optional Content Packs (1)

Pack Name	Pack By
Common Types	By: Cortex XSOAR

All level dependencies (6)

Pack Name	Pack By
Base	By: Cortex XSOAR
Filters And Transformers	By: Cortex XSOAR
Common Playbooks	By: Cortex XSOAR
Rasterize	By: Cortex XSOAR
Cortex REST API	By: Cortex XSOAR
Common Scripts	By: Cortex XSOAR

3.1.14 - 962639 (April 17, 2024)

Integrations

Atlassian Jira v3

Fixed an issue where the files that were uploaded to Jira were automatically classified as type application-type instead of their specific mime type.
Updated the Docker image to: demisto/btfl-soup:1.0.1.91405.

Related pull requests:
- 33746

Download

3.1.13 - 927547 (April 1, 2024)

Changes are not relevant for XSOAR marketplace.

Related pull requests:
- 33663

Download

3.1.12 - 909962 (March 24, 2024)

Integrations

Atlassian Jira v3

Added a new command jira-issue-delete-file to delete attachment file from an issue.
Updated the Docker image to: demisto/btfl-soup:1.0.1.89280.

Related pull requests:
- 33315

Download

3.1.11 - 898707 (March 18, 2024)

Integrations

Atlassian Jira v3

Documentation and metadata improvements.

Related pull requests:
- 33378

Download

3.1.10 - 824222 (February 13, 2024)

Integrations

Atlassian Jira v3

Updated the documentation for the issue_json argument in the jira-create-issue and jira-edit-issue commands.
Updated the jira-create-issue command. Will now fail when providing the issue_json argument with another argument.
Updated the jira-edit-issue command. Will now fail when providing the issue_json argument with another argument except status, transition, action, issue_id, and issue_key.
Updated the Docker image to: demisto/btfl-soup:1.0.1.87353.

Related pull requests:
- 32818

Download

3.1.9 - 778227 (January 22, 2024)

Locked dependencies of the pack to ensure stability for versioned core packs. No changes in this release.

Related pull requests:
- 32331

Download

3.1.8 - 778086 (January 22, 2024)

Integrations

Atlassian Jira v3

Fixed an issue where the command jira-edit-issue could not apply a transition, or status, with other arguments in the same request.
Updated the Docker image to: demisto/btfl-soup:1.0.1.85862.

Related pull requests:
- 32041

Download

3.1.7 - 752611 (January 9, 2024)

Scripts

JiraV3ConvertCommentsToTable

Updated the Docker image to: demisto/python3:3.10.13.83255.

JiraCreateIssue-example

Updated the Docker image to: demisto/python3:3.10.13.83255.

JiraListStatus

Updated the Docker image to: demisto/python3:3.10.13.83255.

JiraV3ConvertSubtasksToTable

Updated the Docker image to: demisto/python3:3.10.13.83255.

JiraChangeStatus

Updated the Docker image to: demisto/python3:3.10.13.83255.

script-JiraChangeTransition

Updated the Docker image to: demisto/python3:3.10.13.83255.

script-JiraListTransition

Updated the Docker image to: demisto/python3:3.10.13.83255.

JiraV3ConvertAttachmentsToTable

Updated the Docker image to: demisto/python3:3.10.13.83255.

JiraAddComment

Updated the Docker image to: demisto/python3:3.10.13.83255.

Related pull requests:
- 32030

Download

3.1.6 - 7209615 (December 19, 2023)

Integrations

Atlassian Jira v3

Fixed an issue where the jira-create-issue command required the summary argument even when it is passed through the issue_json argument.
Updated the Docker image to: demisto/btfl-soup:1.0.1.83338.

Related pull requests:
- 31487

Download

3.1.5 - 6935568 (November 19, 2023)

Integrations

Atlassian Jira v2 (Deprecated)

Added the resolution argument to the jira-edit-issue command when closing an issue.

Related pull requests:
- 30960

Download

3.1.4 - 6780549 (November 2, 2023)

Integrations

Atlassian Jira v3

Added the command jira-issue-assign to allow updating an issue assignee without the need for permission to edit the issue fields.
Updated the Docker image to: demisto/btfl-soup:1.0.1.79197.

Related pull requests:
- 30512
- 29838

Download

3.1.3 - 6674581 (October 22, 2023)

Integrations

Atlassian Jira v3

Updated the Docker image to: demisto/btfl-soup:1.0.1.78954.

Related pull requests:
- 30290

Download

3.1.2 - R6592021 (October 13, 2023)

Integrations

Atlassian Jira v2 (Deprecated)

Deprecated. Use the Atlassian Jira v3 integration instead.

Playbooks

Create Jira Issue

Added support for Jira v3 integration.

Related pull requests:
- 29649

Download

3.1.1 - 6285754 (September 10, 2023)

Jira

Locked dependencies of the pack to ensure stability for versioned core packs. No changes in this release.

Related pull requests:
- 29466

Download

3.1.0 - 6253250 (September 6, 2023)

Integrations

Atlassian Jira v3

Updated the Docker image to: demisto/btfl-soup:1.0.1.72793.
Added support for Basic Authentication used for both Cloud and On-premise.

Related pull requests:
- 29288

Download

3.0.12 - 6234071 (September 4, 2023)

Integrations

Atlassian Jira v2

Added support for additional arguments in the jira-get-organizations command:

projectKey: An ID or key for a service project to list all organizations associated with.
start: Start index for the returned objects. 0 by default.
limit: Maximum amount of organizations to list. 50 by default.
accountId: Account ID of the user, which uniquely identifies the user across all Atlassian products. For example, 5b10ac8d82e05b22cc7d4ef5.

Related pull requests:
- 29420
- 29217

Download

3.0.11 - 6166488 (August 27, 2023)

Changes are not relevant for XSOAR marketplace.

Related pull requests:
- 29191

Download

3.0.10 - 5969979 (August 6, 2023)

Jira

Locked dependencies of the pack to ensure stability for versioned core packs. No changes in this release.

Related pull requests:
- 28753

Download

3.0.9 - 5876761 (July 26, 2023)

Integrations

Atlassian Jira v3

Updated the documentation on how to acquire the Cloud ID when configuring Jira Cloud.

Related pull requests:
- 28506

Download

3.0.8 - R5866730 (July 25, 2023)

Scripts

JiraV3ConvertCommentsToTable

Updated the Docker image to: demisto/python3:3.10.12.63474.

JiraCreateIssue-example

Updated the Docker image to: demisto/python3:3.10.12.63474.

JiraListStatus

Updated the Docker image to: demisto/python3:3.10.12.63474.

JiraV3ConvertSubtasksToTable

Updated the Docker image to: demisto/python3:3.10.12.63474.

JiraChangeStatus

Updated the Docker image to: demisto/python3:3.10.12.63474.

script-JiraChangeTransition

Updated the Docker image to: demisto/python3:3.10.12.63474.

script-JiraListTransition

Updated the Docker image to: demisto/python3:3.10.12.63474.

JiraV3ConvertAttachmentsToTable

Updated the Docker image to: demisto/python3:3.10.12.63474.

JiraAddComment

Updated the Docker image to: demisto/python3:3.10.12.63474.

Related pull requests:
- 28192

Download

3.0.6 - 5740912 (July 11, 2023)

Integrations

Atlassian Jira v3

Fixed an issue where the integration returned an error when fetching by ID, and the issue index to start fetching incidents from is not found in the Jira instance.
Added the argument query to the command jira-get-id-offset, which enables the user to get the ID offset with respect to the given query.

Related pull requests:
- 27774

Download

3.0.5 - 5698017 (July 6, 2023)

Jira

Updated the pack to be on the Xpanse marketplace.

Related pull requests:
- 27944
- 27923

Download

3.0.4 - R5692327 (July 5, 2023)

Integrations

Atlassian Jira v2

Updated the description of the integration.

Atlassian Jira v3

Updated the description of the integration.
Updated the Docker image to: demisto/btfl-soup:1.0.1.63668.

Related pull requests:
- 27762

Download

3.0.3 - 5560707 (June 18, 2023)

Integrations

Atlassian Jira v2

Added the following new commands:
- jira-get-organizations
- jira-add-user-to-project
- jira-get-project-role
Updated the Docker image to: demisto/oauthlib:1.0.0.63821.

Related pull requests:
- 27523
- 27431

Download

3.0.2 - 5450895 (June 5, 2023)

Changes are not relevant for XSOAR marketplace.

Related pull requests:
- 27218

Download

3.0.1 - 5447040 (June 5, 2023)

Integrations

Atlassian Jira v3

Updated the Docker image to: demisto/btfl-soup:1.0.1.61451.

Related pull requests:
- 27219

Download

3.0.0 - 5318720 (May 21, 2023)

Incident Fields

Jira Description
Jira Due Date
Created Time
Jira Labels
Jira ID
Jira Priority
Jira Attachments
Jira Summary
Jira Issue Key
Jira Reporter Email
Jira Reporter Name
Jira Transitions
Added the Incident Field: Jira Comment.
Added the Incident Field: JiraV3 Status.
Added the Incident Field: Jira Subtask.
Added the Incident Field: Jira Component.
Added the Incident Field: Jira Estimate.
Added the Incident Field: Jira Project.
Added the Incident Field: Jira Issue Type.

Incident Types

New: JiraV3 Incident
Added the new incident type corresponding to the new Atlassian Jira v3 integration.

Integrations

New: Atlassian Jira v3

Added the following new commands:
- jira-issue-get-attachment
- jira-issue-delete-comment
- jira-issue-edit-comment
- jira-issue-list-fields
- jira-issue-to-backlog
- jira-issue-to-board
- jira-board-list
- jira-board-backlog-list
- jira-board-issue-list
- jira-board-sprint-list
- jira-board-epic-list
- jira-sprint-issue-list
- jira-sprint-issue-move
- jira-epic-issue-list
- jira-issue-link-type-get
- jira-issue-to-issue-link
Improved implementation of the mirroring process, utilizing the use of tags in order to differentiate between comments, and attachments, coming from Jira, and to Jira.
You can now fetch by the updated time of the Jira issue.
Added support for OAuth2.0 for both Cloud, and OnPrem instances.
Improved implementation of the jira-get-issue command, added details of the Jira issue's attachments to context data, and added a new argument, fields, which gives users the ability to enter the fields they want to retrieve, and adds it to context data.
Improved implementation of the jira-get-comments command, added the comments' IDs to context data, and a limit argument, giving the user to limit the number of comments to return.
Improved implementation of the jira-edit-issue command, the user can choose an action, append or rewrite, which gives them the ability to append new data to specific fields, or overwrite them. Currently, the user can append data to the labels, and components fields.
Updated the jira-get-id-by-attribute command, it does not require the is_jirav2api argument.
Updated the jira-create-issue, and jira-edit-issue commands, the argument issueJson will override the other arguments supplied to the commands.
Updated the jira-get-issue command, supplying the get_attachments argument with the value true will return the attachments found in the specified issue as Entry Info File, and not as File.

Layouts

New: JiraV3 Incident Layout
Added support for changing the status of the issue from the incident info, using the JiraV3 Status Incident Field.
Added a table to show the comments of the Jira issue.
Added a table to show the subtasks of the Jira issue.
Added a button that gives the user to create a note and tag it, without the need of going to the War Room to tag it.

Mappers

New: JiraV3 Outgoing Mapper

Added support for mirroring out the following Incident Fields:
- Jira Estimate.
- Jira Component.

New: classifier-mapper-incoming-JiraV3

Added support for mirroring in the following Incident Fields:
- Jira Estimate.
- Jira Component.
- Jira Issue Type.
- Source Created By.
- Jira Subtask.
- Jira Project.
- JiraV3 Status.

Scripts

New: JiraListStatus

You can now view all possible statuses for the Jira issue from the incident info. (Available from Cortex XSOAR 5.0.0).

New: JiraV3ConvertCommentsToTable

You can now view all the comments of the Jira issue in a table. (Available from Cortex XSOAR 6.8.0).

New: JiraChangeStatus

You can now update the status of the Jira issue from the incident info. (Available from Cortex XSOAR 5.0.0).

New: JiraV3ConvertSubtasksToTable

You can now view all the subtasks of the Jira issue in a table. (Available from Cortex XSOAR 6.8.0).

New: JiraV3ConvertAttachmentsToTable

You can now view all the attachments of the Jira issue in a table. (Available from Cortex XSOAR 6.8.0).

New: JiraAddComment

You can now press a button that gives lets you create a note and tag it, without the need of going to the War Room to tag it. (Available from Cortex XSOAR 6.8.0).

script-JiraChangeTransition

You can now use this script with the Jira v3 integration.

script-JiraListTransition

You can now use this script with the Jira v3 integration.

Related pull requests:
- 24267

Download

2.0.36 - 5289877 (May 17, 2023)

Integrations

Atlassian Jira v2

Added support for handling an exception in languages other than English, when connecting to Jira versions earlier than 9.
Updated the Docker image to: demisto/oauthlib:1.0.0.58909.

Related pull requests:
- 26578

Download

2.0.35 - 5189071 (May 4, 2023)

Integrations

Atlassian Jira v2

Added the command jira-issue-assign which allows to edit the assignee of an existing issue.
Updated the Docker image to: demisto/oauthlib:1.0.0.57204.

Related pull requests:
- 26306
- 26087

Download

2.0.34 - 5176833 (May 3, 2023)

Changes are not relevant for XSOAR marketplace.

Related pull requests:
- 26259

Download

2.0.33 - R5170573 (May 2, 2023)

Changes are not relevant for XSOAR marketplace.

Related pull requests:
- 25937

Download

PUBLISHER

Cortex

PLATFORMS

Cortex XSOARCortex XSIAM

INFO

Certification	Certified	Read more
Supported By	Cortex
Created	September 24, 2020
Last Release	April 17, 2024

WORKS WITH THE FOLLOWING INTEGRATIONS:

DISCLAIMER

Content packs are licensed by the Publisher identified above and subject to the Publisher’s own licensing terms. Palo Alto Networks is not liable for and does not warrant or support any content pack produced by a third-party Publisher, whether or not such packs are designated as “Palo Alto Networks-certified” or otherwise. For more information, see the Marketplace documentation.