Jira Integration

11/2022

Overview

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

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.

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 available in Jira.

The next step is to login with that user account and create an API token.

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

Oort Configuration

Within the Oort console, navigate to -

Integrations -> New Integration -> Jira

Enter the following information according to the instructions below:

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.

Enter the email address of the service account you created.

Enter the API token created above.

Click Save.

Test the Jira Integration

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.

Select your Jira ticketing service instance and click Confirm.

The ticket will appear in the lower section.