PagerDuty

PagerDuty est une plateforme de gestion d'incidents qui fournit notifications, escalades automatiques, planification d'astreinte et autres fonctionnalités pour aider les équipes à détecter et corriger rapidement les problèmes d'infrastructure. GitGuardian s'intègre nativement à PagerDuty afin que toutes les alertes envoyées par GitGuardian puissent être diffusées via les flux PagerDuty.

Bénéfices de l'intégration PagerDuty + GitGuardian

• Recevez des notifications PagerDuty pour les alertes GitGuardian
• GitGuardian regroupe les occurrences du même secret sous un seul incident de secret. Définissez la fréquence de vos notifications : soit toutes les occurrences de chaque incident de secret, soit uniquement à la première occurrence (uniquement quand l'incident est nouvellement créé).

Comment ça fonctionne

Lorsque GitGuardian détecte un secret dans votre code source, GitGuardian enverra un événement à un service dans PagerDuty. Les événements de GitGuardian déclencheront un nouvel incident sur le service PagerDuty correspondant, ou seront groupés comme logs d'alertes dans un incident existant.

Prérequis

Les intégrations PagerDuty nécessitent les droits Admin sur le service PagerDuty sur lequel vous souhaitez recevoir les notifications (pour créer la clé d'intégration de routage nécessaire à l'intégration côté GitGuardian). Si ce n'est pas votre cas, contactez un administrateur PagerDuty de votre service pour configurer l'intégration.

Tutoriel d'intégration

Dans PagerDuty

Intégration avec un service PagerDuty

1. Depuis le menu Configuration, sélectionnez Services.
2. Il y a deux façons d'ajouter une intégration à un service :
   • Si vous ajoutez votre intégration à un service existant : cliquez sur le nom du service auquel vous voulez ajouter l'intégration. Puis, sélectionnez l'onglet Integrations et cliquez sur le bouton New Integration.
   • Si vous créez un nouveau service pour votre intégration : lisez la documentation PagerDuty dans la section Configuring Services and Integrations et suivez les étapes de la section Create a New Service, en sélectionnant GitGuardian comme Integration Type. Continuez avec la section In GitGuardian (ci-dessous) une fois ces étapes terminées.
3. Sélectionnez GitGuardian dans le menu Integration Type (si vous ne trouvez pas GitGuardian, repliez-vous sur le type « Events API v2 »).
4. Cliquez sur le bouton Add Integration pour sauvegarder votre nouvelle intégration. Vous serez redirigé vers l'onglet Integrations de votre service.
5. Une Integration Key sera générée sur cet écran. Gardez cette clé sauvegardée dans un endroit sûr, car elle sera utilisée lors de la configuration de l'intégration avec GitGuardian dans la section suivante.

Dans GitGuardian

1. Naviguez vers Settings > Integrations > Destinations > PagerDuty
2. Fournissez votre clé d'intégration nouvellement créée
3. Sélectionnez la fréquence des notifications
4. Soumettez

Pour un workspace business, la configuration de l'intégration PagerDuty est faite par équipe. Vous pouvez soit créer une seule configuration au sein de l'équipe All-incidents pour envoyer tous les incidents GitGuardian au même projet PagerDuty, soit créer des configurations séparées pour chaque équipe afin d'envoyer leurs incidents à des projets spécifiques.

Comment désinstaller

1. Naviguez vers Settings > Integrations > Destinations > PagerDuty
2. Supprimez votre clé d'intégration sur GitGuardian
3. Révoquez votre clé sur PagerDuty