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

# Jira

> Connect Jira to Oleria to create tickets directly from risks and posture findings, automatically populated with risk details and routed to your assignment group.

Connect Jira to Oleria to create tickets directly from risks and posture findings. Oleria automatically populates each ticket with the risk details and routes it to your configured assignment group.

## Prerequisites

* A user with create permissions
* The Jira base URL
* The Jira project where tickets should be created

## Create an API Token in Jira

<Steps>
  <Step title="Open Atlassian account settings">
    Navigate to your Jira instance, select **Settings**, and select **Atlassian account settings**.

    <img src="https://mintcdn.com/oleria/qn6A7RIhybLn0JXz/images/workspace/jira-ticketing/step-1.png?fit=max&auto=format&n=qn6A7RIhybLn0JXz&q=85&s=8fdf62a4c9a34dbd0fe6e881f076a40d" alt="Navigate to your Jira instance, select settings, and select Atlassian account settings" width="595" height="438" data-path="images/workspace/jira-ticketing/step-1.png" />
  </Step>

  <Step title="Open API token management">
    Select **Security** and select **Create and manage API tokens**.

    <img src="https://mintcdn.com/oleria/qn6A7RIhybLn0JXz/images/workspace/jira-ticketing/step-2.png?fit=max&auto=format&n=qn6A7RIhybLn0JXz&q=85&s=d0445d2b9c2da28fed77c3930eb1d772" alt="Select Security and select Create and manage API tokens" width="981" height="749" data-path="images/workspace/jira-ticketing/step-2.png" />
  </Step>

  <Step title="Create a new API token">
    Select **Create API token**, give it a name (for example, **Oleria integrator**), and set an expiration date.

    <Note>When the token expires or you decide to revoke it, you must remove the Jira ticketing integration from Oleria and re-add it with a new API token. Token updates are supported in upcoming releases.</Note>

    <img src="https://mintcdn.com/oleria/qn6A7RIhybLn0JXz/images/workspace/jira-ticketing/step-3.png?fit=max&auto=format&n=qn6A7RIhybLn0JXz&q=85&s=329bf1f1ba3ea6ac4957757277f688fb" alt="Jira API token creation form showing token name field and expiration date selector" width="909" height="575" data-path="images/workspace/jira-ticketing/step-3.png" />
  </Step>

  <Step title="Copy the token">
    Copy the generated token.

    <img src="https://mintcdn.com/oleria/qn6A7RIhybLn0JXz/images/workspace/jira-ticketing/step-4.png?fit=max&auto=format&n=qn6A7RIhybLn0JXz&q=85&s=375b05eaf6dc4e8991bed218eeb7ba17" alt="Copy the token generated." width="932" height="338" data-path="images/workspace/jira-ticketing/step-4.png" />
  </Step>
</Steps>

## Connect Jira to Oleria

<Steps>
  <Step title="Open the ticketing system settings">
    Go to your Oleria workspace, navigate to **Settings** → select **Ticketing System** → select **Jira Connect**.

    <img src="https://mintcdn.com/oleria/qn6A7RIhybLn0JXz/images/workspace/jira-ticketing/step-5.png?fit=max&auto=format&n=qn6A7RIhybLn0JXz&q=85&s=e0440d52040842533b226c2b58021ce6" alt="Goto your Oleria workspace, navigate to Settings → select Ticketing System → click Jira Connect" width="1600" height="776" data-path="images/workspace/jira-ticketing/step-5.png" />
  </Step>

  <Step title="Complete the connection form">
    A side panel opens. Provide the following details:

    * **Base URL** - your Jira instance URL
    * **Email** - the user email with create permissions
    * **API token** - the token copied in the previous section
    * **Project key** - your Jira project name

          <img src="https://mintcdn.com/oleria/qn6A7RIhybLn0JXz/images/workspace/jira-ticketing/step-6.png?fit=max&auto=format&n=qn6A7RIhybLn0JXz&q=85&s=ffd92cedb952c72a0bb236b3f8cd9a2e" alt="Project key: Your Jira project name" width="1141" height="652" data-path="images/workspace/jira-ticketing/step-6.png" />
  </Step>

  <Step title="Confirm the connection">
    You will see the Jira integration in your Oleria workspace. Select **View Details** to view the Jira integration status.

    <img src="https://mintcdn.com/oleria/qn6A7RIhybLn0JXz/images/workspace/jira-ticketing/step-7.png?fit=max&auto=format&n=qn6A7RIhybLn0JXz&q=85&s=544c9fa73b04ae7b798eaf4ae88b9c58" alt="Jira integration shown in Oleria with a View Details button to check the integration status" width="1330" height="644" data-path="images/workspace/jira-ticketing/step-7.png" />
  </Step>
</Steps>

## Contact us

For questions, contact us at [support@oleria.com](mailto:support@oleria.com).