> For the complete documentation index, see [llms.txt](https://docs.dropzone.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dropzone.ai/integrations/alert/jira_alert.md).

# Jira

{% hint style="info" %}
Dropzone's integration is only with the Jira [Cloud](https://developer.atlassian.com/cloud/jira/platform/), however support for on-prem Jira [Data Center](https://www.atlassian.com/enterprise/data-center/jira) is on the roadmap.
{% endhint %}

Dropzone AI integrates with [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
* Click on your user icon and click "Manage Account"

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

* In the top banner, navigate to "Security"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FTfWYqmKKLXtLLfWluqpg%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://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2Fcv4uTvv9tATwRc5WsYOr%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://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FuvhapEyAkAo1EyBIxQpp%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://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FrdqrIy1yOTAMhmTI8CwH%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://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FO8VsEgclGwZmOUUnSUsc%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 left side bar, navigate to Platform Settings > Integrations

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

* Click "Library"

{% hint style="info" %}
If you have previously integrated this application, click "Configured"
{% endhint %}

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2Fx4O3FuRG5IqPwx5sFuHr%2Fapp_system_integrations_library.png?alt=media" alt=""><figcaption><p>Click Library</p></figcaption></figure>

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

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FDvfC4mSF6BP93DqnfIfj%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 our Customer Success team if you do not know which to use

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FE7TUCSTk5gfyFgYHBoLp%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
* Input your desired Poll interval and lookback
* If you want Dropzone to push its investigation results back to Jira, check the box labeled "Comment Investigation Results to ticket"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FAIBzcLPgpo5LoPZ35VPr%2Fapp_system_integrations_available_jira_alert_config_2.png?alt=media" alt=""><figcaption><p>The Jira Alert Source Configuration (pt 2)</p></figcaption></figure>

* If you wish to filter alerts using the Python [CEL](https://python-common-expression-language.readthedocs.io/en/stable/tutorials/cel-language-basics/) package, check the box labeled "Use advanced filtering"
* Input your CEL expression, then select whether to include or exclude alerts matching that filter. Add each filter individually using the "Add Item" button
* Contact our Customer Success team for more information about this feature

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FI56AMieT91vHIswUkCuf%2Fadvanced-filtering-test-save.png?alt=media" alt=""><figcaption><p>The Jira Alert Source Configuration (pt 3)</p></figcaption></figure>

* Click "Test & Save" to finish

If you have any errors contact our Customer Success team.
