# 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.&#x20;

**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="https://3502151236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-naNCUtT6Gw1tfDjRR%2Fuploads%2FF7kWoT6yVQ95HLSptyny%2Fimage.png?alt=media&#x26;token=13db922b-568f-4f30-8fb0-80586fb675ec" 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="https://3502151236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-naNCUtT6Gw1tfDjRR%2Fuploads%2FgEP9hJSxlg0sHOD3jame%2Fimage.png?alt=media&#x26;token=7e82f795-d3c3-499e-a0b0-a8571f7984c4" 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="https://3502151236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-naNCUtT6Gw1tfDjRR%2Fuploads%2FUmDY4LBfTbNsHTjezJGi%2Fimage.png?alt=media&#x26;token=28da0629-6c7c-40d6-bb60-7527df39eb15" 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="https://3502151236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-naNCUtT6Gw1tfDjRR%2Fuploads%2FAwY1rhxwcb2evxd9DWRU%2Fimage.png?alt=media&#x26;token=a8e2d244-b2fa-4a2b-952f-5a494ff64db0" 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="https://3502151236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-naNCUtT6Gw1tfDjRR%2Fuploads%2Fow4p8p3OSwG2x5sB0LbW%2Fimage.png?alt=media&#x26;token=eddb7ce4-30dc-4a36-af26-d8277674a94d" alt=""><figcaption><p><em>The report now shows the linked Jira issue</em></p></figcaption></figure>
