# Jira
## 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](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
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.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.oort.io/integrations/jira-integration.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
