# Jira On-Prem

### Creating a Personal Access Token (PAT) in Jira

To integrate **Hivel** with **Jira**, you need to generate a **Personal Access Token (PAT)** for authentication. Below are the detailed steps for setting up the **service account** and generating the PAT in **Jira** for successful integration:

#### **Prerequisites**

* **Jira Service Account**: Ensure you have a **service account** with **Site Admin** access to the Jira projects you want to analyze. This account will be used to fetch data from Jira for Hivel analysis.

***

#### **Steps for Integration**

**1. Service Account Setup**

* **Create a service account** in Jira if you don’t already have one.
* Ensure this service account has **Site Admin access** to the required Jira projects you want Hivel to analyze.
* The service account must have sufficient permissions to read data from the Jira projects, such as issue fields, access to all boards, and any other necessary information for analysis.

**2. Generate Personal Access Token (PAT)**

To authenticate Hivel with Jira, you’ll need to generate a Personal Access Token (PAT). Follow these steps:

* **Step 1**: Log in to your **Jira Service Account** and go to the following URL to manage your account settings:\
  [<mark style="color:purple;">Jira Account API Tokens</mark>](https://id.atlassian.com/manage-profile/security/api-tokens)
* **Step 2**: On the **API Tokens** page, click on **Create API token**.
* **Step 3**: In the **Create API token** dialog:
  * Enter a **label** for the token (e.g., "Hivel Integration").
  * Click **Create** to generate the token.
* **Step 4**: After the token is created, a new token will appear in the list. Click the **Copy** button to copy the token to your clipboard.
* **Step 5**: Store this token securely, as it is the only time it will be shown. You will use this token to authenticate with Jira from Hivel.

Use the token to complete the next steps as shown on the Integration screen in Hivel.


---

# 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.hivel.ai/integrations/on-prem-setup/jira-on-prem.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.