Zum Inhalt springen
StartupKit
DE

PagerDuty-Integration

Verbinden Sie PagerDuty, um VDP-Benachrichtigungen zu empfangen, Rufbereitschaftspläne zu synchronisieren und den Incident-Status in Kit zu verfolgen.

Warum das zählt

PagerDuty ist der Ort, an dem die meisten Sicherheitsteams bereits Incidents und Rufbereitschaften verwalten. Die Verbindung mit Kit bewirkt, dass Schwachstellenmeldungen, die sofortige Aufmerksamkeit erfordern, echte Pages auslösen statt nur E-Mails, die über Nacht ungelesen im Postfach liegen.

Voraussetzungen

  • Aktives Kit-Abonnement
  • PagerDuty-Konto mit Berechtigung zur Erstellung von API-Schlüsseln
  • Ein dedizierter PagerDuty-Service für VDP-Benachrichtigungen (empfohlen)

Einrichtung

1. PagerDuty-API-Schlüssel erstellen

  1. Gehen Sie zu PagerDuty > Integrations > API Access Keys
  2. Klicken Sie auf Create New API Key
  3. Benennen Sie ihn “Kit VDP” und kopieren Sie den Schlüssel

2. Integration Key abrufen

  1. Gehen Sie zu PagerDuty > Services > Your VDP Service > Integrations
  2. Fügen Sie eine Events API v2-Integration hinzu (oder verwenden Sie eine vorhandene)
  3. Kopieren Sie den Integration Key (auch Routing Key genannt)

Damit die Pages jeder Komponente beim zuständigen Team landen, verwenden Sie stattdessen den Integration Key einer Event Orchestration. Siehe Pages an das zuständige Team leiten.

3. Verbindung in Kit herstellen

  1. Navigieren Sie zu VDP > Einstellungen > PagerDuty
  2. Fügen Sie beide Schlüssel ein und klicken Sie auf Mit PagerDuty verbinden
  3. Kit validiert die Verbindung und zeigt ein grünes Status-Badge an

Benachrichtigungsereignisse

Konfigurieren Sie, welche Ereignisse eine Page in PagerDuty auslösen. Jedes Ereignis hat einen eigenen Schweregrad; solange Sie ihn nicht ändern, ist das Warning.

Ereignis Auslöser
Neue Meldung eingereicht Ein Forscher reicht eine Schwachstellenmeldung ein
SLA gefährdet Eine Meldung nähert sich ihrer SLA-Frist (alle 15 Min. geprüft)
SLA-Verletzung Eine Meldung hat ihre SLA-Frist überschritten
Kritischer Schweregrad bewertet Sie validieren eine Meldung, deren Schweregrad zu Ihren Eskalations-Schweregraden gehört (standardmäßig Kritisch und Super-kritisch)
Meldung validiert Sie validieren eine Meldung, gleich welchen Schweregrads
Festgefahrene Meldung eskaliert Eine festgefahrene Meldung wird an Ihre Programmadministratoren eskaliert

Was eine Page enthält: das Ereignis, den bewerteten Schweregrad, die Komponente der Meldung und ihre ID, zum Beispiel SLA breached · Critical · Payments API — rpt_8Kd2. Als Quelle des Incidents ist Ihr Programm angegeben. Kit übernimmt nie Text, den ein Forscher verfasst hat (Titel, Schwachstellentyp, Beschreibung), in PagerDuty. So kann eine Meldung keine eigenen Worte auf das Handy Ihrer Bereitschaftsperson bringen. Eine eingeschränkte Meldung löst eine Page als Restricted report needs attention — rpt_8Kd2 aus, ohne Ereignis, Schweregrad und Komponente. Die Page behält den Schweregrad ihrer Alarmregel, damit die Bereitschaft trotzdem mit der richtigen Dringlichkeit alarmiert wird.

Ein Incident pro Meldung

Kit versieht alle Pages einer Meldung mit demselben Schlüssel, deshalb hat jede Meldung höchstens einen offenen PagerDuty-Incident. Das erste Ereignis öffnet ihn. Solange er offen ist, lösen spätere Ereignisse derselben Meldung keine weitere Page aus: PagerDuty trägt jedes davon als weiteren Trigger ins Alert-Log des Incidents ein, und so sammelt sich dort der Verlauf der Meldung. Sind Kritischer Schweregrad bewertet und Meldung validiert beide aktiv, löst die Validierung einer kritischen Meldung nur eine Page aus, nicht zwei.

Wenn eine Meldung ernster wird: Für einen Incident gilt bei PagerDuty der höchste Schweregrad, der dafür eingegangen ist. Hat Meldung validiert den Incident mit Warning geöffnet und folgt später Kritischer Schweregrad bewertet mit Critical, wird der Incident auf Critical hochgestuft. Bei einem Service mit dynamischen Benachrichtigungen steigt der Incident dadurch von niedriger auf hohe Dringlichkeit und folgt Ihren Benachrichtigungsregeln für hohe Dringlichkeit. Bei einem Service mit fester Dringlichkeit erscheint das spätere Ereignis nur im Alert-Log, und für einen Incident, den bereits jemand bestätigt hat, benachrichtigt PagerDuty nicht erneut. Damit Sie eine Page erhalten, sobald eine Meldung kritisch wird, nutzen Sie dynamische Benachrichtigungen und geben Sie der Regel Kritischer Schweregrad bewertet einen höheren Schweregrad als Ihren übrigen Regeln.

Wiederholte Auslöser vom Typ SLA-Verletzung werden zudem begrenzt, bevor sie PagerDuty erreichen, und zwar durch das Budget für Überschreitungsalarme Ihres Programms, standardmäßig drei Wiederholungen im Abstand von sechs Stunden.

Pages an das zuständige Team leiten

Kit sendet jede Page an einen einzigen Integration Key. Mit dem Key eines Services landet jede Page in diesem Service. Soll stattdessen das Team alarmiert werden, dem die Komponente einer Meldung gehört, fügen Sie in Kit den Integration Key einer Event Orchestration ein und überlassen der Orchestration die Wahl des Services. Weiterleitungsregeln für Orchestrations gibt es in jedem PagerDuty-Tarif.

  1. Öffnen Sie in PagerDuty Event Orchestration (unter Configuration > Events & Routing, bei manchen Konten unter AIOps) und legen Sie eine Orchestration an
  2. Öffnen Sie dort Integrations und kopieren Sie den Integration Key
  3. Fügen Sie ihn in Kit unter VDP > Einstellungen > PagerDuty als Integrationsschlüssel ein
  4. Legen Sie pro Komponente eine Service Route mit der Bedingung event.custom_details.component_id matches 'cmp_…' an. Die ID jeder Komponente kopieren Sie unter VDP > Programmeinstellungen > Komponenten. Die ID bleibt gleich, wenn Sie eine Komponente umbenennen, eine Route darauf funktioniert also weiter
  5. Bearbeiten Sie die Catch-all-Route so, dass sie nicht zugeordnete Events an Ihren Service für die Sichtung sendet

Lassen Sie die Catch-all-Route nicht aus: Standardmäßig unterdrückt PagerDuty eine Page, die zu keiner Route passt, und benachrichtigt niemanden. Pages zu neuen Meldungen kommen meist an, bevor jemand eine Komponente zuweist, und eingeschränkte Meldungen tragen nie eine. Beide erreichen deshalb nur die Catch-all-Route.

Die Weiterleitung folgt der ersten Page des Incidents: Ein Incident bleibt in dem Service, in dem er geöffnet wurde, und spätere Pages der Meldung landen ebenfalls dort. Wenn Sie die Komponente einer Meldung ändern, wird niemand alarmiert. Die nächste Page der Meldung löst den offenen Incident im bisherigen Service und öffnet einen neuen Incident für die neue Komponente. So hat eine Meldung nie zwei offene Incidents. Die Page eines Review-Agents landet im offenen Incident und verschiebt ihn nicht. Über die Weiterleitung entscheidet nur die Komponente, die Sie für die Meldung bestätigt haben, nie eine vorgeschlagene.

Feld Was Kit sendet
component Der Name der Komponente der Meldung; fehlt, wenn die Meldung keine hat oder eingeschränkt ist
group Der Name Ihres Programms
class Das Ereignis: new_report, sla_at_risk, sla_breach, critical_assessment, report_validated, escalation oder agent_escalation, wenn ein Review-Agent eine Meldung als möglicherweise kritisch markiert. Bei einer eingeschränkten Meldung immer restricted_report
custom_details.component_id Die ID der Komponente, cmp_…
custom_details.component Der Name der Komponente
custom_details.program_id Die ID Ihres Programms
custom_details.report_id Die ID der Meldung, rpt_…
custom_details.severity Der bewertete Schweregrad; fehlt bei eingeschränkten Meldungen

Die Page einer eingeschränkten Meldung nennt weder Komponente noch bewerteten Schweregrad noch Ereignis: nur die ID der Meldung, Ihr Programm und restricted_report als Ereignis.

Mit Dynamic Routing kann PagerDuty den Service auch anhand eines Event-Felds wählen, allerdings nur bei Orchestrations mit dem AIOps-Add-on. Ein Event, dessen Weiterleitungsfeld es nicht lesen kann, verwirft PagerDuty dabei. Eine Route pro Komponente ist die sicherere Einrichtung.

Rufbereitschaftsplan-Synchronisation

Wenn aktiviert, ruft Kit Ihren PagerDuty-Plan alle 5 Minuten ab und aktualisiert die Bereitschaftsperson in Kit automatisch.

  1. Wählen Sie auf der PagerDuty-Einstellungsseite einen Plan aus dem Dropdown aus
  2. Kit ordnet PagerDuty-Benutzer anhand der E-Mail-Adresse Kit-Benutzern zu
  3. Wählen Sie auf der Rufbereitschafts-Seite den Modus PagerDuty

Wenn ein PagerDuty-Benutzer nicht in Kit gefunden wird: Die vorherige Schicht bleibt aktiv und auf der Einstellungsseite wird eine Warnung angezeigt.

Manuelles Überschreiben ist im PagerDuty-Modus weiterhin möglich. Der Plan wird bei der nächsten Synchronisation fortgesetzt.

Incident-Aktualisierungen (bidirektional)

Wenn jemand einen PagerDuty-Incident bestätigt oder löst, empfängt Kit die Aktualisierung per Webhook und zeigt sie in der Meldungs-Timeline an.

PagerDuty-Aktion Auswirkung in Kit
Incident bestätigt Meldung zeigt “Bestätigt via PagerDuty”-Status
Incident gelöst Meldung zeigt “Gelöst via PagerDuty”-Status

Wichtig: Statusänderungen in PagerDuty lösen keine automatischen Übergänge der Meldung aus. Sichtungs-Entscheidungen (Validieren, Ablehnen, Lösen) bleiben manuell in Kit.

Eine geschlossene Meldung löst ihren Incident

Sobald eine Meldung die offene Pipeline verlässt (Sie markieren sie als behoben, schließen sie als informativ oder lehnen sie ab, Duplikate eingeschlossen), löst Kit ihren PagerDuty-Incident. Ein Wechsel zwischen zwei geschlossenen Status, etwa von Behoben zu Behebung verifiziert, sendet nichts an PagerDuty. Wurde der Incident gelöst, ob in Kit oder in PagerDuty, öffnet das nächste Ereignis der Meldung einen neuen Incident, etwa wenn eine geschlossene Meldung wieder geöffnet wird und erneut eine Page auslöst.

Webhook einrichten

  1. Kopieren Sie die Webhook-URL, die auf der PagerDuty-Einstellungsseite angezeigt wird
  2. Gehen Sie in PagerDuty zu Integrations > Generic Webhooks (v3)
  3. Erstellen Sie ein neues Webhook-Abonnement mit Ihrer Kit-URL
  4. Wählen Sie die Ereignisse: incident.acknowledged und incident.resolved

Fehlerbehebung

Symptom Ursache Lösung
“Verbindung fehlgeschlagen” beim Speichern Ungültiges API-Token Generieren Sie das Token in PagerDuty neu und fügen Sie es erneut ein
Benachrichtigungen erstellen keine Incidents Ereignis in den Regeln nicht aktiviert Prüfen Sie den Schalter für jeden Ereignistyp auf der Einstellungsseite
Späteres Ereignis löst keine Page aus Meldung hat bereits einen offenen Incident Suchen Sie das Ereignis in PagerDuty im Alert-Log dieses Incidents
Pages erreichen niemanden Sie passen zu keiner Route, und die Catch-all-Route unterdrückt sie Leiten Sie die Catch-all-Route der Orchestration an Ihren Service für die Sichtung
Eine Page ging noch an das bisherige Team Der Incident wurde geöffnet, bevor sich die Komponente geändert hat Die nächste Page der Meldung öffnet den Incident im Service der neuen Komponente neu
Rufbereitschaft synchronisiert nicht PD-Benutzer-E-Mail stimmt nicht mit Kit-Benutzer überein Stellen Sie sicher, dass die E-Mail des PagerDuty-Benutzers mit der Kit-Konto-E-Mail übereinstimmt
Verbindung zeigt rotes Fehler-Badge API-Token wurde widerrufen oder ist abgelaufen Verbinden Sie sich mit einem neuen Token neu; Kit pausiert alle Benachrichtigungen bei Authentifizierungsfehler

Auf einen Blick

  • PagerDuty-API-Schlüssel erstellen, der auf Ihren VDP-Service beschränkt ist
  • API-Schlüssel und Integration Key unter VDP > Einstellungen > PagerDuty einfügen
  • Mindestens eine Benachrichtigungsregel aktivieren (empfohlen: SLA-Überschreitung + kritische Bewertung)
  • (Optional) Einen PagerDuty-Plan für die Rufbereitschafts-Synchronisation auswählen
  • (Optional) Webhook in PagerDuty für bidirektionale Aktualisierungen einrichten
  • Durch Klicken auf Test auf der Einstellungsseite verifizieren

Suchbegriff eingeben...