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

# Jira

{% hint style="info" %}
Note: This integration is available with the Standard Plus package or above.
{% endhint %}

#### **Prerequisites**

An account with <mark style="color:orange;">Org Admin</mark> permissions.

#### **Steps**

1. Start the integration setup.
   1. In the <code class="expression">space.vars.product\_name</code> navigation sidebar, locate the <mark style="color:orange;">**Integrations**</mark> page near the bottom and open it
   2. Find the Jira integration card, and then click <mark style="color:orange;">**Add Jira Account**</mark>**.**&#x20;
2. Generate a Jira API token.&#x20;
   1. Log in to your Jira account
   2. Click your profile icon, and then click <mark style="color:blue;">**Manage Account**</mark>.
   3. In the new window, click on the <mark style="color:blue;">**Security**</mark> tab and then click <mark style="color:blue;">**Create and manage API tokens**</mark>.
   4. Create a new API token with a relevant name, such as <mark style="color:blue;">`Portal Integration Token`</mark>. Set a long expiry, but not too long; <code class="expression">space.vars.company\_name</code> recommends 1 year.
   5. Copy the token.&#x20;
3. Connect <code class="expression">space.vars.product\_name</code> to Jira.

   1. On <code class="expression">space.vars.product\_name</code>, continue enabling the integration.
   2. In the server URL, enter the domain of your Jira tenant. The URL usually looks like the following example: <mark style="color:blue;">`<your-company>.atlassian.com`</mark>
   3. Enter your Jira username and the API token from step 2, and then click <mark style="color:orange;">**Next**</mark>.

   <figure><img src="/files/eepWrq5hNRmbjK848w1c" alt=""><figcaption><p>Add your Jira account that you want to integrate with Portal.</p></figcaption></figure>
4. Select projects and boards.&#x20;
   1. Select the Jira Project that you would like to connect. When creating tickets in Jira from vulnerabilities in <code class="expression">space.vars.product\_name</code>, they will be created in this project.
   2. Select the <code class="expression">space.vars.product\_name</code> Project that you would like to connect to.<br>

      <figure><img src="/files/1GfrIGNu88PGYqbNOneG" alt=""><figcaption><p>Choose the projects and boards to integrate. </p></figcaption></figure>
5. Configure field mapping.&#x20;

{% hint style="success" %}

#### Note

If you already have fields in Jira that match the name of the fields in <code class="expression">space.vars.product\_name</code>, they are automatically mapped to each other.
{% endhint %}

1. Select the Jira record type that you would like the integration to use when creating new records. You can select any record type from your project.&#x20;
2. If necessary, customize the field mapping by selecting different fields from the dropdown menus. <br>

   <figure><img src="/files/fJxMJn4DbFZYebd3tl5a" alt=""><figcaption><p>Choose which fields in Portal will populate which fields in Jira.</p></figcaption></figure>
3. Review and enable the integration.
   1. Review your integration configuration.&#x20;
   2. To enable the integration, click <mark style="color:orange;">**Finish**</mark>.

#### Results

Use Jira to track remediation progress for your vulnerabilities. For more information, see [Using integrations to track remediation](/after-testing/remediating-vulnerabilities/using-integrations-to-track-remediation.md).&#x20;