# Jira

{% hint style="info" %}
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.
{% 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="/files/OvKYfe26C8hNJ2JzlJKl" alt=""><figcaption><p>Go to "Manage Account"</p></figcaption></figure>

* In the top banner, bavigate to "Security"

<figure><img src="/files/j2PtR79iEESwbh6lMbst" alt=""><figcaption><p>Navigate to "Security"</p></figcaption></figure>

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

<figure><img src="/files/o2DgsE4lLAdZqyssaagv" alt=""><figcaption><p>Click "Create and manage API tokens"</p></figcaption></figure>

* Click "Create API token"

<figure><img src="/files/YIfI69lZBcrrotPGMD2b" 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="/files/inY8UjUmZhImrM2WKfJ2" 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="/files/qroUH4dhTIGVszUf1JBQ" alt=""><figcaption><p>Copy API token</p></figcaption></figure>

## Enable Jira

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 |
| Email/Username | The username or email 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, navigate to Settings > Integrations

<figure><img src="/files/zN02u3HObDaemUY8E1kD" alt=""><figcaption><p>Integrations Dropdown</p></figcaption></figure>

* Click "Available"

<figure><img src="/files/brI7n2Ux40Tk0jTwBCVh" alt=""><figcaption><p>Click Available</p></figcaption></figure>

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

<figure><img src="/files/hp3fx5SdeVP3vmXgdFqq" alt=""><figcaption><p>The Jira Tile</p></figcaption></figure>

* Under the Data Source heading, input the Server, Username, and API Token
* Under "Jira Context", you may input a short blurb describing how your Jira instance is used. This helps Dropzone AI better search and utilize context from your tickets. Some examples:
  * "We use Jira to track vulnerabilities, security findings, and remediation tasks."
  * "Our engineering teams manage sprints, bugs, and feature development in Jira."
  * "Jira contains our IT service requests, access workflows, and configuration changes."
  * "We track cross-functional project progress, milestones, and dependencies in Jira."
  * "Our DevOps team logs infrastructure updates, CI/CD changes, and incident follow-ups in Jira."
  * "Jira holds our operational tasks, process improvements, and stakeholder deliverables."

<figure><img src="/files/2YxMiDhBSsNyQyK1n1FS" alt=""><figcaption><p>The Jira Data Source configuration</p></figcaption></figure>

* Click "Test & Save" to finish

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dropzone.ai/integrations/data/jira_data.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.