Jira Integration

Jira Integration

Overview

The Jira Integration feature enables you to seamlessly integrate your vulnerability reports with Jira. You can directly push reports to Jira, track their statuses, and fetch updates—all within the platform. This integration ensures effective collaboration between security and development teams.

---

How to Configure Jira Integration

1. Navigate to Integration Hub

• Go to the 'Integration Hub' section from the main dashboard.

• A page with cards for all available integrations will appear.

• Click on the Jira Integration card.

2. Configure Jira Details

• Fill out the following fields in the Jira configuration form:

  • Email Address: The email address of your Jira account.

  • API Token: Generate an API token in your Jira account and paste it here.

    • You can generate an API token by visiting::

      • Go to Atlassian API Token Management.

      • Alternatively, follow these steps to navigate manually:

        • Click on your profile icon in Jira (top right corner).

        • Go to Settings > Atlassian Account Settings.

        • Navigate to Security

        • Click Create and manage API Tokens

        • Select Create API Token, then copy and save it securely

  • Project ID: Enter 10000, which is the ID of the Jira project where tickets will be created.

  • How to Get the Project ID

    1. Open Your Jira Project:

    2. Log in to your Jira account.

       Navigate to the project for which you want to find the ID.

    3. Go to Project Settings:

    4. In your project, click on the Project settings (usually found in the left-hand sidebar).

    5. Inspect the URL:

    6. While in the settings, check the browser’s address bar.

    You might see a URL similar to: https://<your-domain>.atlassian.net/jira/software/projects/DPN/settings/notifications/issue-logs?projectId=10003

    Here, the parameter projectId=10003 indicates that the project’s internal numeric ID is 10003

  • Issue ID Format: Define the format for issue IDs. The issue ID for this configuration is 10001.

  • Endpoint: The Jira domain (e.g., organization.atlassian.net).

• Click Save Configuration to store the integration settings.

---

Using Jira Integration

1. Push Vulnerability Reports to Jira

Navigate to Vulnerability Reports

• Go to the 'Vulnerability Reports' section from the main dashboard.

• You will see a list of all submitted reports here

Push a Report to Jira

• Click on 'Report - [ID]' to view the report details.

• On the report page, click the 'Push to Jira' button.

• A confirmation message will appear once the report is successfully pushed to Jira. The Jira issue key (e.g., ABC-123) will be linked to the report.

---

2. Fetch Jira Status

From the Vulnerability Reports List

• In the 'Vulnerability Reports' section, click the 'Fetch Status' button next to the relevant report.

• The status of the corresponding Jira ticket (e.g., To Do, In Progress, Done) will be updated in the platform.

---

Key Features of Jira Integration

1. Push Reports to Jira: Send detailed vulnerability reports as Jira tickets, ensuring development teams have all the necessary information.

2. Fetch Jira Status: Track the progress of vulnerabilities in real time by syncing Jira statuses with the platform.

3. Visibility Across Teams: Enable better collaboration between security and development teams with centralized data.