> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plerion.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira

> Integrate Plerion with Jira to automatically create and track findings, vulnerabilities, and risks, helping your team manage work in Atlassian’s project management platform.

With the [Jira integration](https://app.plerion.com/settings/integrations/add/Jira/Jira), you can send alerts from Plerion directly into your chosen Jira project, allowing your team to prioritize and resolve issues within your existing workflows.

<Warning>
  **Note:** This is a one-way outbound integration. Issues created or updated in Plerion will appear in Jira, but changes made directly in Jira will not sync back to Plerion.
</Warning>

## Steps for adding a Jira integration

<Steps>
  <Step title="On the Plerion dashboard, go to Settings > Integrations">
    <Frame>
      <img src="https://mintcdn.com/pleriondocs/8xtCYjlATlNqKv2p/images/integrations/jira/settings-integrations-sidenav.png?fit=max&auto=format&n=8xtCYjlATlNqKv2p&q=85&s=2169fd65750b670507500adcfea7a96e" alt="Sidebar navigation with Settings expanded and Integrations highlighted" width="655" height="853" data-path="images/integrations/jira/settings-integrations-sidenav.png" />
    </Frame>
  </Step>

  <Step title="Find Jira and click the + button">
    <Frame>
      <img src="https://mintcdn.com/pleriondocs/g7VtHlzdLDfeYxEC/images/integrations/jira/add-jira-integration.png?fit=max&auto=format&n=g7VtHlzdLDfeYxEC&q=85&s=00004b45476527a7a8ff04e7a25f18a6" alt="Integrations page with Jira option and plus button to add integration" width="1770" height="1516" data-path="images/integrations/jira/add-jira-integration.png" />
    </Frame>
  </Step>

  <Step title="On the Connect Jira page, enter a name for your integration and select Connect Jira">
    <Frame>
      <img src="https://mintcdn.com/pleriondocs/g7VtHlzdLDfeYxEC/images/integrations/jira/connect-jira.png?fit=max&auto=format&n=g7VtHlzdLDfeYxEC&q=85&s=3d17ea113d882b1cb400b522d2a6c453" alt="Connect Jira page showing fields for integration name and Connect Jira button" width="2296" height="882" data-path="images/integrations/jira/connect-jira.png" />
    </Frame>
  </Step>

  <Step title="A Jira OAuth pop-up will appear">
    Review the requested permissions and click `Accept` to authorize the connection.

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/g7VtHlzdLDfeYxEC/images/integrations/jira/access-pop-up.png?fit=max&auto=format&n=g7VtHlzdLDfeYxEC&q=85&s=7ec5277963d81937595b99e7273e0fb7" alt="Jira OAuth pop-up requesting access" width="1030" height="817" data-path="images/integrations/jira/access-pop-up.png" />
    </Frame>
  </Step>

  <Step title="Choose Jira instance (if applicable)">
    If you have access to multiple Jira instances, carefully select the correct one.

    <Warning>
      This choice can only be made once.
      If you select the wrong instance, you must delete the Jira integration and set it up again. If you skip this step, the integration status will remain as **'Pending'** and cannot be used in workflows.
    </Warning>

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/g7VtHlzdLDfeYxEC/images/integrations/jira/edit-jira-instance.png?fit=max&auto=format&n=g7VtHlzdLDfeYxEC&q=85&s=70453b30dd53305776772964b5895553" alt="Select Jira instance screen showing multiple Jira accounts" width="1846" height="500" data-path="images/integrations/jira/edit-jira-instance.png" />
    </Frame>
  </Step>

  <Step title="Test your Jira integration">
    After adding Jira, you can send a test issue to confirm the setup.\
    Choose the Jira project and issue type for the test issue.

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/8xtCYjlATlNqKv2p/images/integrations/jira/send-test-message-jira.png?fit=max&auto=format&n=8xtCYjlATlNqKv2p&q=85&s=16058ef8f40901643804728e32a47650" alt="Test issue configuration screen for Jira integration" width="1664" height="642" data-path="images/integrations/jira/send-test-message-jira.png" />
    </Frame>
  </Step>

  <Step title="Review your test issue in Jira">
    If the test is successful, Plerion will display a link to the created Jira issue, as shown below.

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/8xtCYjlATlNqKv2p/images/integrations/jira/test-issue-created.png?fit=max&auto=format&n=8xtCYjlATlNqKv2p&q=85&s=791c0fec8ed083855f96aebfd5296ac4" alt="Confirmation message on Plerion with link to created Jira issue" width="2382" height="1136" data-path="images/integrations/jira/test-issue-created.png" />
    </Frame>

    <br />

    <Frame>
      <img src="https://mintcdn.com/pleriondocs/8xtCYjlATlNqKv2p/images/integrations/jira/test-message-jira.png?fit=max&auto=format&n=8xtCYjlATlNqKv2p&q=85&s=32b6bf0378b4d79446b484c69d77dbd8" alt="Example Jira test issue created from Plerion" width="2180" height="502" data-path="images/integrations/jira/test-message-jira.png" />
    </Frame>
  </Step>
</Steps>

***

## Create a workflow on Plerion

After adding the Jira integration, you must create a workflow for any alerts to be sent to Jira.

<Steps>
  <Step title="Go to Settings > Workflows and click Add a new workflow" />

  <Step title="Enter workflow details">
    Enter a workflow name and ensure the Enabled toggle is turned on.
  </Step>

  <Step title="Add workflow conditions">
    * Under **Conditions**, you can build the workflow using any of the three available condition categories:
      * **Asset**
      * **Findings**
      * **Vulnerabilities**
  </Step>

  <Step title="Add workflow actions">
    Under **Actions**, click `Add action` and select your Jira integration.\
    Add your Jira project, issue type and resolved status.
  </Step>

  <Step title="Save the workflow">
    Click `Save` to finish setting up your workflow.
  </Step>
</Steps>