# Jira

## Getting Started

You'll need the following data to being your integration with Jira

* Project URL
* Project Key
* Issue Type
* login/email for account
* Jira API Token

## Project URL

You can get your project URL from the browswer by navigating to your project and copying the portion of the URL that reflects the only the domain name for your Jira account, as shown below:<br>

<figure><img src="/files/yxsQKjFEv5IkSsIX41R8" alt=""><figcaption></figcaption></figure>

## Project Key

Your project key can be retrieved from your project settings at under your details tab:

<figure><img src="/files/bp3aflurabGnR7ZjpK7y" alt=""><figcaption><p>Project Key</p></figcaption></figure>

## Issue Type

Issue types are found in Jira under you project settings Issue Types menu. Default Jira issues types are: Epic, Task and Subtask

<figure><img src="/files/kDqRYDDQRrJlI6WgHmKy" alt=""><figcaption></figcaption></figure>

## Create Jira Token

The first step is to create a Jira token that can be used with your Threatrix integraition. We suggest creating a service accont that can be used for this purpose, but any user account, with appropriate privledges, can be used for this purpose.&#x20;

1. Login to Jira and Navigate to \`Atlassian Account -> Security -> Create API Tokens\` or just use this link.\
   [https://id.atlassian.com/manage/api-tokens](<https://id.atlassian.com/manage/api-tokens >)
2. Click "Create New Token" button and give it a name and expiration date. Be aware that your Threatrix integration will stop functioning after the token expires.&#x20;
3. Be sure to Copy the token and store it somewhere safe. \\

## Setup Integration

Now that we have all of the necessary data to contiguration the integration, let's get started.

1. Login to Threatrix Threat Center and navigate to Admin -> Settings -> Integration -> Jira Integration
2. Enter the values collected in the previous steps
3. Click "Save" to commit the changes.

<figure><img src="/files/WPuRBOT40VwMXQqsXWqI" alt=""><figcaption><p>Succesful Jira Integration</p></figcaption></figure>

And, now you're ready to create tickets from Threat Center!

## Creating Jira Tickets

Jira tickets can be created in three ways:

1. Directly from the Vulnerability details screen. Once the ticket is created, a link to the Ticket will be added to the license details screen.<br>

   <figure><img src="/files/EoiS1oP3KovXpzsNHqrr" alt=""><figcaption></figcaption></figure>
2. Directly from license details screen:\ <br>

   <figure><img src="/files/nBBkTes7JFRASyLf1J3O" alt=""><figcaption><p>Create Jira ticlet from License Details</p></figcaption></figure>

   \
   Once the ticket is created, a link to the Ticket will be added to the license details screen.<br>

   <figure><img src="/files/Vp813fM6S2uwgUon5kBl" alt=""><figcaption></figcaption></figure>
3. Automatically from within polices. \
   From withing policies, edit the policy for which you'd like to create a Jira ticket. Edit the policy and Navigate to the actions tab. Select "Add new action" and then select "Issue" from the Action drop down and Type Jira. You may also add notes to the policy which will flow through to the Jira ticket to provide guidance to your development team.<br>

   <figure><img src="/files/Fsa4Hb5sOuJ7IWtHwXZW" alt=""><figcaption></figcaption></figure>


---

# 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.threatrix.io/integrations/issue-management/jira.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.