Skip to main content

PagerDuty

PagerDuty is an incident management platform that provides notifications, automatic escalations, on-call scheduling, and other functionality to help teams detect and fix infrastructure problems quickly. GitGuardian is natively integrated with PagerDuty so all alerts sent by GitGuardian can be disseminated through PagerDuty flows.

PagerDuty + GitGuardian integration benefits#

  • Receive PagerDuty notifications for GitGuardian alerts
  • GitGuardian groups occurrences of the same secret under one single secret incident. Set the frequency of your notifications: either all occurrences of each secret incident, or only at the first occurence (only when the incident is newly created).

How it works#

When GitGuardian detects a secret in your source code, GitGuardian will send an event to a service in PagerDuty. Events from GitGuardian will trigger a new incident on the corresponding PagerDuty service, or group as alerts into an existing incident.

Requirements#

PagerDuty integrations require Admin rights on the PagerDuty service you want to receive notifications on (to create routing integration key needed for the integration on GitGuardian side).

If you do not have this role, please reach out to a PagerDuty Admin of your service to configure the integration.

Integration walkthrough#

In PagerDuty#

Integrating with a PagerDuty service

  1. From the Configuration menu, select Services.
  2. There are two ways to add an integration to a service:
    • If you are adding your integration to an existing service: click the name of the service you want to add the integration to. Then, select the Integrations tab and click the New Integration button.
    • If you are creating a new service for your integration: Please read PagerDuty documentation in section Configuring Services and Integrations and follow the steps outlined in the Create a New Service section, selecting GitGuardian as the Integration Type. Continue with the In GitGuardian section (below) once you have finished these steps.
  3. Select GitGuardian from the Integration Type menu (if you cannot find GitGuardian, please fallback on "Events API v2" type).
  4. Click the Add Integration button to save your new integration. You will be redirected to the Integrations tab for your service.
  5. An Integration Key will be generated on this screen. Keep this key saved in a safe place, as it will be used when you configure the integration with GitGuardian in the next section.

In GitGuardian#

  1. Navigate to Settings > Integrations > PagerDuty
  2. Provide your newly created integration key
  3. Select the frequency of notifications
  4. Submit

GG PagerDuty integration form

How to uninstall#

  1. Navigate to Settings > Integrations > PagerDuty
  2. Delete your integration key on GitGuardian
  3. Revoke your key on PagerDuty

PagerDuty integration keys table

Support#

If you need help with this integration, please contact support@gitguardian.com