About this Article

This article describes how to do the following:

• Integrate Jira with Prisma Cloud DSPM
• Create Jira mapping fields
• Create a Jira ticket via Prisma Cloud DSPM

Jira Overview

Jira is a proprietary issue tracking product developed by Atlassian that allows bug tracking and agile project management. Integrating Jira with Prisma Cloud DSPM allows you to create Jira tickets based on alerts received by Prisma Cloud DSPM. This enables seamless streamlining of your incident management workflow, and ensures efficient issue tracking and resolution.

Prerequisite

To integrate Jira with Prisma Cloud DSPM, ensure that you have a Jira account with admin privileges.

Integrate Jira With Prisma Cloud DSPM

Step 1 - In Jira

In this step, you need to create an API token in your Jira account to use it later in the integration process. To do so, follow the instructions here.

Step 2 - In Prisma Cloud DSPM

1. Go to Preferences > Integrations.
2. Under Jira, click Connect.
   
3. Add a new Jira integration:
   1. For Client ID, enter the email address of the user who created the API key
   2. For Client Secret, enter the API token you created in step 1.
   3. For Subdomain, enter the prefix of your Jira environment in atlassian (XXX.atlassian.com).
4. Click Connect.
   

Create Jira Mapping Fields

The DSPM - Jira Mapping feature allows users to map relevant information directly from DSPM into Jira tickets. Additionally, users can manually customize data within various fields, providing greater flexibility and control:

Key Features:

• Direct Mapping: Seamlessly transfer pertinent information from DSPM to Jira tickets.
• Field Customization: Manually adjust data in different fields to suit specific needs.
• Drop-down Selection: Enjoy a user experience similar to Jira UI by selecting field values from drop down lists

Mapping Procedure

1. In the Jira window, click on the Connection to open the Jira side drawer.
   
   
2. In the side drawer, choose a project and issue type. The Field mapping view opens in the side draw. The displayed fields are Jira fields related to the selected project and issue type.
   
3. Customize the Jira integration by choosing a risk finding field in the Jira ticket.
   For example, configure the Summary field in Jira to display the name of DSPM risk finding.
   Fields that are not mapped are not displayed when a Jira ticket is opened by a user via the DSPM platform.
   Each project and issue type displays a different set of fields that can be used for mapping.
   
   Alternatively, add custom text to the Jira ticket. In the drop-down lists, click + Add custom text and enter free text. The free text is displayed in the Jira ticket.
   Note that the Jira fields that prompt you to select an option from the drop-down menu are also displayed for mapping and the admin can select the requested value.
   
4. Click Save.

Create a Jira Ticket via Prisma Cloud DSPM

This section describes how to create a Jira ticket, via the DSPM platform, for every Risk finding detected by Prisma Cloud DSPM.

1. Create a New Jira Ticket in DSPM
   1. Go to the Risks page and select the Findings display.
   2. Select a risk to open it, then select Create Jira ticket from the top right corner.
2. Select a pair (Project and Issue Type). In the Create Jira ticket window, select the relevant pair (project and issue type) from the available options. A pair comprises an Issue Type and Project. For example, Compliance is the name of the issue type and Data is the name of the project.
   
3. Display Configured Jira Fields
   1. Only the Jira fields that have been configured for the selected project and issue type will be displayed.
4. Edit Field Values
   1. The user can:
      • Choose a value from a list pulled from Jira.
      • Manually edit the field value defined by the admin during the mapping phase.
      • Reset any field to its automatically configured value.
5. Send the Jira Ticket
   1. Click Create to submit the Jira ticket. The ticket will be sent to Jira, where the user can view it.
   2. After you create a Jira ticket for a risk finding, the Jira logo will be displayed next to this risk. Click the logo to view the ticket in Jira.
      
      
6. View the Jira Ticket Status
   1. After sending a Jira ticket, do the following to view the status of the ticket.
      • Go to Risks > Findings, and hover over Backlog. The Jira ticket number is displayed.
      • Click the Jira ticket number to review the ticket and its status. (Note that the various Jira ticket statuses are defined by the organization.)
        
        
7. Error Handling
   1. If any errors occur during configuration or ticket creation, clear and meaningful error messages are displayed to assist with troubleshooting.