# Jira Data Center

**Table of contents:**

* [Introduction](#introduction-)
* [Prerequisites](#prerequisites)
* [Connecting the Aikido App to Jira](#connecting-the-aikido-app-to-jira)
* [Options for Task Creation in Jira via Aikido](#options-for-task-creation-in-jira-via-aikido)
* [1. Manual Task Creation](#1-manual-task-creation)
* [2. Automated Task Creation](#2-automated-task-creation)
  * [Setup Jira Integration Now→](#setup-jira-integration-now-)
  * [Discover Integration Details →](#discover-integration-details--)

## Jira Data Center

***📋 Setting up automated task creation in Jira Data Center***

### Introduction <a href="#introduction" id="introduction"></a>

This article focuses on those companies that have Jira Data Center running (i.e., Jira on premise, different from [Jira Cloud](https://help.aikido.dev/en/articles/8680218-setting-up-automated-task-creation-in-jira-cloud)). The following one-time setup *per workspace* allows everyone in your Aikido organization to create issues directly in Jira On Prem.

Following use cases are supported :

* Automated Ticket Creation: Automatically create and push tickets to specified Jira projects for seamless tracking of security issues.
* Manual Ticket Addition: Manually add security issue tickets to Jira, ensuring targeted attention for critical vulnerabilities.

### Prerequisites <a href="#prerequisites" id="prerequisites"></a>

In order to make the connection to JIRA Data Center, you'll need to create a personal access token. This token will then be used to carry out all requests to your instance.\
​\
Please note that the level of access the integration has will be equal to the person who created the personal access token (PAT). It's therefore advised to let a person with sufficient access rights in the environment to create the PAT.

To create a PAT, you can follow the steps below:

1. Navigate to your JIRA Data Center environment
2. Click on your avatar in the navigation bar on top and navigate to "Profile"
3. Click on "Personal Access Tokens", you should end up on a screen similar to the one below**​**

   ![Jira Software personal access tokens page prompting user to create their first token.](/files/Z25FgiBJs9Rc6oGf9XES)
4. Click on "Create token" and give it an appropriate name
5. We advise to not set an expiry date, but if you do, you'll have to remind yourself to update the token in Aikido periodically
6. Once the token is created, you'll get to copy it momentarily, copy the token and keep it for the next step

### Connecting the Aikido App to Jira <a href="#connecting-the-aikido-app-to-jira" id="connecting-the-aikido-app-to-jira"></a>

1. Navigate to [Integration Settings](https://app.aikido.dev/settings/integrations) within the Aikido app.
2. In the 'Task Trackers' section, select 'Jira Data Center'
3. Enter the url of your environment
4. Enter the PAT from the previous step and hit "Save"**​**

   ![Jira Data Center integration setup: enter server URL and personal access token.](/files/oT5pVsbFNirQiypg94UW)
5. Once authorized, Aikido is successfully connected to Jira, enhancing your task management capabilities 🚀

   ![Jira Data Center integration settings for repo mapping, task autocreation, and default labels.](/files/HI2Awle93IMtSSWM43ql)

### Options for Task Creation in Jira via Aikido <a href="#options-for-task-creation-in-jira-via-aikido" id="options-for-task-creation-in-jira-via-aikido"></a>

There are two different options to create new tasks from Aikido into Jira.

1. Manually create tasks from the Aikido interface
2. Automatically create new tasks via Aikido's auto creation functionality.

### 1. Manual Task Creation <a href="#id-1-manual-task-creation" id="id-1-manual-task-creation"></a>

1. Hover over any issue in your feed and click the *+* in the assign column.**​**

   ![Task assignment table with add and options buttons under "Assignee" column.](/files/qHdYxduZ8eHuhsF9A0fa)

   Alternatively, you can click the triple dots in the last columns to open up the action menu. If you have grouped issues, the triple dot action menu is available on every subissue.\
   ​

   ![Action menu with options to manage, share, or adjust task settings.](/files/7xp9HLvMM8GGtAjHhf52)
2. Fill in the required details in the popup modal.\
   ​

   ![Jira task creation form with project, assignee, scope, summary, and description fields.](/files/N2YGobr1CcXY7Bi0ws7o)
3. The newly created task in Jira will be linked in the Aikido Issue Detail under the 'Tasks' tab (sidepanel).

![Critical task: var\_dump() exposes sensitive info, needs attention and assignment.](/files/bLGFCrC1jGet4HszJo3r)

### 2. Automated Task Creation <a href="#id-2-automated-task-creation" id="id-2-automated-task-creation"></a>

{% hint style="info" %}
Aikido will automatically create tasks **every hour in bulk.** There is at the moment no option to trigger this manually.
{% endhint %}

1. Go to the [Jira Integration](https://app.aikido.dev/settings/integrations/tasktracker) settings
2. Make sure to enable 'Autocreation' by clicking the toggle to On.
3. Define the criteria for automatic task creation.\
   ​

   ![Autocreation settings: Automatically create one task daily for critical issues or higher.](/files/h59Ti0iClc0WP9P8pmF2)

   **​**
4. Aikido will then autonomously generate Jira tickets based on these settings 🚀

***


---

# 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://help.aikido.dev/getting-started/task-management-systems/all-supported-task-trackers/jira-data-center.md?ask=<question>
```

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.
