# Jira

## Overview <a href="#overview" id="overview"></a>

The Oort security platform can integrate with Atlassian Jira to open tickets in response to failed Checks for various security configuration and identity threat events.

This document will walk you through the process of setting up access to Jira and will also walk you through the setup inside of the Oort console.

### Jira Configuration <a href="#jira-configuration" id="jira-configuration"></a>

To add the necessary configuration in Jira, you need to have admin access to create a service account for the integration.

From the Jira admin console, create a new user account that will act as the dedicated service account for the integration following [this article](https://confluence.atlassian.com/adminjiraserver/create-edit-or-remove-a-user-938847025.html).

Set the password according to your organization’s service account password policy and store it securely.

Add this user account to the Jira project where you intend to send Oort related issues and tasks.

Provide the user account that you created with a role or permissions that allow it to create, read, and modify issues.

This [article covers the various permission schemes](https://confluence.atlassian.com/adminjiracloud/managing-project-permissions-776636362.html) available in Jira.

The next step is to login with that user account and [create an API token](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/).

Copy the API token to a secure location for input into the Oort console below.

### Oort Configuration <a href="#oort-configuration" id="oort-configuration"></a>

Within the Oort console, navigate to -

**Integrations -> New Integration -> Jira**

E﻿nter the following information according to the instructions below:

<figure><img src="https://oort-docs-site.netlify.app/static/e719ec2ec0f277c895266cbcd64820a1/9f82e/2022-11-09_14-19-24.png" alt=""><figcaption></figcaption></figure>

Enter an integration name and description.\\

Enter your **Jira instance URL**. \\

Enter the **Project Key** for the Jira project where you wish to open Oort related issues. The project key can be obtain in Jira by navigating to the **Project page -> Project Settings**.

<figure><img src="https://oort-docs-site.netlify.app/static/f421fd042181a506c6972bf5ec185c36/9f82e/2022-11-09_14-17-07.png" alt=""><figcaption></figcaption></figure>

Enter the **email address** of the service account you created.

Enter the **API token** created above.

Click **Save.**

### Test the Jira Integration <a href="#test-the-jira-integration" id="test-the-jira-integration"></a>

To test the integration, navigate to a user that is failing a particular check, such as Inactive Users. Go to the **Checks** tab for that user.

Click the **three dot option menu** for a failing check and select **Open Ticket**.

<figure><img src="https://oort-docs-site.netlify.app/static/8b26a5b9b4e601bf2fd882facc03f495/9f82e/2022-11-09_14-22-00.png" alt=""><figcaption></figcaption></figure>

Select your Jira ticketing service instance and click **Confirm**.

<figure><img src="https://oort-docs-site.netlify.app/static/db70e7e13cead931217a524d6987fb0f/a1253/2022-11-09_14-23-45.png" alt=""><figcaption></figcaption></figure>

The ticket will appear in the lower section.

<figure><img src="https://oort-docs-site.netlify.app/static/b7a440dd8076af08ce551417bb764a4d/9f82e/2022-11-09_14-25-12.png" alt=""><figcaption></figcaption></figure>
