# 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"

Go to "Manage Account"

- In the top banner, navigate to "Security"

Navigate to "Security"

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

Click "Create and manage API tokens"

- Click "Create API token"

Create API token

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

Create API token

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

Copy API token

## Enable Jira

To enable the Alert Source integration, you will need the following information:

- **Dropzone Field**
  - **Source**: 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

Integrations Dropdown

- Click "Available"

Click Available

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

The Jira Tile

- 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

The Jira Alert Source Configuration (pt 1)

- 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"

The Jira Alert Source Configuration (pt 2)

- 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

The Jira Alert Source Configuration (pt 3)

- Click "Test & Save" to finish

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