Jira

This is a combined document for enabling the Jira Dropzone Data Source and Alert Source integrations. Dropzone's integration is only with the Jira Cloud, however support for on-prem Jira Datacenter is on the roadmap.

The Dropzone platform supports Jira, a project management and issue tracking tool from Atlassian.

Create an API Key

Jira requires an API key to enable. The API key is associated with an account so you may wish to create a dedicated service user rather than using your own.

To obtain an API Key, do the following:

  • Log into your Jira account e.g. https://mycompany.atlassian.net as the API user for Dropzone AI

  • Click on your user icon and click "Manage Account"

Go to "Manage Account"
  • Navigate to "Security" in the top banner

Navigate to "Security"
  • Under the header "API tokens", click on "Create and manage API tokens"

Click on "Create and manage API tokens"
  • Click on "Create API token"

Create API token
  • Enter a name to identify the API key, such as dropzone.ai, then click "Create"

Create API token
  • Copy the API Token shown for use later in the Dropzone UI where it is called "API Token"

Copy API token

Enable the Dropzone Data Source Integration

The Data source integration allows Dropzone AI to interact with your Jira environment to learn about your specific environment through information found in Jira tickets as part of performing investigations.

You'll need the following information:

Dropzone Field
Source

Server

The same as your company server url in Jira, eg mycompany.atlassian.net

Username

The username of the account that created the API

API Token

The API token value you generated earlier

To enable the Data Source integration, do the following:

  • Navigate to your Dropzone AI tenant home page e.g. https://mycompany.dropzone.app

  • In the bottom left hand corner, click Settings > Integrations

Integrations Dropdown
  • Click "Available"

Click Available
  • In the Search bar, search Jira, then click "Configure"

The Jira Tile
  • Under the Data Source heading, input the Server, Username, and API Token

  • Under "Issue Scan Filter", you may input a Jira JQL query string to filter which issues may be scanned

Fill out the Data Source details
  • Click "Test & Save" to finish

If you have any errors engage your Dropzone AI support representative.

Enable the Dropzone Alert Source Integration

The Alert source integration allows Dropzone AI to interact with your Jira environment to retrieve alerts that were created inside Jira.

You'll need the following information:

Dropzone Field
Source

Server

The same as your company server url in Jira, eg mycompany.atlassian.net

Username

The username of the account that created the API

API Token

The API token value you generated earlier

To enable the Alert Source integration, do the following:

  • Navigate to your Dropzone AI tenant home page e.g. https://mycompany.dropzone.app

  • In the bottom left hand corner, click Settings > Integrations

Integrations Dropdown
  • Click "Available"

Click Available
  • In the Search bar, search Jira, then click "Configure"

The Jira Tile
  • Under the Alert Source heading, input the Server, Username, and API Token

  • In the "Ticket alert workflow" section, select an option from the "Alert Extraction Strategy"

    • ask your Dropzone support representative if you do not know which to use

Fill out the Alert Source details (pt 1)
  • Under "Jira Issue Filter", you must input a Jira JQL search query to identify Jira tickets that contain alerts to investigate

  • Input your desired Poll interval and lookback

Fill out the Alert Source details (pt 2)
  • Click "Test & Save" to finish

If you have any errors engage your Dropzone AI support representative.

Last updated

Was this helpful?