Jira

This is a combined document for enabling the Jira Dropzone Data Source and Alert Source integrations.

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

Dropzone's integration is only with the Jira Cloud, however suppor for on-prem Jira Datacenter is on the roadmap.

Create an API Key

Jira requires an API 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.ai

• Click System > Integrations

Integrations Dropdown

• Click "Data Sources" in the top left corner

Select the "Data Sources" button

• In the Ticketing System section, find the Jira tile and click "Connect"

The Jira Tile

• 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

Test & Save

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

Enable the Dropzone Alert Source Integration

The Data 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.ai

• Click System > Integrations

Integrations Dropdown

• Click "Alert Sources" in the top left corner

Select the "Data Sources" button

• In the Ticketing System section, find the Jira tile and click "Connect"

The Jira Tile

• Input the Server, Username, and API Token

Fill out the Alert Source details

• Under "Jira Issue Filter", you must input a Jira JQL search query to identify Jira tickets that contain alerts to investigate

• Under "Ticket alert workflow" select an option from the "Alert Extraction Strategy"

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

• Click "Test & Save" to finish

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