Aller au contenu
StartupKit
FR

Intégration PagerDuty

Connectez PagerDuty pour recevoir des alertes VDP, synchroniser les plannings d'astreinte et suivre le statut des incidents dans Kit.

Pourquoi c’est important

PagerDuty est l’outil que la plupart des équipes de sécurité utilisent déjà pour gérer les incidents et les astreintes. Le connecter à Kit signifie que les rapports de vulnérabilité nécessitant une attention immédiate déclenchent de vraies alertes, et non de simples e-mails qui restent dans une boîte de réception toute la nuit.

Prérequis

  • Abonnement Kit actif
  • Compte PagerDuty avec les droits pour créer des clés API
  • Un service PagerDuty dédié aux alertes VDP (recommandé)

Configuration

1. Créer une clé API PagerDuty

  1. Accédez à PagerDuty > Integrations > API Access Keys
  2. Cliquez sur Create New API Key
  3. Nommez-la « Kit VDP » et copiez la clé

2. Obtenir votre clé d’intégration

  1. Accédez à PagerDuty > Services > Your VDP Service > Integrations
  2. Ajoutez une intégration Events API v2 (ou utilisez-en une existante)
  3. Copiez la Integration Key (aussi appelée routing key)

Pour que les alertes de chaque composant parviennent à l’équipe qui en a la charge, utilisez plutôt la clé d’intégration d’une Event Orchestration. Voir Acheminer chaque alerte vers son équipe.

3. Connecter dans Kit

  1. Accédez à VDP > Paramètres > PagerDuty
  2. Collez les deux clés et cliquez sur Connecter à PagerDuty
  3. Kit valide la connexion et affiche un badge de statut vert

Événements d’alerte

Configurez les événements qui déclenchent une alerte PagerDuty. Chaque événement a sa propre sévérité, Warning tant que vous ne la modifiez pas.

Événement Déclenchement
Nouveau rapport soumis Un chercheur soumet un rapport de vulnérabilité
SLA en danger Un rapport approche de son échéance SLA (vérifié toutes les 15 min)
SLA dépassé Un rapport dépasse son échéance SLA
Sévérité critique évaluée Vous validez un rapport dont la sévérité fait partie de vos sévérités d’escalade (Critique et Super critique par défaut)
Rapport validé Vous validez un rapport, quelle que soit sa sévérité
Rapport bloqué escaladé Kit escalade un rapport en attente auprès des administrateurs de votre programme

Contenu d’une alerte : l’événement, la sévérité évaluée, le composant du rapport et son identifiant, par exemple SLA breached · Critical · Payments API — rpt_8Kd2. La source de l’incident indique le nom de votre programme. Kit ne copie jamais dans PagerDuty un texte rédigé par le chercheur (titre, type de vulnérabilité, description), si bien qu’un rapport ne peut pas faire apparaître ses propres mots sur le téléphone de la personne d’astreinte. Un rapport restreint déclenche une alerte Restricted report needs attention — rpt_8Kd2, sans son événement, sa sévérité ni son composant. L’alerte garde la sévérité définie par sa règle, si bien que l’astreinte reçoit toujours le bon niveau d’urgence.

Un seul incident par rapport

Kit rattache chaque alerte au rapport concerné, de sorte qu’un rapport n’a jamais plus d’un incident PagerDuty ouvert. Le premier événement l’ouvre. Tant qu’il est ouvert, les événements suivants sur ce rapport ne déclenchent pas de nouvelle alerte : PagerDuty les ajoute au journal des alertes de l’incident comme autant de nouveaux déclenchements. L’incident garde ainsi l’historique du rapport. Si Sévérité critique évaluée et Rapport validé sont tous deux activés, valider un rapport Critique ne déclenche qu’une seule alerte, et non deux.

Quand un rapport s’aggrave : PagerDuty conserve la sévérité la plus élevée reçue pour un incident. Si Rapport validé a ouvert l’incident en Warning et que Sévérité critique évaluée se déclenche ensuite en Critical, l’incident devient Critical. Sur un service configuré en notifications dynamiques, il passe alors de l’urgence faible à l’urgence élevée, et vos règles de notification d’urgence élevée s’appliquent. Sur un service à urgence fixe, le nouvel événement s’ajoute seulement au journal des alertes, et PagerDuty ne renvoie pas de notification pour un incident déjà acquitté. Pour recevoir une alerte quand un rapport devient critique, activez les notifications dynamiques et attribuez à Sévérité critique évaluée une sévérité plus élevée qu’à vos autres règles.

Les déclenchements répétés de SLA dépassé sont eux aussi limités avant même d’atteindre PagerDuty, par le budget d’alertes de dépassement de votre programme : trois répétitions espacées de six heures, par défaut.

Acheminer chaque alerte vers son équipe

Kit envoie toutes les alertes à une seule clé d’intégration. Avec la clé d’un service, chaque alerte arrive dans ce service. Pour alerter l’équipe responsable du composant d’un rapport, collez plutôt dans Kit la clé d’intégration d’une Event Orchestration et laissez l’orchestration choisir le service. Les règles d’acheminement des orchestrations sont disponibles avec toutes les offres PagerDuty.

  1. Dans PagerDuty, ouvrez Event Orchestration (sous Configuration > Events & Routing, ou sous AIOps sur certains comptes) et créez une orchestration
  2. Ouvrez ses Integrations et copiez la clé d’intégration
  3. Dans Kit, collez-la comme Clé d’intégration dans VDP > Paramètres > PagerDuty
  4. Ajoutez une Service Route par composant, avec la condition event.custom_details.component_id matches 'cmp_…'. Copiez l’identifiant de chaque composant depuis VDP > Paramètres du programme > Composants. L’identifiant ne change pas quand vous renommez un composant, donc une route qui s’appuie dessus continue de fonctionner
  5. Modifiez la route catch-all pour qu’elle envoie les événements sans correspondance à votre service de triage

Ne négligez pas la route catch-all : par défaut, PagerDuty neutralise une alerte qui ne correspond à aucune route : elle reste silencieuse et personne n’est prévenu. Les alertes de nouveau rapport arrivent en général avant que quelqu’un attribue un composant, et les rapports restreints n’en portent jamais : les unes comme les autres n’atteignent que la route catch-all.

L’acheminement suit la première alerte de l’incident : un incident reste dans le service où il s’est ouvert, et les alertes suivantes du rapport l’y rejoignent. Changer le composant d’un rapport n’alerte personne. L’alerte suivante du rapport résout l’incident ouvert dans son ancien service et ouvre un nouvel incident pour le nouveau composant, si bien qu’un rapport n’a jamais deux incidents ouverts. L’alerte d’un agent de revue rejoint l’incident ouvert sans le déplacer. Seul le composant que vous confirmez sur le rapport oriente une alerte, jamais un composant suggéré.

Champ Ce que Kit envoie
component Le nom du composant du rapport, omis si le rapport n’en a pas ou s’il est restreint
group Le nom de votre programme
class L’événement : new_report, sla_at_risk, sla_breach, critical_assessment, report_validated, escalation, ou agent_escalation quand un agent de revue signale un rapport potentiellement critique. Toujours restricted_report pour un rapport restreint
custom_details.component_id L’identifiant du composant, cmp_…
custom_details.component Le nom du composant
custom_details.program_id L’identifiant de votre programme
custom_details.report_id L’identifiant du rapport, rpt_…
custom_details.severity La sévérité évaluée, omise pour les rapports restreints

L’alerte d’un rapport restreint ne mentionne ni composant, ni sévérité évaluée, ni événement : seulement l’identifiant du rapport, votre programme et restricted_report comme événement.

Le Dynamic Routing de PagerDuty peut aussi choisir le service à partir d’un champ de l’événement, mais seulement sur les orchestrations dotées du module complémentaire AIOps, et il abandonne un événement dont le champ d’acheminement est illisible. Une route par composant reste la configuration la plus sûre.

Synchronisation du planning d’astreinte

Lorsqu’elle est activée, Kit interroge votre planning PagerDuty toutes les 5 minutes et met à jour automatiquement la personne d’astreinte dans Kit.

  1. Sur la page des paramètres PagerDuty, sélectionnez un planning dans le menu déroulant
  2. Kit associe les utilisateurs PagerDuty aux utilisateurs Kit par adresse e-mail
  3. Sur la page Astreinte, sélectionnez le mode PagerDuty

Si un utilisateur PagerDuty n’est pas trouvé dans Kit : le tour de garde précédent reste actif et un avertissement apparaît sur la page des paramètres.

Le remplacement manuel reste possible en mode PagerDuty. Le planning reprend à la prochaine synchronisation.

Mises à jour d’incident (bidirectionnelles)

Lorsque quelqu’un acquitte ou résout un incident PagerDuty, Kit reçoit la mise à jour via webhook et la reflète sur la chronologie du rapport.

Action PagerDuty Effet dans Kit
Incident acquitté Le rapport affiche le statut « Acquitté via PagerDuty »
Incident résolu Le rapport affiche le statut « Résolu via PagerDuty »

Important : les changements de statut PagerDuty ne déclenchent pas de transition automatique du rapport. Les décisions de triage (validation, rejet, résolution) restent manuelles dans Kit.

Clôturer un rapport résout son incident

Lorsqu’un rapport quitte les statuts ouverts (vous le marquez comme résolu, le clôturez comme informatif ou le rejetez, y compris comme doublon), Kit résout l’incident PagerDuty associé au rapport. Passer d’un statut de clôture à un autre, par exemple de Résolu à Correctif vérifié, n’envoie rien. Une fois l’incident résolu, dans Kit ou dans PagerDuty, le prochain événement sur ce rapport ouvre un nouvel incident, par exemple si un rapport clôturé est rouvert et déclenche une nouvelle alerte.

Configurer le webhook

  1. Copiez l’URL du webhook affichée sur la page des paramètres PagerDuty
  2. Dans PagerDuty, accédez à Integrations > Generic Webhooks (v3)
  3. Créez un nouvel abonnement webhook avec votre URL Kit
  4. Sélectionnez les événements : incident.acknowledged et incident.resolved

Dépannage

Symptôme Cause Solution
« Échec de connexion » à l’enregistrement Jeton API invalide Régénérez le jeton dans PagerDuty et collez-le à nouveau
Les alertes ne créent pas d’incidents Événement non activé dans les règles d’alerte Vérifiez l’interrupteur de chaque type d’événement sur la page des paramètres
Un événement ultérieur n’a déclenché aucune alerte Le rapport a déjà un incident ouvert Retrouvez l’événement dans le journal des alertes de cet incident sur PagerDuty
Les alertes n’atteignent personne Elles ne correspondent à aucune route, et la route catch-all les neutralise Dirigez la route catch-all de l’orchestration vers votre service de triage
Une alerte est encore partie vers l’ancienne équipe L’incident s’est ouvert avant le changement de composant L’alerte suivante du rapport ouvre l’incident dans le service du nouveau composant
L’astreinte ne se synchronise pas L’e-mail de l’utilisateur PD ne correspond pas à l’utilisateur Kit Assurez-vous que l’adresse e-mail de l’utilisateur PagerDuty correspond à celle de son compte Kit
La connexion affiche un badge d’erreur rouge Le jeton API a été révoqué ou a expiré Reconnectez-vous avec un nouveau jeton ; Kit suspend toutes les alertes en cas d’échec d’authentification

En bref

  • Créer une clé API PagerDuty limitée à votre service VDP
  • Coller la clé API et la clé d’intégration dans VDP > Paramètres > PagerDuty
  • Activer au moins une règle d’alerte (recommandé : SLA dépassé + évaluation critique)
  • (Optionnel) Sélectionner un planning PagerDuty pour la synchronisation d’astreinte
  • (Optionnel) Configurer le webhook dans PagerDuty pour les mises à jour bidirectionnelles
  • Vérifier en cliquant sur Test sur la page des paramètres

Tapez pour rechercher...