This article explains how to integrate PagerDuty in Workbench.

Quick Start

  1. Step 1: Set Up PagerDuty Integration in Workbench
  2. Step 2: Configure Your Notifications in Workbench
  3. Step 3: Test Your Connection in Workbench
  4. Disconnect the PagerDuty Integration from Workbench
  5. Frequently Asked Questions

Step 1: Set Up PagerDuty Integration in Workbench

  1. From the main navigation bar, click Organization Settings.

    PagerDuty_Step1_1.png
  2. Click your organization name.

    PagerDuty_Step1_2.png
  3. Open the Integrations tab.

    PagerDuty_Step1_3.png
  4. Scroll down to PagerDuty and click Open PagerDuty to begin integration. (If you don't see it, click Add a PagerDuty destination and the link appears.)

    PagerDuty_Step1_4.png
  5. A new tab opens in your browser. Log in with your PagerDuty credentials.

  6. In PagerDuty, select which service you want to add the integration to or create a new integration, then click Connect.

    Note
    You can only select 1 service.

You're redirected to Workbench. If the integration is successful, you see a message. The PagerDuty connection information also appears.

Step 2: Configure Your Notifications in Workbench

  1. Open the Notifications tab.

    PagerDuty_Step2_1.png
  2. Find the When an incident is created notification and click the Pencil icon.

    PagerDuty_Step2_2.png
  3. Under Notify via, click Add another.

    PagerDuty_Step2_3.png
  4. Click Select destination and select PagerDuty from the list.

    PagerDuty_Step2_4.png
  5. PagerDuty_Step2_5.png
  6. (Optional) You can add PagerDuty to other notifications on this tab.

Step 3: Test Your Connection in Workbench

  1. Open the Integrations tab, scroll down to PagerDuty and click the Test connection link.

    PagerDuty_Step3_1.png
  2. The test creates and closes an incident in PagerDuty. Last tested shows the test date and a status message.

    PagerDuty_Step3_2.png
  3. In PagerDuty, navigate to your Incidents page. In the Activity for the Past 7 Days section, you see the test connection. It has a unique ID appended to the title. You see 2 rows for the test event, 1 for the triggered event and 1 for the resolved activity. That’s it!

Disconnect the PagerDuty Integration from Workbench

You can disconnect the PagerDuty integration from Workbench.

  1. In Workbench go to Organization Settings > My Organization > Integrations.

  2. Scroll to PagerDuty. Click the Pencil icon.

  3. Click Disconnect and delete. You no longer receive alert notifications from Expel through PagerDuty.

Frequently Asked Questions

Can Workbench send alerts to more than one PagerDuty service?

Not currently. As of now, alerts can only be configured to a single PagerDuty service.

Do PagerDuty incidents resolve after the security incident is complete in Workbench?

No. At this time, the PagerDuty incident must be resolved from PagerDuty.