---
title: "Jira Data Center Integration"
description: "Push Cobalt findings to your Jira Data Center."
canonical_url: "https://docs.cobalt.io/articles/jira-data-center-integration-WzRSMUJ1U7"
md_url: "https://docs.cobalt.io/articles/jira-data-center-integration-WzRSMUJ1U7.md"
---
# Jira Data Center Integration

Push Cobalt findings to your Jira Data Center.


:::info
Learn how to integrate **Jira Data Center** with Cobalt. The availability of this feature depends on your [PtaaS tier](https://docs.cobalt.io/en-us/articles/cobalt-ptaas-tiers-tGUEyGwLaS).

If your organization uses Jira Cloud, see [Jira Cloud Integration](https://docs.cobalt.io/en-us/articles/jira-cloud-integration-0hggU8REdo).

:::

## **Configuration**

**Required permissions**:

* **Cobalt**: [Organization Owner](https://docs.cobalt.io/en-us/articles/user-roles-and-permissions-oCij6uRrUR#h-organization-owner) or [Member](https://docs.cobalt.io/en-us/articles/user-roles-and-permissions-oCij6uRrUR#h-organization-member)
* **Jira**: Jira admin

## **Step 1: Connect the Jira Plugin**


1. In Cobalt, go to **Integrations** > **Jira**.
2. Under **What type of Jira setup are you using?**, select **Jira Data Center**.

 ![](https://docs.cobalt.io/api/attachments.redirect?id=be3848ec-d345-4438-96a5-9b99db7cbcba)


3. Follow the instructions in the UI to install and connect the [Cobalt for Jira DC](https://marketplace.atlassian.com/apps/1224424/cobalt-for-jira-dc-server?tab=overview&hosting=datacenter) plugin.
4. Return to the Cobalt app, and check the integration status. You should see your Jira instance on the **Jira Integration** page..

 ![](https://docs.cobalt.io/api/attachments.redirect?id=cbed99d6-d291-40fb-9707-c859a3e8f5ab)

## **Step 2: Configure the Integration for a Pentest**


1. In Cobalt, go to **Integrations** > **Jira** > **Configuration**. Here, you can see pentests for which you can configure the integration.
2. For the desired pentest, select the gear icon.⚙️

 ![](https://docs.cobalt.io/api/attachments.redirect?id=99f878fa-49e8-466c-88d7-f2e7d1b27ed2 " =896x222")


3. In the overlay that appears, configure integration parameters:

* **Jira Project**
* **Issue Type**
* **Labels** to add to Jira issues

 ![](https://docs.cobalt.io/api/attachments.redirect?id=730bd8aa-c811-4f3c-aa83-f1b68e3251d5)

* **State Mapping (Jira to Cobalt)**: Map Jira issue statuses to Cobalt finding states.

 ![](https://docs.cobalt.io/api/attachments.redirect?id=8413d91a-bb11-4c79-a1cb-b01dbb438225)


4. Select **Save**.

## **How the Integration Works**

Here’s what to expect once you’ve enabled the integration for a pentest:

* The **Auto-Push** option is enabled for a pentest by default. When a new finding in the Pending Fix [state](https://docs.cobalt.io/en-us/articles/finding-states-De6IE4W5Zw) is reported, a new issue is automatically created in Jira. Learn more about [how auto-push works](https://docs.cobalt.io/en-us/articles/push-cobalt-findings-to-jira-cdNUJlnblj#h-how-auto-push-works).
* Pentest Team Members can push findings manually—if they’re not already synchronized. Learn [how to push findings manually](https://docs.cobalt.io/en-us/articles/push-cobalt-findings-to-jira-cdNUJlnblj#h-push-findings-manually).
* Jira issue statuses are synchronized with Cobalt finding states according to your mapping settings.

You can manage Jira connections for specific pentests:

* View the connection status in **Integrations** > **Jira** > **Configuration**. Here, you can see the last synchronization time.
* Adjust the configuration for specific pentests if needed.

## Learn how finding parameters are mapped between Cobalt and Jira.

**Mappings of finding fields to Jira issue fields (Cobalt → Jira DC)**:

* Finding Title → Jira ticket title
* Pentest ID → Description - Cobalt URL
* Description → Description - Overview
* Affected URL(s) → Description - Browser URL
* Proof of Concept → Description - Steps to Reproduce
* Suggested Fix → Description - Suggested Fix
* Attachments → Attachments

The following parameters are **not** exported:

* Vulnerability Type
* Severity
* Prerequisites
* HTTP Request
* Comments


:::info
**Note**

You can synchronize findings’[severity levels](https://docs.cobalt.io/en-us/articles/severity-levels-QCUIhkAYey)with Jira using theCobalt Severityfield.[Learn more](https://docs.cobalt.io/en-us/articles/synchronize-cobalt-severity-levels-with-jira-fwZOF5RPDX).

:::

## **Attachments Support**

You can add attachments to Cobalt findings. To ensure that attachments are created properly on the Jira Data Center, verify the following:

* On the machine where Jira Data Center is installed, locate your `$JIRA_HOME`directory. Follow the Atlassian documentation on [how to locate the Jira application home directory](https://confluence.atlassian.com/adminjiraserver/jira-application-home-directory-938847746.html).
* The user must have permissions to:
  * Create a `$JIRA_HOME/import/cobalt`directory.
  * Read and write files within the `$JIRA_HOME/import/cobalt`directory.

## **Delete the Integration**

You can delete the integration with Jira.


1. In Cobalt, navigate to **Integrations** > **Jira**, and then select **Delete**.

 ![.](https://docs.cobalt.io/api/attachments.redirect?id=a3d38db7-b9ef-4278-be64-30aa058366d5 " =1024x266")

2\. In the Jira admin panel, uninstall the Jira plugin.

Here’s what to expect once you’ve deleted the connection:

* Data synchronization between Cobalt and Jira stops.
* All Jira configurations for specific pentests are deleted. If you decide to reestablish the connection, you need to reconfigure the integration for each pentest.