Integrating Jira Cloud

Jira Cloud is Atlassian's software-as-a-service (SaaS) project management tool. Jira Cloud is a fully managed platform that allows teams to organize projects using Kanban or Scrum boards without managing server infrastructure.

The integration with Jira Cloud allows the Delinea Platform to forward JSON-formatted event logs to Jira Cloud using HTTPS webhooks. Jira Automation receives logs through an incoming webhook trigger. Administrators can configure Jira to automatically create incident tickets when security events occur.

Prerequisites

The integration of Jira Cloud with the Delinea Platform requires that the following requirements be met.

Delinea Platform

• The Delinea Platform is properly provisioned and configured in your environment.

• Administrator Manage Webhooks permission to manage webhooks in the Delinea Platform.

Jira

• A Jira Cloud or Data Center instance is configured. For more information, see the Jira Cloud or Data Center documentation.

• A project with an appropriate issue type (Incident, Bug, Task, or a custom issue type) is configured.

• Project Administrator or Automation Administrator permissions.

Configuration

To enable the integration between Jira Cloud and the Delinea Platform, complete the following configuration tasks:

• Configuring Jira Cloud

• Configuring the Delinea Platform

Configuring Jira Cloud

To configure Jira Cloud for the integration with the Delinea Platform, complete the following steps:

• Step 1: Create an Incoming Webhook in Jira

• Step 2: Configure the Create Issue Action in Jira

Step 1: Create an Incoming Webhook in Jira

You must set up an incoming webhook trigger in Jira Automation. This generates the webhook URL and secret that are needed to establish a secure connection between Jira Cloud and the Delinea Platform.

To create an Incoming webhook:

1. Log in to Jira and open the target project.

2. Navigate to Project Settings > Automation.

3. Select Create rule.

4. In the Add a trigger dialog, search for Incoming webhook and select it.

5. Copy the generated Webhook URL and Secret values.

   These values are required for configuring the Delinea Platform webhook.

6. Verify that the copied URL matches the current Atlassian Automation secure webhook format:

   https://api-private.atlassian.com/automation/webhooks/jira/<webhook-id>

   Atlassian deprecated the legacy URL format (https://automation.atlassian.com/pro/hooks/<id>) on January 28, 2025 and decommissioned it on May 30, 2025. If your URL begins with https://automation.atlassian.com/pro/hooks/, regenerate the webhook in Jira and update your Delinea Platform configuration with the new URL.

7. Under Execute this automation rule with, select No issues from the webhook.

8. Select Save.

   Store the webhook URL and secret in a secure location. These values cannot be retrieved after you leave the configuration page.

Step 2: Configure the Create Issue Action in Jira

After setting up the incoming webhook trigger, configure a Create Issue action in Jira Automation to define how incoming Delinea Platform events are mapped to Jira incident fields.

To configure a Create Issue action:

1. In the Jira rule editor, select Add component > New action > Create issue.

2. Select your project and an issue type (for example, Task or Incident).

3. Map the Delinea Platform JSON fields to the Jira fields by using {{webhookData}} smart values.

   The following table provides common field mappings.

   Jira Field	Smart Value	Description
   Summary	{{webhookData.Action.Name}}	Event action name
   Description	{{webhookData.Actor.Name}}	User who triggered the event
   Labels	{{webhookData.service}}	Delinea service name

4. Select Save to complete the automation rule.

Configuring the Delinea Platform

To configure the Delinea Platform for the integration with Jira Cloud, you must create a webhook in the platform.

To create a webhook:

1. Log in to the Delinea Platform with an administrator account.

2. Search for webhooks.

3. On the Webhooks page, select Create Webhook.

4. On the Create Webhook page, complete the following webhook configuration fields:

   • Name: Enter a unique name (for example, "Jira-Incident-Integration").

   • Endpoint URL: Paste the webhook URL copied from Jira in Step 1: Create an Incoming Webhook in Jira.

   • Description: Enter an optional brief description (for example, "Creates Jira incidents for Delinea security events").

   • Webhook State: Select Enabled.

5. Under Custom Headers, add the following header for Jira authentication:

   • Key: Enter X-Automation-Webhook-Token.

   • Value: Paste the secret copied from Jira in Step 1: Create an Incoming Webhook in Jira.

6. Under Triggers, select the Service, Level, and Event Type for events that should create Jira incidents.

7. To save the webhook configuration, select Save.

Verification

This section provides steps to verify that the integration between Jira Cloud and the Delinea Platform works correctly.

Validating Event Data

Perform the following steps to verify the event data that are sent to Jira.

1. In the Delinea Platform, navigate to Settings > General settings > Webhooks.

2. On the Webhooks page, select the Jira webhook.

3. Hover your cursor to the right of the webhook name, select the three dots that appear and then select View Webhook Logs.

4. Select a log entry and in the pane on the right, select View Payload to inspect the JSON data sent to Jira.

Verifying the Integration

1. In the Delinea Platform, search for webhooks.

2. On the Webhooks page, select the Jira webhook.

3. Hover your cursor to the right of the webhook name, select the three dots, and then select Test Webhook.

   The Delinea Platform sends a test event to the endpoint URL configured for the webhook.

4. Select the three dots to the right of the webhook name and then select View Webhook Logs.

5. Select a log entry and in the pane on the right, verify that the delivery status is Success.

6. In Jira, verify that an incident ticket was created in the target project.

7. Confirm that the fields (Summary, Description, Labels) in the incident ticket are correctly populated.

Troubleshooting

The following table provides guidance for common issues when integrating the Delinea Platform with Jira.

Issue	Possible Cause	Resolution
Webhook logs show Failed status	Incorrect Endpoint URL or authentication token.	Verify that the Webhook URL and Secret match the values from Jira Automation.
No Jira ticket created	The Jira automation rule is disabled or misconfigured.	In Jira, verify that the automation rule is enabled and the Create issue action is configured.
Jira ticket fields are empty	Incorrect smart value syntax in field mappings	Review the {{webhookData}} paths and compare against the payload structure in View Payload.
401 Unauthorized error	Missing or invalid X-Automation-Webhook-Token header	Confirm that the Custom Header key is exactly X-Automation-Webhook-Token and that the value matches the Jira Secret.
Webhook delivers no events after May 30, 2025	Endpoint URL uses the legacy automation.atlassian.com/pro/hooks/ format, which Atlassian decommissioned on May 30, 2025.	In Jira, regenerate the incoming webhook to obtain a new URL in the api-private.atlassian.com/automation/webhooks/jira/ format. Update the Endpoint URL field in the Delinea Platform webhook configuration.