Integrating Invicti Enterprise with PagerDuty

PagerDuty is a digital operations management platform. It is designed to alert clients to disruptions and outages through the use of machine learning and automation. These issues are identified in real-time, alerting the right people to respond to any problems faster so that they are prevented in the future.

This topic explains how to configure Invicti Enterprise to send a detected vulnerability PagerDuty.

For further information, see What Systems Does Invicti Integrate With?.

PagerDuty fields

This table lists and explains the PagerDuty fields in the New PagerDuty Integration window.

How to integrate Invicti Enterprise with PagerDuty

1. Log in to Invicti Enterprise.
2. From the main menu, go to Integrations > New Integration.

3. From the Issue Tracking Systems section, select PagerDuty.

4. In the Name field, enter a name for the integration
5. In the Mandatory section, complete the connection details:

• URL
• From
• Api Access Key
• Service ID

5. Open PagerDuty.
6. From the main menu, select Integrations > API Access Keys. 

7. From the API Access Keys page, select Create New API Key.

8. From the Create API Key pop-up, enter a description and select Create Key. (If you select Create New API Key to create a new API Key do not select Read-only API Key.)

9. Copy the API Key value from PagerDuty (you will need it in the next step).

10. In Invicti Enterprise, paste the API Key into the API Access Key field in Invicti Enterprise
11. In PagerDuty, you now need to access the Service ID. From the main menu, select Services > Service Directory. The current Services are displayed. (Or you can create a new Service by selecting New Service.)

12. Select the title of the service.
13. The value in the last part of the URL of the detail page is the Service ID.

14. Copy the Service ID value from PagerDuty (you will need it in the next step).
15. In Invicti Enterprise, paste the Service ID into the Service ID field.
16. Select Create Sample Issue to confirm that Invicti Enterprise can connect to the configured system. A confirmation message is displayed to confirm that the sample issue has been successfully created.
17. In the confirmation message, select the Issue number link to open the issue in your default browser.
18. If the PagerDuty integration is not configured correctly, Invicti Enterprise will correctly route the following descriptive error messages to you. Sample error messages may be displayed as illustrated:

• If the Service ID was entered incorrectly

• If the From or API Access Key  was entered incorrectly

19. Select Save to save the integration.

How to export reported vulnerabilities to projects in PagerDuty

There are several ways to send issues to PagerDuty with Invicti Enterprise:

Once notifications have been configured, you can configure Invicti Enterprise to automatically send vulnerabilities to PagerDuty after scanning has been completed (see How to Configure a Notification to Report Vulnerabilities to an Issue Tracking System).

You can send one or more issues from the Issues window:

• You must have Manage Issue permission.
• From the main menu, select Issues, then All Issues. 
• From the Issues page, select one or more issues you want to send.
• Select Send To > PagerDuty.

A pop-up is displayed, with a link to the issue you have sent to PagerDuty. If there is an error, this information will be displayed instead.

You can also send an issue from the Recent Scans window:

• From the main menu, select Scans > Recent Scans.

• Next to the relevant scan, select Report. The report is displayed.
• Scroll down to the Technical Report section.
• From the list of detected vulnerabilities, click to select an issue and display its details.
• Select Send To > PagerDuty

If you have previously submitted this vulnerability to PagerDuty, it will already be accessible. You cannot submit the same issue twice.

• If you view opened problem logs in PagerDuty, they look like this.

• Incident details on PagerDuty look like this.