# Jira

## How to configure:

* **Step 1:**  [**Portal -> Jira**](/appsec-portal/features/jira/jira-integration-configuration.md)
* **Step 2:** [**Jira -> Portal**](/appsec-portal/features/jira/setting-up-jira-webhook.md)

## Summary

AppSec Portal provides **bi-directional** integration with **Jira**.

{% hint style="info" %}
Developers spaces may have their own required *custom fields* like **Sprint** or **Component**. If there were such space in your company, you would be not able to create a task there directly. \
In such case many companies create another space *without any restrictions* in workflow and required custom fields — **security space**.
{% endhint %}

✅ We support 2 Jira spaces: **security** and **product**. \
✅ Synchronise tasks, comments and updates between the security and product spaces for more convenience! It means, that you can put any comment in **product** task and it will appear in **security** task. \
… and it works **in both directions**.\
✅ There is an option to set *default* security space and *default* product space to save time from configuring them in product settings. \
✅ You may set *specific* product and security space in product setting if it's necessary.

## Why Webhook?

The portal supports both variants of integration (**with webhook** and **without** it) according to your needs. Webhook is required to **synchronise** **task statuses, assignees** and **tags** between spaces. Here you can see available features:

<table><thead><tr><th width="206.33333333333331">Feature</th><th width="255">without Webhook</th><th>with Webhook</th></tr></thead><tbody><tr><td>Create Jira task</td><td>✅</td><td>✅</td></tr><tr><td>Update Jira task</td><td>✅</td><td>✅</td></tr><tr><td>Delete Jira task</td><td>✅</td><td>✅</td></tr><tr><td>Sync between AppSec portal and security/product spaces:</td><td></td><td></td></tr><tr><td><ul><li>Tasks</li></ul></td><td>❌</td><td>✅</td></tr><tr><td><ul><li>Statuses</li></ul></td><td>❌</td><td>✅</td></tr><tr><td><ul><li>Priority (severity)</li></ul></td><td>❌</td><td>✅</td></tr><tr><td><ul><li>Assigned team</li></ul></td><td>❌</td><td>✅</td></tr><tr><td><ul><li>Comments</li></ul></td><td>❌ Only one way to Jira</td><td>✅</td></tr><tr><td><ul><li>Tags</li></ul></td><td>❌ Only one way to Jira</td><td>✅</td></tr></tbody></table>


---

# 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.whitespots.io/appsec-portal/features/jira.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.