> ## Documentation Index
> Fetch the complete documentation index at: https://hacktronai-changelog-e1a164be.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira

> Connect Jira and configure how Hacktron creates Jira tickets for security findings.

## Prerequisites

You need to be a Hacktron organization admin to manage the Jira integration.

You also need permission to authorize apps in the Jira workspace you want Hacktron to use.

## Configure Jira

<Steps>
  <Step title="Open Integrations page">
    In Hacktron, go to **Integrations** and find **Jira** under **Project
    Management Apps**.

    <img src="https://mintcdn.com/hacktronai-changelog-e1a164be/dpUdS1BJ16uy6tXP/images/jira.png?fit=max&auto=format&n=dpUdS1BJ16uy6tXP&q=85&s=cc42a2bf896254c5bfb2318cda2eee65" alt="Jira integration card in Hacktron" width="556" height="258" data-path="images/jira.png" />
  </Step>

  <Step title="Start the OAuth connection">
    Click **Connect**. Your browser will redirect to Atlassian.
  </Step>

  <Step title="Sign in to Atlassian (if required)">
    If Atlassian prompts you to sign in, enter your Atlassian login credentials as you normally would.
  </Step>

  <Step title="Authorize Hacktron">
    Hacktron will request access to view and create Jira tickets.

    <img src="https://mintcdn.com/hacktronai-changelog-e1a164be/dpUdS1BJ16uy6tXP/images/authorize_atlassian.png?fit=max&auto=format&n=dpUdS1BJ16uy6tXP&q=85&s=7529a9abdc46c8706b0427fbfc9eb927" alt="Jira authorization" width="1098" height="1017" data-path="images/authorize_atlassian.png" />

    Click **Accept**.

    <Info>
      Hacktron requests the following permissions:

      * Read access to `jira-user`
      * Read and write access to `jira-work`

      Hacktron uses this access to create Jira tickets for security findings and
      link those issues back to the finding.
    </Info>
  </Step>

  <Step title="Return to Hacktron">
    After authorization, Hacktron redirects you back to **Integrations** and
    opens the Jira configuration panel.
  </Step>

  <Step title="Choose auto-create behavior">
    Turn on **Automatically create tickets** to have Hacktron create Jira tickets for every security finding.

    <Tip>
      If you disable auto-create, you can still create Jira tickets manually from the finding detail view.
    </Tip>
  </Step>

  <Step title="Choose ticket defaults">
    Select the default Jira project and issue type. Hacktron will use these settings to create Jira tickets for security findings.

    <Info>
      **This is required if you enable auto-create.** You can change these settings later.
    </Info>

    You can also optionally apply a default label (e.g. "security") and a default assignee from your team.

    <img src="https://mintcdn.com/hacktronai-changelog-e1a164be/dpUdS1BJ16uy6tXP/images/jira_config.png?fit=max&auto=format&n=dpUdS1BJ16uy6tXP&q=85&s=475e28a90e67f822c720d1e97d61ec15" alt="Jira configuration" width="833" height="999" data-path="images/jira_config.png" />

    <Tip>
      Jira uses "Highest" to "Lowest" for priority levels.
      You can configure a severity-to-priority mapping in the Jira settings.
    </Tip>
  </Step>

  <Step title="Save settings">
    Click **Save** to apply the Jira configuration.
  </Step>
</Steps>

## Using Jira tickets

After Jira is connected, open an approved finding and choose **Create on Jira** to create a Jira issue manually. If the finding already has a Jira issue, Hacktron shows **View on Jira** instead.

## Common checks

* If projects or issue types are missing, confirm that the Atlassian account used for OAuth can access them.
* If auto-create cannot be saved, make sure both a default project and default issue type are selected.
* If a ticket already exists for a finding, use **View on Jira** instead of creating another ticket.