Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Add Amazon Security Hub integration

If you're using the Free or Standard plan in Jira Service Management, you can only add this integration from your team’s operations page. To access the feature through Settings (gear icon) > Products (under JIRA SETTINGS) > OPERATIONS, you need to be on Premium or Enterprise plan.

Adding an integration from your team’s operations page makes your team the owner of the integration. This means Jira Service Management assigns the alerts received through this integration to your team only.

To add an integration:

  1. Go to your team’s operations page.

  2. On the left navigation panel, select Integrations and then Add integration.

Complete the rest of the steps in the procedure.

To add an Amazon Security Hub integration in Jira Service Management:

...

  1. Create a custom Security Hub action.

  2. Create a rule in CloudWatch Events for Security Hub findings and an SNS topic for CloudWatch Event target by using the CloudFormation template.

  3. Paste the URL you copied while adding the integration in Jira Service Management into SNSSubEndpoint in the CloudFormation template.

  4. Copy-paste the following (after entering the custom Security Hub action ARN you created in Step 1) into EventPatternParameter in the CloudFormation template.

    Code Block
    {
      "source": [
        "aws.securityhub"
      ],
      "detail-type": [
        "Security Hub Findings - Custom Action"
      ],
      "resources": [
        "< CUSTOM ACTION ARN YOU CREATED IN SECURITY HUB >"
      ]
    }
  5. If the configuration is successful, a confirmation alert is created in Jira Service Management.

  6. Select Send Alert Updates Back to AmazonSecurityHubalert updates back to Amazon Security Hub to enable the outgoing functionality.

  7. Allow Jira Service Management to access the Security Hub resources through an IAM Role.
    Use CloudFormation template to create an IAM role.

  8. Copy-paste the IAM Role ARN into AmazonSecurityHub Role ARN.

  9. Select the AWS region where you’ve set up the Security Hub.

...

  1. Go to Amazon EventBridge and select Rules.

  2. Select Create rule.

  3. In Step 1, enter a Name and Description for this rule.

  4. Select Rule with an event patterns as Rue type and select Next.

  5. In Step 2, select AWS events and EventBrigde partner events as the Event source.

  6. Then, select AWS services as Event source.

  7. Select Security Hub as AWS Service.

  8. In the Event Type section, select the custom action you created in the security hub.

  9. Select Next.

  10. In Step 3, select SNS topic from the dropdown menu in Target types, then select the topic you created before in the Topic field.

  11. Select Next.

  12. In Step 5, review and create the rule.

Send alert updates back to Amazon Security Hub

Complete the following steps in Jira Service Management to send alert updates back to Amazon Security Hub:

  1. From the Amazon Security Hub integration pageintegration page in Jira Service Management, select the Send Alert Updates Back to AmazonSecurityHub checkboxalert updates back to Amazon Security Hub check box.

  2. Allow Jira Service Management to access security hub resources using an IAM Role. To create a role that allows Jira Service Management to access security hub resources, you can use the CloudFormation template.

  3. Make sure that all the input parameters to the cloudformation template are correct, like ApiKey (such as the API URL from the SecurityHub integration page (pre-populated), Jira Service Management Aws AccountId (pre-populated), and RoleName) are correct. Role The role name should be in opsgenieSecurityHubRolejsmSecurityHubRole* format.

  4. Copy the IAM role ARN created above in the previous step and paste it here into AmazonSecurityHub Role ARN and select the region where the security hub Security Hub is enabled.Select Save Integration to send alert action updates back to Amazon Security Hub findings.

Sample payload from Amazon Security Hub

...