SOAR-Webhook einrichten

Unterstützt in:

Webhooks sind eine einfache Lösung, um Benachrichtigungen aus Ihrer Organisation in die Google Security Operations SOAR-Plattform aufzunehmen.

Über Webhooks aufgenommene Benachrichtigungen werden auf der Plattform mit denselben Informationen angezeigt wie Benachrichtigungen, die über Connectors aufgenommen wurden.

Google empfiehlt, entweder einen Connector oder einen Webhook aus derselben Quelle zu verwenden, aber nicht beide, um doppelte Fälle zu vermeiden.

Webhooks eignen sich am besten für Szenarien, die eine einfache Zuordnungslogik erfordern, während Connectors für erweiterte und flexible Zuordnungen besser geeignet sind.

Webhook zum Aufnehmen von Benachrichtigungen einrichten

So richten Sie einen Webhook zum Aufnehmen von Benachrichtigungen ein:

  1. Rufen Sie Settings > Data Management > SOAR Webhooks auf.
  2. Klicken Sie auf Hinzufügen Eingehenden Webhook hinzufügen.
  3. Geben Sie einen Namen für den neuen Webhook ein und wählen Sie eine Umgebung aus.
  4. Klicken Sie auf Speichern. Nach dem Speichern wird der neue Webhook auf der Hauptseite angezeigt.
  5. Kopieren Sie die Webhook-URL und notieren Sie sie für die spätere Verwendung. Sie müssen sie auf der Quellplattform als Webhook-Ziel eingeben.

Kartendaten

Nachdem Sie ein JSON-Beispiel hochgeladen haben, können Sie im Abschnitt Datenabgleich Felder aus Ihrer JSON-Quelle den entsprechenden Feldern in Google Security Operations SOAR zuordnen. Das System verarbeitet Ihre JSON-Rohdaten und Sie verwenden die Benutzeroberfläche, um die Zuordnungen festzulegen.

  1. Klicken Sie im Bereich Datenabgleich auf JSON-Beispiel hochladen. Stellen Sie eine repräsentative Stichprobe der JSON-Nutzlast bereit, die Ihr Webhook sendet.
  2. Ordnen Sie die Google Security Operations-Felder den entsprechenden Feldern in Ihrem JSON-Beispiel zu. Wenn Sie beispielsweise das Pflichtfeld StartTime zuordnen möchten, können Sie ein Zeitstempelfeld aus Ihrer JSON-Datei auswählen, z. B. Detections.Last.Update.
  3. Verwenden Sie den Ausdruckseditor, um die Daten zu verfeinern. Sie können beispielsweise die Funktion Datumsformat verwenden, um den Zeitstempel in das erforderliche Format „Unix-Epoche in Millisekunden“ zu konvertieren. Weitere Informationen finden Sie unter Expression Builder verwenden.
  4. Klicken Sie im Ausdruckseditor auf Ausführen, um die Zuordnung zu testen und das Ergebnis zu sehen. Ein grünes Häkchen zeigt an, dass die Zuordnung erfolgreich war.
  5. Die JSON-Nutzlast Ihres Webhooks muss die erforderlichen Felder für die Fallerstellung und die Aufnahme von Benachrichtigungen enthalten. Weitere Informationen finden Sie unter Webhook-JSON-Schema.
  6. Nachdem Sie alle erforderlichen Felder zugeordnet haben, klicken Sie auf Speichern und aktivieren Sie dann den Webhook.

Zuordnungszielfelder verstehen

Wenn Sie Ihre JSON-Daten zuordnen, ordnen Sie sie standardisierten Feldern in Google Security Operations SOAR zu. Diese Felder sind in Kategorien unterteilt, damit Sie die eingehenden Daten normalisieren und strukturieren können. Die verfügbaren Felder in der Benutzeroberfläche für den Datenabgleich basieren auf der internen Systemontologie. Die Hauptkategorien sind:

  • Entitätsfelder: Verwenden Sie diese Felder für Datenpunkte, aus denen das System automatisch Entitäten extrahieren und modellieren kann, z. B. IP-Adressen, Domainnamen, Datei-Hashes und Nutzernamen. Durch die Zuordnung zu diesen Feldern wird die Benachrichtigung angereichert und die Korrelation und das Pivoting werden verbessert.
  • Allgemeine Ereignisfelder: Verwenden Sie diese für allgemeine Ereignismetadaten wie Zeitstempel (StartTime, EndTime), Ereignisbeschreibungen oder ‑nachrichten und andere gängige Ereignisattribute.
  • Technische und Gerätemetadaten: Verwenden Sie diese Felder für technische Details zur Ereignisquelle, z. B. den Anbieter und das Produkt des meldenden Geräts (DeviceVendor, DeviceProduct), den Schweregrad des Ereignisses und andere ähnliche technische Attribute.

Sehen Sie sich die verfügbaren Felder im Tool für den Datenabgleich in der Google Security Operations SOAR-Benutzeroberfläche an, um das am besten geeignete Zielfeld für die einzelnen Daten in Ihrer JSON-Nutzlast zu finden.

Webhook-JSON-Schema verstehen

Damit Ihre Benachrichtigungen von Google Security Operations SOAR korrekt aufgenommen und verarbeitet werden, muss die JSON-Nutzlast des Webhooks einer bestimmten Struktur folgen. In den folgenden Tabellen sind die wichtigsten Felder aufgeführt, die in der JSON-Nutzlast erwartet werden.

Hauptfelder für Fälle und Benachrichtigungen

Diese Felder stellen die Attribute der obersten Ebene der Benachrichtigung oder des Falls dar, die erstellt werden.

Feld Typ Empfohlenes Format Erforderlich Beschreibung Beispiel
TicketId String UUID Ja
  • Eine interne global eindeutige Kennung (GUID) für einen Fall innerhalb der SOAR-Plattform.
  • Die Anforderung, dass TicketId eindeutig sein muss, ist bedingt und hängt von DisplayId ab:
    • Wenn eine eindeutige DisplayId angegeben wird, muss die TicketId nicht eindeutig sein.
    • Wenn DisplayId nicht angegeben ist, muss TicketId eindeutig sein.
  • TicketId hat oft denselben Wert wie DisplayId.
"f7167971-f641-432f-a06f-ebca3caaa9dd"
SourceSystemName String Text Ja Der Name des externen Systems (z. B. SIEM oder ein EDR-System (Endpoint Detection and Response)), das die ursprünglichen Benachrichtigungen an SOAR gesendet hat. "Splunk"
Name String Text Ja Der Titel oder Name des Falls, der oft aus dem Typ oder der Zusammenfassung der Quellbenachrichtigung stammt. "Suspicious Login Attempt"
DeviceVendor String Text Ja Der Anbieter des Geräts oder Produkts, das die Benachrichtigung generiert hat. Dies kann auch aus den Ereignisdaten zugeordnet werden. "Palo Alto Networks"
RuleGenerator String Text Ja Der Name der Regel im Quellsystem (z. B. eine SIEM-Korrelationsregel), die die Benachrichtigung generiert hat. "Brute Force Attempt Detected"
StartTime String oder Ganzzahl Epochen-Millisekunden (UTC) oder ISO8601-String (z. B. „2026-04-09T14:30:00Z“) Ja Die Startzeit des frühesten Ereignisses im Fall. Wenn Sie eine Ganzzahl angeben, muss diese in Unix-Epoche (Millisekunden) angegeben werden. 1670000000000 oder "2026-04-09T14:30:00Z"
Environment String Text Nein Der Name der SOAR-Umgebung, zu der diese Benachrichtigung gehört. Diese muss mit einer Umgebung übereinstimmen, die in Ihren Einstellungen definiert ist. "Default Environment"
Description String Text Nein Eine kurze Beschreibung des Falls oder der Benachrichtigung. "Failed login followed by success from new IP"
DisplayId String UUID oder String Nein
  • Eine Kennung, die für Anzeigezwecke in der SOAR-Benutzeroberfläche verwendet wird.
  • Dieses Feld ist der Primärschlüssel, den das System prüft, um doppelte Benachrichtigungen zu erkennen.
  • Eine Meldung wird als Duplikat abgelehnt, wenn die DisplayId nicht eindeutig ist. Diese Eindeutigkeitsprüfung für DisplayId hat Vorrang vor TicketId.
  • DisplayId hat oft denselben Wert wie TicketId.
"f7167971-f641-432f-a06f-ebca3caaa9dd"
Reason String Text Nein Der Grund, warum die Benachrichtigung erstellt oder ausgelöst wurde. "Unusual file access patterns detected."
DeviceProduct String Text Nein Der Produktname des Anbieters, der die Benachrichtigung generiert hat. Dies kann auch aus den Ereignisdaten zugeordnet werden. "Cortex XDR"
EndTime String oder Ganzzahl Epochen-Millisekunden (UTC) oder ISO8601-String (z. B. „2026-04-09T14:30:00Z“) Nein Das Ende des letzten Ereignisses im Fall. Wenn Sie eine Ganzzahl angeben, muss diese in Unix-Epoche (Millisekunden) angegeben werden. 1670000060000 oder "2026-04-09T14:31:00Z"
Priority Ganzzahl 0–100 Nein Die Prioritätsstufe der Anfrage. Ohne Angabe wird der Standardwert 40 verwendet. (0–19: Informativ, 20–39: Niedrig, 40–59: Mittel, 60–79: Hoch, 80–100: Kritisch) 80
EventsList Array Array von JSON-Objekten Nein Ein Array, das ein oder mehrere Rohereignisobjekte enthält, wie sie von der Quelle empfangen wurden. Weitere Informationen finden Sie unter Rohe Ereignisdaten senden. [ { ... }, { ... } ]
EventProduct String Text Nein Produkt, das die Ereignisse erstellt hat. "Cortex XDR"
EventName String Text Nein Der Titel oder Name des Ereignisses, der oft aus dem Typ oder der Zusammenfassung der Quellbenachrichtigung stammt. "Suspicious Login Attempt"

Rohereignisdaten senden – das EventsList-Array

Sie sollten die JSON-Rohdaten, die die Ereignisse darstellen, so senden, wie sie vom Quellsystem im Array EventsList stammen. Dieses Objekt ist ein Element im EventsList-Array. Anschließend ordnen Sie Felder wie source_ip und timestamp über die Benutzeroberfläche für den Datenabgleich zu.

Beispiel für ein Ereignisobjekt im Array EventsList

{
  "event_id": "9a8b7c-1234-5678",
  "timestamp": "2026-07-01T07:29:50Z",
  "signature": "UserLoginFailed",
  "severity": "Medium",
  "user_name": "administrator",
  "source_ip": "192.168.1.50",
  "destination_ip": "10.0.0.10",
  "domain": "CORP",
  "status": "Failure",
  "Reason": "Wrong Password",
  "EventProduct": "Acme Firewall",
  "EventName": "Failed Login Attempt"
}

Wichtige Überlegungen und Best Practices

  • Zeitstempel: Verwenden Sie für alle StartTime- und EndTime-Felder auf der obersten Ebene Unix-Epochen-Millisekunden (als Ganzzahl). Geben Sie in den Ereignisdaten Zeitstempel so an, wie sie in der Quelle vorliegen. Sie werden in der Benutzeroberfläche für den Datenabgleich konvertiert.
  • Pflichtfelder: Alle Felder, die in der Spalte „Pflichtfeld“ mit „Ja“ gekennzeichnet sind, müssen in Ihrer JSON-Nutzlast enthalten sein.
  • EventsList-Array: Dieses Array ist entscheidend. Auch wenn die Benachrichtigung ein einzelnes Ereignis darstellt, muss sie im EventsList-Array verpackt sein.
  • Benutzeroberfläche für den Datenabgleich: Verwenden Sie das Tool für den Datenabgleich in der Benutzeroberfläche Webhook-Konfiguration, um Felder aus Ihrem Roh-JSON den entsprechenden Google Security Operations SOAR-Feldern zuzuordnen.
  • Eindeutigkeit: DisplayId muss für jede neue Benachrichtigung eindeutig sein, um eine Deduplizierung zu vermeiden. TicketId muss eindeutig sein, wenn DisplayId nicht angegeben ist.
  • Antwortstatus: Eine HTTP 200 OK-Antwort vom Webhooks-Ingest-Endpunkt bestätigt, dass die Nutzlast empfangen wurde, garantiert aber nicht, dass eine Benachrichtigung erstellt wird. Die Erstellung von Benachrichtigungen kann während der nachgelagerten Verarbeitung aufgrund der Nutzlaststruktur oder von Filterregeln fehlschlagen. Sie können den Status der nachgelagerten Verarbeitung mit der Funktion SOAR-Plattformlogs erfassen verfolgen.
  • Testen: Verwenden Sie die Tabs JSON-Beispiel hochladen und Testen auf der Seite Webhook-Konfiguration in SOAR, um die Nutzlaststruktur und die Zuordnungen zu validieren.

Webhook testen

Auf dem Tab Test können Sie die End-to-End-Funktionalität des Webhooks testen und detaillierte Fehlerbeschreibungen aufrufen.

  1. Kopieren Sie auf dem Tab Testen die Webhook-URL.
  2. Laden Sie eine JSON-Datei mit den relevanten Daten hoch.
  3. Klicken Sie auf Ausführen. Die Ergebnisse werden zusammen mit der Ausgabe angezeigt.

CrowdStrike-Plattform konfigurieren

In diesem Anwendungsfall werden die Schritte in CrowdStrike beschrieben, mit denen der Webhook Benachrichtigungen in die Google SecOps-Plattform aufnehmen kann.

  1. Rufen Sie im CrowdStrike Falcon-Dashboard den Falcon Store auf und installieren Sie das Webhooks-Add-on.
  2. Konfigurieren Sie den Webhook mit dem Namen und der Webhook-URL, die Sie von der Google SecOps-Plattform kopiert haben, und klicken Sie dann auf Speichern.
  3. Wechseln Sie zum Bereich Workflows.
  4. Klicken Sie auf Workflow erstellen.
  5. Wähle einen Auslöser aus, z. B. Neue Erkennung, und klicke auf Weiter.
  6. Wählen Sie Aktion hinzufügen aus.
  7. Wählen Sie im Bereich Aktion anpassen im Menü Aktionstyp die Option Benachrichtigungen und im Menü Aktion die Option Webhook aufrufen aus.
  8. Wählen Sie den Namen, den Sie im ersten Schritt hinzugefügt haben, und alle erforderlichen Felder aus und klicken Sie dann auf Fertig.

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten