Jira

Configure Jira to forward webhook notifications each time a relevant issue is created.

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

• This configuration requires a 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.

Important note: Be sure to document and store the Webhook Secret value carefully as it cannot be retrieved later.

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.

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.