Configurer la synchro bidirectionnelle PagerDuty

Connectez votre compte PagerDuty afin que les mises à jour d'incidents circulent dans les deux sens — cette configuration optionnelle et ponctuelle s'adresse à toute personne qui gère les canaux d'alerte de son organisation.

Aperçu

• Alerter PagerDuty fonctionne déjà avec une simple clé de routage — aucune configuration n'est nécessaire pour cela.
• Ce guide ajoute le sens inverse : lorsque quelqu'un accuse réception ou résout un incident dans PagerDuty, l'incident InfraNest correspondant est mis à jour en conséquence.
• Vous configurez cela une seule fois pour le compte PagerDuty de votre organisation.

Ce dont vous aurez besoin :

• Vous gérez les canaux d'alerte de votre organisation.
• L'accès à Integrations → Generic Webhooks (v3) de votre compte PagerDuty.

Récupérer votre URL de webhook depuis InfraNest

1. Allez dans Alertes, puis Destinations, et ajoutez ou modifiez votre destination PagerDuty.
2. Dans le panneau Synchronisation bidirectionnelle (optionnel), copiez l'URL du webhook entrant. Elle est unique à votre organisation — traitez-la comme un secret.

Créer le webhook dans PagerDuty

1. Dans PagerDuty, allez dans Integrations → Generic Webhooks (v3) et sélectionnez New Webhook.
2. Collez votre URL de webhook InfraNest comme destination.
3. Abonnez le webhook aux événements souhaités. Abonnez-le au minimum à incident.acknowledged et incident.resolved pour la synchronisation bidirectionnelle. Pour utiliser également les événements PagerDuty comme déclencheurs d'automatisation, ajoutez incident.triggered, incident.escalated et incident.reopened.
4. Enregistrez. PagerDuty affiche alors un Signing secret — copiez-le immédiatement. Il n'est affiché qu'une seule fois, et vous ne pouvez pas en choisir un vous-même.

Ajouter le secret à InfraNest

1. Retournez dans le panneau Synchronisation bidirectionnelle (optionnel) et collez le secret de signature fourni par PagerDuty.
2. Sélectionnez Enregistrer. Le panneau indique qu'il est configuré une fois défini.

NoteLe secret nous permet de savoir qu'une requête provient réellement de PagerDuty. Être connecté via OAuth ne couvre pas ce point — c'est notre clé pour appeler eux. Tant que le secret n'est pas défini, nous ignorons tout ce qui arrive sur l'URL.

Et voilà. Accuser réception ou résoudre un incident dans l'un ou l'autre outil met désormais à jour l'autre.

Astuces

• L'URL du webhook et le secret sont propres à chaque organisation — chaque organisation configure les siens, par rapport à son propre compte PagerDuty.
• Le secret de signature est stocké chiffré et n'est plus jamais affiché. Laissez le champ vide lors de la modification pour conserver celui existant.
• Seuls les accusés de réception et les résolutions d'incidents sont pris en compte en entrée ; l'envoi d'alertes vers PagerDuty reste inchangé.
• Les requêtes sans signature valide sont rejetées, de sorte que seul votre compte PagerDuty peut mettre à jour vos incidents.

Dépannage

Les actions PagerDuty ne mettent pas à jour InfraNest. Vérifiez à nouveau que le webhook est abonné à incident.acknowledged et incident.resolved, que le secret saisi est bien celui émis par PagerDuty pour ce webhook spécifique (un autre webhook a un secret différent), et que l'URL du webhook correspond exactement à celle affichée dans InfraNest.

Vous ne trouvez pas où définir un secret dans PagerDuty. Il n'y en a pas à définir vous-même — PagerDuty le génère et l'affiche une seule fois, lors de la création du webhook. Si vous l'avez manqué, supprimez le webhook et recréez-le.