Links

Jira DC

To create tickets in JIRA Data Center for Squadcast Incidents with the help of Outgoing Webhooks

Create a Ticket in JIRA DC via Webhook Template

Follow the below steps to configure the “JIRADC - Create Issue” action via webhooks:
  1. 1.
    Copy the Username and Password of a JIRA DC account that has sufficient permissions to create issues.

Generate Basic Token using the API Key

You need to generate a basic token using the username and password to authenticate JIRA DC APIs. Use a tool to generate a basic token out of the API Key.
Here we have used Postman to generate the basic token
  1. 1.
    Open a new tab in Postman
  2. 2.
    Paste the URL choosing method as POST. Navigate to Auth tab > Select Type as Basic Auth > enter the JIRA account’s Username and Password in the respective fields.
  1. 3.
    Click on Code Icon as highlighted in the below screenshot and copy the Authorization value.
## Using Webhooks to create JIRA DC issues for Squadcast Incidents
  1. 1.
    Navigate to Settings -> Webhooks.
  2. 2.
    Click Add Webhook. On the next screen, you will be guided through three steps. Navigate between these steps by clicking on any of the steps on the top bar.
  3. 3.
    Add Webhook Details:
    1. 1.
      Webhook Name: Enter the webhook name as JIRA DC - Create Issue.
    2. 2.
      Webhook Description (optional): Enter an optional description. For example - This webhook is for issue creation in JIRA DC for Squadcast Incidents.
    3. 3.
      Failure Notification Email (optional): Enter an email where you want to receive failure notifications. This is particularly helpful when you (or an administrator) want to be notified of webhook-related failures.
    4. 4.
      URL: Copy and paste the below API.
    5. 5.
      Additional Headers: Add Key: Authorization and paste the Value copied from Postman with the prefix Basic
Note:
Replace “your JIRA DC public URL” with your JIRA DC Public URL and make sure you have selected the POST request.
Under Additional headers, Content-Type: application/JSON is added by default.
Click Next: Choose Webhook Type, and navigate to the next step.
  1. 4.
    Choose Webhook Type: Choose Webhook type (Manual or Automatic) and add configurations.
    1. 1.
      Manual Webhook: Manually trigger Webhooks under incidents, on demand. Under Manual Webhook, select the teams that are authorized to access the Webhook. You can select All Teams or enter specific Teams, from the drop-down.
Note:
Select this option only if you want to create JIRA DC issues manually on-demand. If you want an issue, created automatically when certain conditions are met, please choose Automatic webhooks.
  1. 2.
    Automatic Webhook: Automatically trigger Webhooks when the configured conditions match. To set up Automatic Webhook Configurations:
    1. 1.
      Versions: Select v2
    2. 2.
      Triggers: Select the following Trigger events (conditions) for which the Webhook will be triggered:
      1. 1.
        Incident Triggered (This will create a JIRA DC issue whenever a new incident gets triggered in Squadcast)
    3. 3.
      Filters: You can apply filters on top of events, based on Teams, Services, Alert Sources, and Tags, by having an individual expression or a combination of expressions/expression groups.
Applying filters will trigger the webhook and create JIRA DC issues only for events that match the filter.
Click Next: Configure Payload, and navigate to the next step.
  1. 5.
    Configure Payload: Select the pre-configured template for JIRA DC - Create Issue. You can also test the Webhook by clicking the Test Webhook on the bottom right.
Note:
We have added the necessary fields in the template. You can change the Priority and Status according to your use case and can add additional ticket fields. You can also use this link to check the fields accepted by JIRA DC Create Issue API.
Click Save and your Webhook is created.