Chapter 15. Integrating with Jira

Procedure

1. On the RHACS portal, navigate to Platform Configuration Integrations.
2. Scroll down to the Notifier Integrations section and select Jira Software.
3. Click New Integration.
4. Enter a name for Integration Name.
5. Enter the user credentials in the Username and Password or API Token boxes.
6. For Issue Type, enter a valid Jira Issue Type, for example Task, Sub-task, or Bug.
7. Enter the Jira server URL in the Jira URL box.
8. Enter the key of the project in which you want to create issues in the Default Project box.
9. Use the Annotation Key For Project box to create issues in different Jira projects.
10. If you use custom priorities in your Jira project, use the Priority Mapping toggle to configure custom priorities.

11. If you use mandatory custom fields in your JIRA project, enter them as JSON values in the Default Fields JSON (Necessary If Required Fields) box. For example:

    {
      "customfield_10004": 3,
      "customfield_20005": "Alerts",
    }

12. Select Test (checkmark icon) to test that the integration with Jira is working.
13. Select Create (save icon) to create the configuration.

Procedure

1. On the RHACS portal, navigate to Platform Configuration Policies.
2. Select one or more policies for which you want to send alerts.
3. Under Bulk actions, select Enable notification.

4. In the Enable notification window, select the Jira notifier.

   Note

   If you have not configured any other integrations, the system displays a message that no notifiers are configured.

5. Click Enable.

Procedure

1. To get the custom priority values from your JIRA project, run the following command to turn on debug logging for JIRA integration:

   $ roxctl -e "$ROX_CENTRAL_ADDRESS" central debug log --level Debug --modules notifiers/jira

2. Follow the instructions to configure Red Hat Advanced Cluster Security for Kubernetes for Jira integration. When you test the integration, even if the integration test fails, the generated log includes your JIRA project schema and the custom priorities.

3. To save the debugging information as a compressed .zip file, run the following command:

   $ roxctl -e "$ROX_CENTRAL_ADDRESS" central debug dump

4. Unzip the .zip file to retrieve the custom priority values in use in your JIRA project.

5. To turn off debug logging, run the following command:

   $ roxctl -e "$ROX_CENTRAL_ADDRESS" central debug log --level Info

6. Configure Red Hat Advanced Cluster Security for Kubernetes for Jira integration again and use the priority values to configure custom priorities.