Jira Data Center Destination (Beta)

Configuring Jira Data Center as an alert destination in your Panther Console

Overview

The Jira Data Center Destination is in open beta starting with Panther version 1.112, and is available to all customers. Please share any bug reports and feature requests with your Panther support team.

Destinations are integrations that receive alerts from rules, policies, system health notifications, and rule errors. Panther supports configuring self-hosted Jira Data Center as the destination where you will receive alerts.

When an alert is forwarded to a Jira Data Center destination, a bug, story, or task is created in the specified project with the specified assignee.

This page explains how to set up a Jira Data Center destination. See the instructions for setting up a Jira Cloud destination here.

How to set up Jira Data Center alert destinations in Panther

This integration authenticates with your Jira instance using a personal access token—you will create one below, in Step 1. All Jira tickets originating from Panther will display as having been created by the user who owns this access token. As such, it is recommended to first create a new Jira user (with a descriptive name) solely for this purpose, and then use that user to create the access token.

To complete this prerequisite, you must be logged in as a Jira user who has permissions to create users.

  1. In your Jira console, navigate to the User Management page.

  2. Click Create user.

  3. On the Create a new user page, fill in the form:

    • Email address: Enter a unique email address a Jira administrator will have access to.

    • Full name: Enter a descriptive name, e.g. Panther Bot.

    • Username: Enter a descriptive name, e.g. pantherbot.

    • Password: Enter a password an administrator will be able to use to authenticate with.

    • Send notification email: This field can be unchecked.

    • Application access: Select Jira Software.

    A "Create new user" form is shown, with various fields, including "Email address," "Full name," and "Username." At the bottom is a "Create user" button.
  4. Click Create user.

  5. Log in as this newly created user and proceed to the next step.

Step 1: Create a personal access token in Jira Data Center

  1. In your Jira console, navigate to your user profile.

    • It is recommended to be logged in as the user you created during the Prerequisite.

  2. In the left-hand navigation bar, click Personal Access Tokens.

  3. Click Create token.

  4. In the Token Name field, enter a descriptive name.

  5. Under Expiry Date, uncheck the Automatic expiry checkbox.

  6. Click Create.

  7. Copy your personal access token, and store it in a secure location. You will need it in the next step.

Step 2: Configure the Jira Data Center alert destination in Panther

  1. In the left-hand navigation bar of your Panther Console, click Configure > Alert Destinations.

  2. Click +Add your first Destination.

    • If you have already created Destinations, click Create New in the upper right side of the page to add a new Destination.

  3. Click Jira Data Center.

  4. Fill out the form:

    • Display Name: Enter a descriptive name.

    • Organization Domain: Enter your organization's Jira domain (e.g. https://jira.example.com).

    • Issue Type: Enter the Jira Issue Type you would like to created. This can be Bug, Story, Task, or any custom type.

    • Project Key: Enter the Jira project identifier within your organization.

      • You can find this in Jira in your project settings page, or by browsing your organization's Jira projects and locating the key column.

    • Email: Enter the email address of the Jira user who has permissions to create the new issues with the corresponding Jira API Key.

      • It is recommended to use the email address of the user created during the Prerequisite.

    • Jira API Token: Enter the API token you generated in the earlier steps of this documentation.

    • Severity Levels: Select the severity level of alerts to send to this destination.

    • Default Alert Types: Select the alert types to send to this destination.

    • Log Types: By default, we will send alerts from all log types. Specify log types here if you want to only send alerts from specific log types.

      Under a title reading "Configure your Jira Data Center Destination" is a form with various fields, including Display Name, Issue Type, and Severity.
  5. Click Continue.

Step 3: Configure Jira issue properties

  1. On the Configure Jira Issue Properties page, fill out the form:

    • Assignee Username: Select the user that issues will be assigned to.

      • The users available in this dropdown field are pulled from your Jira instance.

    • Label and prioritize issues based on severity level: Enable this if you would like to apply labels and a priority level in Jira based on alert severity in Panther. If disabled, you can still set labels and a priority level globally i.e., not based on severity). The labels and priority levels available in these dropdown are pulled from your Jira instance. If you create a new label in the Labels dropdown, it will also be created in your Jira instance.

      • If set to ON: For each severity level, specify the Labels and Priority.

      A "Label and prioritize issues based on severity level" toggle is shown as ON. Underneath is a list of Panther severity levels. Each one has an arrow to a Labels field and Priority field.
      • If set to OFF: Specify the Labels and Priority for all Jira issues created by Panther.

    A "Label and prioritize issues based on severity level" toggle is shown as OFF. Under it are two form fields: Labels and Priority.
  2. Click Add Destination.

    • On the final page, optionally click Send Test Alert to test the integration. When you are finished, click Finish Setup.

Additional Information on Destinations

For more information on alert routing order, modifying or deleting destinations, and workflow automation, please see the Panther docs: Destinations.

Last updated

Was this helpful?