Ticketing Systems
      Back to home
      1. Radiant Help Center
      2. Getting Started
      3. Ticketing Systems

      Jira

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

      Overview

      This configuration integrates Jira with Radiant Security to allow Radiant Security to collect and analyze alerts registered as issues on a Jira board or project. To complete this configuration, you’ll need to complete the following steps:

      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.Untitled
      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.Untitled(1)
      7. At the end of the page, make sure that the Exclude Body checkbox is unchecked.
      8. Before clicking Create, please complete the following 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.

      Untitled-1
      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.

      Untitled(2)
      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. Screenshot 2024-04-12 at 16.11.34

      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.

      We value your opinion. Did you find this article helpful? Share your thoughts by clicking here or reach to our Product and Customer Success teams at support@radiantsecurity.ai 

       

      Last updated: 2024-08-23