# Jira

In this guide, you'll configure the integration between Radiant and Jira. This setup allows Radiant Security to collect and analyze alerts that are registered as issues within a Jira board or project.

At the end of this configuration, you will provide Radiant Security with the **Webhook** **Secret** value.

### Prerequisites

* [ ] Jira user account with permissions to **create** and **manage webhooks**

### Configure a Jira webhook

In this step, you will configure Jira to forward webhook notifications to Radiant Security whenever a new issue is created that meets the conditions you have set.

{% hint style="warning" %}
**Important note**: Be sure to document and store the **Webhook** **Secret** value carefully as it cannot be retrieved later.
{% endhint %}

1. Log into Jira.
2. In the top right, click the settings icon and select **System**.
3. Scroll down the list, on the left and click **Webhooks**.
4. Click **Create a Webhook**.
5. Fill the fields with the following:
   * **Name**: `Radiant Security Webhook`
   * **Status**: `Enabled`
   * **URL**: The URL will be provided in a further step, leave this setting unchanged
   * **Secret**: Click **Generate Secret** and store the value carefully as you'll need it in the upcoming step.
6. In the **Issue** **related** **events** section, configure the following:
   * The **JQL** **Query** field allows you to specify which security alerts to forward to Radiant Security. Enter a JQL query that will only match the desired alerts. Here are some examples to help you get started:
     * If your security alerts are registered on the SOC project and they all have ”Alert” in the title, the JQL Query would be: `project = "SOC" AND summary ~ "Alert”`
     * If you happen to have other types of tickets on the same project with "Alert" in the title, it's also possible to filter by issue type: `project = "SOC" AND summary ~ "Security Alert" AND issuetype = Task`
   * To set up the webhook to only forward notifications when a new issue is created, under **Issue** select **created**.
7. At the end of the page, make sure that the **Exclude Body** checkbox is unchecked.
8. Before clicking **Create**, please proceed to the next step to obtain the webhook URL.

### Add the data connector in Radiant Security

1. Log in to [Radiant Security](https://app.radiantsecurity.ai/).
2. From the navigation menu, click **Settings** > **Data Connectors** and click **+ Add Connector**.
3. Search for and select **Jira Webhook** option and then click **Data Feeds**.
4. Under **Credential Name**, give the credential an identifiable name (e.g. `Jira Webhook`).
5. In the **Jira secret** field, enter the **Secret Token** that you generated in the first step during the Jira Webhook setup.
6. Click **Add Connector**.
7. Find the connector you just created and click **View Details**.
8. Copy the value of **Webhook** **URL**. You’ll use it in the upcoming step to finalize this setup.

### Complete the Jira setup

1. Return to Jira.
2. In the URL property, enter the **Webhook URL** value you copied from the previous step.
3. At the bottom of the page, click **Create** to complete the setup.


---

# 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.radiantsecurity.ai/radiant-connectors/data-connectors/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.