PagerDuty-Zwei-Wege-Sync einrichten

Verbinde dein PagerDuty-Konto, damit Vorfall-Updates in beide Richtungen fließen — diese optionale, einmalige Einrichtung ist für alle gedacht, die Benachrichtigungsziele für ihre Organisation verwalten.

Überblick

• PagerDuty alarmieren funktioniert bereits mit nur einem Routing-Key — dafür ist keine Einrichtung nötig.
• Diese Anleitung fügt die umgekehrte Richtung hinzu: Wenn jemand einen Vorfall in PagerDuty bestätigt oder löst, wird der passende InfraNest-Vorfall entsprechend aktualisiert.
• Du richtest dies einmal für das PagerDuty-Konto deiner Organisation ein.

Was du benötigst:

• Du verwaltest Benachrichtigungsziele für deine Organisation.
• Zugriff auf die Integrations → Generic Webhooks (v3) deines PagerDuty-Kontos.

Webhook-URL aus InfraNest abrufen

1. Gehe zu Benachrichtigungen, dann Ziele, und füge dein PagerDuty-Ziel hinzu oder bearbeite es.
2. Kopiere im Bereich Zwei-Wege-Sync (optional) die Eingehende Webhook-URL. Sie ist einzigartig für deine Organisation — behandle sie wie ein Geheimnis.

Webhook in PagerDuty erstellen

1. Gehe in PagerDuty zu Integrations → Generic Webhooks (v3) und wähle New Webhook.
2. Füge deine InfraNest-Webhook-URL als Ziel ein.
3. Abonniere den Webhook für die gewünschten Ereignisse. Abonniere mindestens incident.acknowledged und incident.resolved für die Zwei-Wege-Sync. Um PagerDuty-Ereignisse auch als Automatisierungs-Trigger zu nutzen, füge incident.triggered, incident.escalated und incident.reopened hinzu.
4. Speichern. PagerDuty zeigt dann ein Signing secret — kopiere es jetzt. Es wird nur einmal angezeigt, und du kannst kein eigenes wählen.

Geheimnis zu InfraNest hinzufügen

1. Füge im Bereich Zwei-Wege-Sync (optional) das von PagerDuty erhaltene Signing Secret ein.
2. Wähle Speichern. Der Bereich zeigt an, dass es konfiguriert ist, sobald es eingerichtet ist.

NoteDas Geheimnis ist die Methode, mit der wir erkennen, dass eine Anfrage wirklich von PagerDuty stammt. Die Verbindung über OAuth deckt dies nicht ab — das ist unser Schlüssel, um sie aufzurufen. Bis das Geheimnis gesetzt ist, ignorieren wir alles, was über die URL eingeht.

Das war's. Das Bestätigen oder Lösen eines Vorfalls in einem der beiden Tools aktualisiert jetzt das andere.

Tipps

• Die Webhook-URL und das Geheimnis gelten pro Organisation — jede Organisation richtet ihre eigenen ein, gegen ihr eigenes PagerDuty-Konto.
• Das Signing Secret wird verschlüsselt gespeichert und nie wieder angezeigt. Lasse das Feld beim Bearbeiten leer, um das bestehende beizubehalten.
• Nur das Bestätigen und Lösen von Vorfällen fließt eingehend; das Alarmieren an PagerDuty bleibt unverändert.
• Anfragen ohne gültige Signatur werden abgelehnt, sodass nur dein PagerDuty-Konto deine Vorfälle aktualisieren kann.

Fehlerbehebung

PagerDuty-Aktionen aktualisieren InfraNest nicht. Prüfe erneut, dass der Webhook für incident.acknowledged und incident.resolved abonniert ist, dass das eingegebene Geheimnis dasjenige ist, das PagerDuty für diesen speziellen Webhook ausgestellt hat (ein anderer Webhook hat ein anderes Geheimnis), und dass die Webhook-URL genau der in InfraNest angezeigten entspricht.

Du findest nicht, wo man in PagerDuty ein Geheimnis festlegt. Es gibt keins, das du selbst festlegst — PagerDuty generiert es und zeigt es einmal an, wenn der Webhook erstellt wird. Falls du es verpasst hast, lösche den Webhook und erstelle ihn erneut.