> ## Documentation Index
> Fetch the complete documentation index at: https://docs.launchsafe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira

> Connect Jira to automatically create and track tickets from LaunchSafe vulnerability findings, syncing security issues into your team's workflow.

The Jira integration enables your team to create Jira tickets directly from LaunchSafe findings, ensuring vulnerabilities flow into your existing issue tracking and sprint planning workflow.

## Prerequisites

* A Jira Cloud instance (Jira Server/Data Center is not currently supported)
* Admin or project admin access to the Jira project where tickets should be created
* An active LaunchSafe workspace

## Setup

<Steps>
  <Step title="Navigate to Integrations">
    In the LaunchSafe dashboard, go to **Integrations** in the sidebar and locate the **Jira** card.
  </Step>

  <Step title="Connect Jira">
    Click **Connect Jira**. You'll be redirected to Atlassian's OAuth authorization page.
  </Step>

  <Step title="Authorize LaunchSafe">
    Log in with your Atlassian account and grant LaunchSafe access. The following permissions are requested:

    | Permission             | Purpose                                               |
    | ---------------------- | ----------------------------------------------------- |
    | **Read Jira projects** | List available projects for ticket creation           |
    | **Create issues**      | Create new tickets from findings                      |
    | **Add attachments**    | Attach evidence screenshots and proof-of-concept data |
    | **Read issue types**   | Map to your project's issue types (Bug, Task, Story)  |
  </Step>

  <Step title="Configure project mapping">
    Select the default Jira project where tickets should be created. You can also configure:

    * **Issue type** — Bug (recommended), Task, or Story
    * **Priority mapping** — how LaunchSafe severity maps to Jira priority
    * **Labels** — automatically applied labels (e.g., `security`, `launchsafe`)
    * **Assignee** — default assignee for new tickets (optional)
  </Step>
</Steps>

## Creating tickets from findings

From any finding in LaunchSafe:

1. Click the **Create Jira Ticket** button on the finding detail page
2. Review the pre-populated fields (you can edit before creating)
3. Click **Create** — the ticket is created in your Jira project
4. A link to the Jira ticket appears on the finding for tracking

### Field mapping

LaunchSafe populates Jira tickets with structured information from the finding:

| LaunchSafe field | Jira field                   | Content                                               |
| ---------------- | ---------------------------- | ----------------------------------------------------- |
| Title            | Summary                      | Vulnerability title with CWE reference                |
| Severity         | Priority                     | Mapped via your configured priority mapping           |
| Description      | Description                  | Full finding details in Jira markup format            |
| Evidence         | Description (appended)       | HTTP request/response, code snippets, data flow       |
| Category         | Labels                       | Vulnerability category (e.g., `sql-injection`, `xss`) |
| CVSS Score       | Custom field (if configured) | Numeric CVSS v3.1 score                               |
| Remediation      | Description (appended)       | Step-by-step fix instructions with code examples      |
| LaunchSafe URL   | Description (link)           | Direct link back to the finding in LaunchSafe         |

### Priority mapping

The default priority mapping follows industry-standard severity-to-priority translation:

| LaunchSafe severity | Jira priority |
| ------------------- | ------------- |
| Critical            | Highest       |
| High                | High          |
| Medium              | Medium        |
| Low                 | Low           |
| Info                | Lowest        |

You can customize this mapping in **Integrations** → **Jira** → **Settings**.

### Bulk ticket creation

For scans with many findings, you can create tickets in bulk:

1. Go to the **Findings** page
2. Use severity filters to select the findings you want to ticket
3. Click **Create Jira Tickets** (bulk action)
4. Review and confirm — tickets are created for all selected findings

## Duplicate prevention

LaunchSafe tracks which findings have associated Jira tickets. If you attempt to create a ticket for a finding that already has one, you'll be warned and shown the existing ticket link. This prevents duplicate tickets from cluttering your backlog.

## Disconnecting

To disconnect Jira, go to **Integrations** → **Jira** → **Disconnect**. Existing Jira tickets created by LaunchSafe are not affected — they remain in your Jira project.