Integrate Prisma Cloud with Jira

Learn how to integrate Prisma™ Cloud with Jira and receive Prisma Cloud alerts in your Jira accounts.
Integrate Prisma™ Cloud with Jira and receive Prisma Cloud alert notifications in your Jira accounts. With this integration, you can automate the process of generating Jira tickets with your existing security workflow.
To set up this integration, you need to coordinate with your Jira administrator and gather the inputs needed to enable communication between Prisma Cloud and Jira.
This integration supports Jira Cloud and Jira On-Premises versions 7.2.0 and 7.2.13.
  1. Configure Prisma Cloud in your Jira account.
    1. Login to Jira as a Jira Administrator.
    2. Locate
      Application Links
      .
      For Jira Cloud, select
      Jira Settings
      Products
      Application Links
      .
      jira-cloud.png
      For Jira On-Premises, select
      Settings
      Applications
      Application Links
      .
      jira-on-prem.png
    3. Enter the URL for your instance of Prisma Cloud in
      Configure Application Links
      and
      Create new link
      .
      See Access Prisma Cloud for details on the URL.
      jira-create-application.png
    4. Disregard the message in
      Configure Application URL
      and
      Continue
      .
      jira-configure-application-url.png
    5. Enter the
      Application Name
      and set the
      Application Type
      to
      Generic Application
      .
    6. Create incoming Link
      and
      Continue
      .
      jira-create-incoming-link.png
    7. On
      Link Applications
      , specify a
      Consumer Key
      and a
      Consumer Name
      . Save the
      Consumer Key
      because you will need this value when you enter the information in Prisma Cloud.
      jira-consumer-key.png
    8. Copy the
      Public Key
      shown below and
      Continue
      .
      MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAnYoXB+BZ555jUIFyN+0b3g7haTchsyeWwDcUrTcebbDN1jy5zjZ/vp31//L9HzA0WCFtmgj5hhaFcMl1bCFY93oiobsiWsJmMLgDyYBghpManIQ73TEHDIAsV49r2TLtX01iRWSW65CefBHD6b/1rvrhxVDDKjfxgCMLojHBPb7nLqXMxOKrY8s1yCLXyzoFGTN6ankFgyJ0BQh+SMj/hyB59LPVin0bf415ME1FpCJ3yow258sOT7TAJ00ejyyhC3igh+nVQXP+1V0ztpnpfoXUypA7UKvdI0Qf1ZsviyHNwiNg7xgYc+H64cBmAgfcfDNzXyPmJZkM7cGC2y4ukQIDAQAB
      Prisma Cloud is listed in your Jira account after successful creation.
  2. Setup Jira as one of the integration channels in Prisma Cloud.
    1. Login to Prisma Cloud.
    2. Select
      Settings
      Integrations
      .
    3. + Add New
      integration.
    4. Set
      Integration
      to
      JIRA
      .
    5. Specify a meaningful
      Integration Name
      and, optionally, add a
      Description
      .
    6. Enter the
      JIRA Login URL
      .
      Make sure the URL starts with https and does not have a trailing slash (‘/’) at the end.
    7. Enter the Consumer Key that you created when you created the Prisma Cloud application in Jira and
      Generate Token
      .
      jira-setup-jira-in-prisma-cloud.png
    8. After you see the
      Token Generated
      message, click
      Next
      .
    9. Click the secret key URL link to retrieve your secret key.
      The URL with the verification code is valid for only 10 minutes.
      jira-test-integration-prisma-cloud.png
    10. When redirected to the
      Welcome to JIRA
      page,
      Allow
      Prisma Cloud read and write access to data in your Jira account.
      jira-welcome-to-jira.png
    11. Copy the verification code displayed on the page, paste it as the
      Secret Key
      , and
      Generate Token
      .
      jira-generate-token-on-prisma-cloud.png
    The integration will be listed on the Integrations page.
  3. Create Jira notification templates to configure and customize Prisma Cloud alerts.
    The Jira fields that are defined as mandatory in your project are displayed in the template. The types of fields in Jira (such as text, list, single select check boxes, and option type fields) are supported in Prisma Cloud. If you add any other type of fields as mandatory in Jira (such as date fields), will fail. Do not any Date fields as Mandatory and define any text fields in Jira as free-form text so that alert data is displayed correctly and completely.
    1. Log in to Prisma Cloud.
    2. From
      Alerts
      , select
      Notification Templates
      and
      +Add New
      template.
    3. Enter a
      Template Name
      .
    4. Select an
      Integration
      .
    5. Select your
      Project
      .
      Select the project where you want to see the Prisma Cloud alerts. Because every alert translates to a Jira ticket, as a best practice, create and use a dedicated project for Prisma Cloud ticketing and issue management.
    6. Select your
      Issue Type
      and click
      Next
      .
      jira-notification-template.png
    7. Select the
      Configurable Fields
      that you would like to populate.
      The J fields that are defined as mandatory in your project are already selected and included in the alert.
      Jira-notification-template-configurable-fields.png
    8. Select information that goes in to
      Summary
      and
      Description
      from the alert payload.
    9. Select the
      Reporter
      for your alert from users listed in your Jira project.
      This option is available only if the administrator who set up this integration has the appropriate privileges to modify the reporter settings on Jira.
      jira-notification-template-reporter.png
    10. Click
      Next
      to go to the review dialog and review your selection.
      jira-notification-template-review-template.png
    11. Save
      your changes.
      You can delete or edit the Jira notification from the Notification Template dialog.
      jira-notification-template-list-templates.png
      After you set up the integration, Prisma Cloud performs periodic status checks with Jira red if the Jira Login URL is not reachable or if any request to Jira results in an HTTP 400 or 403 response.
  4. Create an Alert Rule or modify an existing rule to send alerts to Jira.

Related Documentation