Ereignisse an Google Security Operations (Google SecOps, SIEM) senden
PoisonZero sendet seine Ereignisse als UDM-Ereignisse an Google SecOps. Die Einrichtung dauert etwa 5 Minuten. Sie brauchen weder einen Parser noch einen Forwarder.
Was Sie brauchen
- Einen Enterprise-Tarif.
- Eine Google-SecOps-Instanz und das Google-Cloud-Projekt, zu dem sie gehört.
- Ein Google-Cloud-Konto, das in diesem Projekt Rollen anlegen und Zugriff vergeben darf, sowie die Kommandozeile
gcloud(Cloud Shell genügt). - Keinen Parser und keinen Forwarder.
Schritt 1: Instanz in der Konsole eintragen
- Öffnen Sie Settings > Geräte & Modell und suchen Sie den Abschnitt Google SecOps. Schalten Sie Export aktivieren ein. Wählen Sie als Weg Chronicle API.
- Tragen Sie Projekt-ID, Region und Instanz-ID ein. Die Region ist die SecOps-Regions-ID, zum Beispiel
euodereurope-west3. - Klicken Sie auf Speichern. Beim ersten Speichern legt PoisonZero ein Dienstkonto für Ihren Mandanten an. Dessen E-Mail-Adresse steht danach unter Service-Account.
Schritt 2: Zugriff erteilen
Kopieren Sie die E-Mail-Adresse unter Service-Account und führen Sie die beiden Befehle aus. Ersetzen Sie PROJECT_ID und SA_EMAIL. Die Rolle erlaubt nur chronicle.events.import.
gcloud iam roles create poisonzeroSecopsImport --project=PROJECT_ID --title="PoisonZero SecOps import" --permissions=chronicle.events.import gcloud projects add-iam-policy-binding PROJECT_ID --member=serviceAccount:SA_EMAIL --role=projects/PROJECT_ID/roles/poisonzeroSecopsImport
Es wird kein Schlüssel und kein Geheimnis übergeben. Entfernen Sie die Zuweisung, um den Zugriff jederzeit zu entziehen.
Schritt 3: Testereignis senden
Klicken Sie auf Testereignis senden. Die Konsole zeigt, ob Google SecOps das Ereignis angenommen hat.
Schritt 4: Prüfen, ob Ereignisse ankommen
Öffnen Sie in Google SecOps die UDM-Suche und führen Sie diese Suche aus. Sie zeigt alle PoisonZero-Ereignisse:
metadata.vendor_name = "PoisonZero"
Die Konsole zeigt den Status unter Letzter Export: Zeit, HTTP-Status, Fehler und Anzahl der Ereignisse. Ereignisse erscheinen in SecOps innerhalb weniger Minuten.
Was gesendet wird
Jeder Treffer von exec0, poison0, leak0 und inject0 wird als UDM-Ereignis mit dem Hersteller PoisonZero gesendet, mit der Aktion BLOCK, QUARANTINE oder ALLOW. Befehlstext und Dateiinhalt verlassen PoisonZero nie. Die Details stehen in den Abschnitten unten.
Alle Ereignisse
| PoisonZero-Ereignis | event_type | action | category | Schwere |
|---|---|---|---|---|
exec0 blockiert einen Werkzeugaufruftoolgate_denied, toolgate_rule_override_denied | Hängt vom Werkzeug ab, siehe unten | BLOCK | POLICY_VIOLATION | Aus der Bedrohungsstufe |
Sie lehnen einen Werkzeugaufruf ab, nach dem exec0 gefragt hattoolgate_asked_denied | Hängt vom Werkzeug ab, siehe unten | CHALLENGE und BLOCK | POLICY_VIOLATION | Aus der Bedrohungsstufe |
Sie erlauben einen Werkzeugaufruf, nach dem exec0 gefragt hattoolgate_asked_allowed | Hängt vom Werkzeug ab, siehe unten | CHALLENGE und ALLOW | POLICY_VIOLATION | Aus der Bedrohungsstufe |
Eine Regel-Ausnahme lässt einen blockierten Aufruf durchtoolgate_rule_overridden | Hängt vom Werkzeug ab, siehe unten | ALLOW | POLICY_VIOLATION | HIGH |
exec0 hat einen Werkzeugaufruf beobachtet oder nicht geprüfttoolgate_observed, toolgate_unchecked | Hängt vom Werkzeug ab, siehe unten | ALLOW | POLICY_VIOLATION | Aus der Bedrohungsstufe |
poison0 nimmt eine Änderung in Quarantäne oder hält sie anquarantine_reversible, hold_awaiting_review | SCAN_FILE | QUARANTINE | SOFTWARE_SUSPICIOUS | Aus der Bedrohungsstufe |
poison0 behält eine Änderung beidetected_kept, hold_kept_review, observed_would_hold, observed_would_quarantine | SCAN_FILE | ALLOW (hold_kept_review: CHALLENGE und ALLOW) | SOFTWARE_SUSPICIOUS | Aus der Bedrohungsstufe |
poison0 setzt eine Änderung zurückrevert, meta_attack | SCAN_FILE | BLOCK | SOFTWARE_SUSPICIOUS | Aus der Bedrohungsstufe |
leak0 blockiert einen Abflussleak0_blocked | GENERIC_EVENT | BLOCK | DATA_EXFILTRATION | Aus der Bedrohungsstufe |
leak0 entfernt das Geheimnis aus der Ausgabeleak0_redacted | GENERIC_EVENT | ALLOW_WITH_MODIFICATION | DATA_EXFILTRATION | Aus der Bedrohungsstufe |
leak0 warnt oder beobachtetleak0_warned, leak0_observed | GENERIC_EVENT | ALLOW | DATA_EXFILTRATION | Aus der Bedrohungsstufe |
leak0 fragt nachleak0_asked | GENERIC_EVENT | CHALLENGE | DATA_EXFILTRATION | Aus der Bedrohungsstufe |
inject0 hält abgerufene Inhalte zurückinject0_withheld | GENERIC_EVENT | BLOCK | SOCIAL_ENGINEERING | Aus der Bedrohungsstufe |
inject0 markiert abgerufene Inhalteinject0_marked | GENERIC_EVENT | ALLOW_WITH_MODIFICATION | SOCIAL_ENGINEERING | Aus der Bedrohungsstufe |
inject0 beobachtetinject0_observed | GENERIC_EVENT | ALLOW | SOCIAL_ENGINEERING | Aus der Bedrohungsstufe |
Bash, Shell und PowerShell sind PROCESS_LAUNCH, alle anderen Werkzeuge GENERIC_EVENT. Die Schwere folgt der Bedrohungsstufe. Nutzen Sie in Regeln metadata.product_event_type und security_result.action.
Felder und Zuordnung
PoisonZero bildet seine Audit-Ereignisse auf UDM ab. Befehlstext, Dateiinhalt und Prompt-Text sind nie Teil eines Ereignisses, sie verlassen PoisonZero nicht. Gesendet werden der Werkzeugname, der Agent, die Entscheidung, der Grund, die Bedrohungsstufe, der Name des Geräts und bei poison0 der Pfad der Datei.
Felder, nach denen Sie suchen und filtern können:
metadata.vendor_nameundmetadata.product_name: immer PoisonZero.metadata.product_event_type: die PoisonZero-Aktion aus der ersten Spalte.principal.hostname: der Name des Geräts.security_result.action,security_result.severityundsecurity_result.category.security_result.rule_name: der Grund, zum Beispiel die ausgelöste Regel.
YARA-L-Beispielregeln
Fügen Sie jede Regel in den Regeleditor von Google SecOps ein. Lassen Sie sie zuerst als Test über die letzten Tage laufen und aktivieren Sie sie danach.
exec0 hat einen Werkzeugaufruf blockiert
rule poisonzero_exec0_block {
meta:
author = "PoisonZero"
description = "exec0 blocked a tool call of an AI agent"
severity = "HIGH"
events:
$e.metadata.vendor_name = "PoisonZero"
$e.metadata.product_event_type = /^toolgate_(asked_|rule_override_)?denied$/
$e.security_result.action = "BLOCK"
condition:
$e
}poison0 hat eine Änderung in Quarantäne genommen oder angehalten
rule poisonzero_poison0_quarantine {
meta:
author = "PoisonZero"
description = "poison0 quarantined or held a dangerous change to an agent file"
severity = "HIGH"
events:
$e.metadata.vendor_name = "PoisonZero"
$e.metadata.product_event_type = /^(quarantine_reversible|hold_awaiting_review)$/
$e.security_result.action = "QUARANTINE"
condition:
$e
}leak0 hat einen Datenabfluss gestoppt
rule poisonzero_leak0_exfiltration {
meta:
author = "PoisonZero"
description = "leak0 stopped a secret from leaving a device"
severity = "HIGH"
events:
$e.metadata.vendor_name = "PoisonZero"
$e.metadata.product_event_type = "leak0_blocked"
$e.security_result.category = "DATA_EXFILTRATION"
$e.security_result.action = "BLOCK"
condition:
$e
}Alternative: Webhook-Feed (OCSF)
Wenn Domain Restricted Sharing die Freigabe in Schritt 2 blockiert, sendet PoisonZero die Ereignisse im OCSF-Format an einen Webhook-Feed.
- Legen Sie in SecOps unter Settings > Feeds einen Feed an: Source type Webhook, Log type OCSF. Kopieren Sie Endpoint-URL und Secret Key.
- Legen Sie in der Google Cloud Console einen API-Schlüssel an, beschränkt auf die Chronicle API.
- Wählen Sie in der PoisonZero-Konsole den Weg Webhook-Feed (OCSF), tragen Sie URL, API-Key und Secret ein und senden Sie ein Testereignis.
Feldwerte können vom UDM-Weg abweichen.
Fehlerbehebung
| Was Sie sehen | Was Sie tun |
|---|---|
HTTP 403 und Permission 'chronicle.events.import' denied | Die Rolle fehlt oder gehört zu einem anderen Konto. Führen Sie die Befehle aus Schritt 2 erneut aus. PoisonZero versucht es nach 5 Minuten selbst erneut, es geht nichts verloren. |
service account still propagating | Das neue Dienstkonto ist noch nicht überall verfügbar. Warten Sie eine Minute und klicken Sie erneut auf Testereignis senden. |
HTTP 404 oder ein Hinweis auf eine unbekannte Instanz | Projekt-ID, Region und Instanz-ID passen nicht zusammen. Kopieren Sie die drei Werte aus Ihrer SecOps-Instanz, ohne Leerzeichen. |
SecOps not yet provisioned | Der Export ist für Ihre Umgebung noch nicht eingerichtet. Wenden Sie sich an den PoisonZero-Support. |
| Schritt 2 wird abgelehnt, weil die Richtlinie Domain Restricted Sharing die Freigabe blockiert | Nutzen Sie den Webhook-Feed (OCSF) aus dem Abschnitt Alternative. |
Der Webhook-Feed meldet HTTP 401 oder HTTP 403 | Prüfen Sie API-Key und Secret. Ein verlorenes Secret erzeugen Sie mit Generate Secret Key neu. |
| Der Test klappt, aber in SecOps erscheint nichts | Ereignisse erscheinen innerhalb weniger Minuten. Status und Fehler zeigt Letzter Export. |
Weiterlesen
SIEM-Export (lokale Dateien, private Geräte, Einrichtung ohne Konsole). CrowdStrike Falcon Next-Gen SIEM. OpenTelemetry-Export. Vorfälle und Audit.