> For the complete documentation index, see [llms.txt](https://docs.meterian.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.meterian.io/management-platforms/jira.md).

# Jira

This integration allows a user to open a [Jira](https://www.atlassian.com/software/jira) ticket from a Meterian report, with data entered semi-automatically. 

**Account level configuration**

In order to use the integration, you will need to enter a set of credentials in the Meterian configuration page. If you are using a legacy or hosted Jira system, these will need to be the credentials of a user. If you are using cloud hosted version, you will need to enter an email of a user and its associated [api token](https://id.atlassian.com/manage-profile/security/api-tokens).

<figure><img src="/files/hNqmh8O3dLg84CImXhR8" alt=""><figcaption><p><em>The Jira configuration panel</em></p></figcaption></figure>

The integration supports Jira version 6 and later versions, or Jira Cloud. Please note that "Browse Projects" and "Create Issues" [permissions](https://confluence.atlassian.com/adminjiraserver073/configuring-permissions-861253288.html) are required in Jira for the selected user. <br>

**Project level configuration**

Each Meterian project can be associated to a different Jira project in the dashboard. The specific type of issue to use can also be selected, along with all the relevant fields required (including custom fields).

<figure><img src="/files/tz2y7aD4xRoBBlvu3TuM" alt=""><figcaption><p><em>Configuring a Jira project on the dashboard</em></p></figcaption></figure>

\
**Opening a Jira issue**

Jira issues can then be opened from the report, from the "Action" tab of any vulnerability:

<figure><img src="/files/mIhgkRDj51IzUGEWh39j" alt=""><figcaption><p><em>Creating a Jira issue from a vulnerability</em></p></figcaption></figure>

Where possible, fields are automatically pre-populated. By pressing "Save" the issue is generated on Jira on the target project:

<figure><img src="/files/lLIMMskc790URrARyAnZ" alt=""><figcaption><p><em>The issue on the Jira instance</em> </p></figcaption></figure>

The ID of the Jira ticket is now reported in the vulnerability, which is a clickable link that navigate directly to the page on Jira.

<figure><img src="/files/p3kUPFSdtPqGVu0lol6n" alt=""><figcaption><p><em>The report now shows the linked Jira issue</em></p></figcaption></figure>