# Jira

{% hint style="info" %}
Dropzone's integration is only with the Jira Cloud, however support for on-prem Jira Datacenter is on the roadmap.
{% endhint %}

The Dropzone platform supports [Jira](https://confluence.atlassian.com/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"

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-d239955709976d5e8637f1a094f033676c27ba17%2Fjira-api-1.png?alt=media" alt=""><figcaption><p>Go to "Manage Account"</p></figcaption></figure>

* In the top banner, bavigate to "Security"

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-06c21d74638e650f7531136d40ecef9316e34bcb%2Fjira-api-2.png?alt=media" alt=""><figcaption><p>Navigate to "Security"</p></figcaption></figure>

* Under "API tokens," click "Create and manage API tokens"

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-aa2f366ad17e77ec9c6e601a47ada76b5e7bcc61%2Fjira-api-3.png?alt=media" alt=""><figcaption><p>Click "Create and manage API tokens"</p></figcaption></figure>

* Click "Create API token"

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-6ce3d14da3dfad1d3ccd8c319ba0ec39eeff2458%2Fjira-api-4.png?alt=media" alt=""><figcaption><p>Create API token</p></figcaption></figure>

* Enter a name to identify the API key, such as Dropzone.ai, then click "Create"

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-350922c9d77840f85e3f1cdd01df953e26fd73f5%2Fjira-api-5.png?alt=media" alt=""><figcaption><p>Create API token</p></figcaption></figure>

* Store the API token shown in a secure location for use later in the Dropzone UI where it is called "API Token"

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-b0bcbdcb8639ef47cb47e4fdaabab46be0d2a0a4%2Fjira-api-6.png?alt=media" alt=""><figcaption><p>Copy API token</p></figcaption></figure>

## Enable Jira

To enable the Alert Source integration, you will 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, navigate to Settings > Integrations

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-b3f07f902b1402dadc7abbd8bb62f9c204547390%2Fui-integrations-dropdown.png?alt=media" alt=""><figcaption><p>Integrations Dropdown</p></figcaption></figure>

* Click "Available"

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-434641ec6d4e45051842f86164f485d6bd289424%2Fapp_system_integrations_available.png?alt=media" alt=""><figcaption><p>Click Available</p></figcaption></figure>

* In the Search bar, search Jira, then click "Configure"

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-629cd7d3151e9cd038782a890b1086f0bdf89195%2Fapp_system_integrations_available_Jira.png?alt=media" alt=""><figcaption><p>The Jira Tile</p></figcaption></figure>

* 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

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-112dec04a83a31ecfa35f9e36a21d73a1fc98dd3%2Fapp_system_integrations_available_jira_alert_config_1.png?alt=media" alt=""><figcaption><p>The Jira Alert Source configuration (pt 1)</p></figcaption></figure>

* Under "Jira Issue Filter," you must input a Jira [JQL](https://support.atlassian.com/jira-service-management-cloud/docs/use-advanced-search-with-jira-query-language-jql/) search query to identify Jira tickets that contain alerts to investigate
* If you want Dropzone to push its investigation results back to Jira, check the box labeled "Comment Investigation Results to ticket"
* Input your desired Poll interval and lookback

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-38635dc78316b125ac1c472ec1c4c0c920045e45%2Fapp_system_integrations_available_jira_alert_config_2.png?alt=media" alt=""><figcaption><p>The Jira Alert Source configuration (pt 1)</p></figcaption></figure>

* Click "Test & Save" to finish

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