> 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, 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-892c57a3a07348246aca25f99d712304f94f2143%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-a68d80f285721536f36a796f9cefb362d474ab82%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-a2cf35a05060e469d66712ed5ced46092d27c7a6%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-96d407730970165fbeb07c17bf4a7375caa72860%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-5854e18f9034b2f00a618c8df3acf8bbed2095df%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-5a3a43ffd89a836d5e8eba9b320bc258fd6ca42a%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-8c77435ef341f8180540e049f505d3390a27bbf4%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://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-7e038b4f51ee27d4cf4f1ac6f76c5ddae2bf29c5%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://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-1b4ca4072d382daa573a0d1b8b354c93aad46a6f%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-a473b6857aedd7d057011b76162a42e6a6eae1ef%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://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-d51287f40099edbda2cda52da5022e8e1aa384eb%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 your Dropzone AI support representative for more information about this feature

<figure><img src="https://435022081-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBVcKuiytGCsIDpL70BC%2Fuploads%2Fgit-blob-43a55827dfbfd5a9af3d744a16e7e8306fc8e253%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 engage your Dropzone AI support representative.