## 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

- Compte Kit avec le **module VDP** activé
- 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)

### 3. Connecter dans Kit

1. Naviguez vers **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 quels événements créent des incidents PagerDuty. Chaque événement dispose d'un niveau de sévérité configurable.

| Événement | Déclenchement | Sévérité par défaut |
|-----------|--------------|---------------------|
| Nouveau rapport soumis | Un chercheur soumet un rapport de vulnérabilité | Info |
| SLA à risque | Un rapport approche de son échéance SLA (vérifié toutes les 15 min) | Warning |
| SLA en dépassement | Un rapport dépasse son échéance SLA | Warning |
| Sévérité critique évaluée | Un rapport est évalué comme critique ou super-critique | Critical |
| War room activée | 2+ rapports sont simultanément à risque ou en dépassement | Error |

**Déduplication** : Kit utilise l'identifiant du rapport comme clé de dedup. Si le même rapport déclenche plusieurs vérifications SLA, PagerDuty les fusionne en un seul incident au lieu de créer des doublons.

## 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 précédent reste actif et un avertissement apparaît sur la page des paramètres.

Le passage de relais manuel reste disponible 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.

### 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 le bouton de chaque type d'événement sur la page des paramètres |
| 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 |

## Liste de contrôle rapide

- [ ] 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 en dépassement + é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