Envoyer les événements à Google Security Operations (Google SecOps, SIEM)
PoisonZero envoie ses événements à Google SecOps sous forme d'événements UDM. La configuration prend environ 5 minutes. Il ne vous faut ni parser ni forwarder.
Ce qu'il vous faut
- Un forfait Enterprise.
- Une instance Google SecOps et le projet Google Cloud auquel elle appartient.
- Un compte Google Cloud autorisé à créer des rôles et à accorder des accès dans ce projet, et la ligne de commande
gcloud(Cloud Shell convient aussi). - Ni parser ni forwarder.
Étape 1 : saisir l'instance dans la console
- Ouvrez Settings > Appareils et modèle et repérez la section Google SecOps. Activez Activer l'export. Dans Mode, choisissez Chronicle API.
- Saisissez ID du projet, Région et ID de l'instance. La région est l'ID de région SecOps, par exemple
euoueurope-west3. - Cliquez sur Enregistrer. Au premier enregistrement, PoisonZero crée un compte de service pour votre tenant. Son adresse e-mail apparaît ensuite sous Compte de service.
Étape 2 : accorder l'accès
Copiez l'e-mail sous Compte de service et exécutez les deux commandes. Remplacez PROJECT_ID et SA_EMAIL. Le rôle n'autorise que 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
Aucune clé et aucun secret n'est échangé. Supprimez l'attribution pour retirer l'accès à tout moment.
Étape 3 : envoyer un événement de test
Cliquez sur Envoyer un événement de test. La console indique si Google SecOps a accepté l'événement.
Étape 4 : vérifier l'arrivée des événements
Dans Google SecOps, ouvrez la recherche UDM et lancez cette recherche. Elle affiche tous les événements PoisonZero :
metadata.vendor_name = "PoisonZero"
La console affiche l'état sous Dernier export : heure, statut HTTP, erreur et nombre d'événements. Les événements apparaissent dans SecOps en quelques minutes.
Ce qui est envoyé
Chaque détection d'exec0, poison0, leak0 et inject0 est envoyée comme événement UDM avec le fabricant PoisonZero et l'action BLOCK, QUARANTINE ou ALLOW. Le texte des commandes et le contenu des fichiers ne quittent jamais PoisonZero. Les détails figurent dans les sections ci-dessous.
Tous les événements
| Événement PoisonZero | event_type | action | category | Gravité |
|---|---|---|---|---|
exec0 bloque un appel d'outiltoolgate_denied, toolgate_rule_override_denied | Dépend de l'outil, voir ci-dessous | BLOCK | POLICY_VIOLATION | Du niveau de menace |
Vous refusez un appel d'outil sur lequel exec0 a posé la questiontoolgate_asked_denied | Dépend de l'outil, voir ci-dessous | CHALLENGE et BLOCK | POLICY_VIOLATION | Du niveau de menace |
Vous autorisez un appel d'outil sur lequel exec0 a posé la questiontoolgate_asked_allowed | Dépend de l'outil, voir ci-dessous | CHALLENGE et ALLOW | POLICY_VIOLATION | Du niveau de menace |
Une exception de règle laisse passer un appel bloquétoolgate_rule_overridden | Dépend de l'outil, voir ci-dessous | ALLOW | POLICY_VIOLATION | HIGH |
exec0 a observé un appel d'outil ou ne l'a pas vérifiétoolgate_observed, toolgate_unchecked | Dépend de l'outil, voir ci-dessous | ALLOW | POLICY_VIOLATION | Du niveau de menace |
poison0 met une modification en quarantaine ou la retientquarantine_reversible, hold_awaiting_review | SCAN_FILE | QUARANTINE | SOFTWARE_SUSPICIOUS | Du niveau de menace |
poison0 conserve une modificationdetected_kept, hold_kept_review, observed_would_hold, observed_would_quarantine | SCAN_FILE | ALLOW (hold_kept_review: CHALLENGE et ALLOW) | SOFTWARE_SUSPICIOUS | Du niveau de menace |
poison0 annule une modificationrevert, meta_attack | SCAN_FILE | BLOCK | SOFTWARE_SUSPICIOUS | Du niveau de menace |
leak0 bloque une fuiteleak0_blocked | GENERIC_EVENT | BLOCK | DATA_EXFILTRATION | Du niveau de menace |
leak0 retire le secret de la sortieleak0_redacted | GENERIC_EVENT | ALLOW_WITH_MODIFICATION | DATA_EXFILTRATION | Du niveau de menace |
leak0 avertit ou observeleak0_warned, leak0_observed | GENERIC_EVENT | ALLOW | DATA_EXFILTRATION | Du niveau de menace |
leak0 pose la questionleak0_asked | GENERIC_EVENT | CHALLENGE | DATA_EXFILTRATION | Du niveau de menace |
inject0 retient le contenu récupéréinject0_withheld | GENERIC_EVENT | BLOCK | SOCIAL_ENGINEERING | Du niveau de menace |
inject0 marque le contenu récupéréinject0_marked | GENERIC_EVENT | ALLOW_WITH_MODIFICATION | SOCIAL_ENGINEERING | Du niveau de menace |
inject0 observeinject0_observed | GENERIC_EVENT | ALLOW | SOCIAL_ENGINEERING | Du niveau de menace |
Bash, Shell et PowerShell sont PROCESS_LAUNCH, tous les autres outils GENERIC_EVENT. La gravité suit le niveau de menace. Dans les règles, utilisez metadata.product_event_type et security_result.action.
Champs et association
PoisonZero associe ses événements d'audit à UDM. Le texte des commandes, le contenu des fichiers et le texte des prompts ne font partie d'aucun événement, ils ne quittent jamais PoisonZero. Sont envoyés le nom de l'outil, l'agent, la décision, le motif, le niveau de menace, le nom de l'appareil et, pour poison0, le chemin du fichier.
Champs sur lesquels vous pouvez rechercher et filtrer :
metadata.vendor_nameetmetadata.product_name: toujours PoisonZero.metadata.product_event_type: l'action PoisonZero de la première colonne.principal.hostname: le nom de l'appareil.security_result.action,security_result.severityetsecurity_result.category.security_result.rule_name: le motif, par exemple la règle déclenchée.
Règles YARA-L d'exemple
Collez chaque règle dans l'éditeur de règles de Google SecOps. Lancez-la d'abord en test sur les derniers jours, puis activez-la.
exec0 a bloqué un appel d'outil
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 a mis une modification en quarantaine ou l'a retenue
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 a stoppé une fuite de données
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 : flux webhook (OCSF)
Si Domain Restricted Sharing bloque l'octroi d'accès à l'étape 2, PoisonZero envoie les événements au format OCSF vers un flux webhook.
- Dans SecOps, créez un flux sous Settings > Feeds : Source type Webhook, Log type OCSF. Copiez l'URL de l'endpoint et la Secret Key.
- Dans la console Google Cloud, créez une clé d'API restreinte à la Chronicle API.
- Dans la console PoisonZero, choisissez le mode Flux webhook (OCSF), saisissez URL, clé API et secret, puis envoyez un événement de test.
Les valeurs des champs peuvent différer de la voie UDM.
Dépannage
| Ce que vous voyez | Ce que vous faites |
|---|---|
HTTP 403 et Permission 'chronicle.events.import' denied | Le rôle manque ou appartient à un autre compte. Exécutez de nouveau les commandes de l'étape 2. PoisonZero réessaie seul après 5 minutes, rien n'est perdu. |
service account still propagating | Le nouveau compte de service n'est pas encore disponible partout. Attendez une minute et cliquez de nouveau sur Envoyer un événement de test. |
HTTP 404 ou un message d'instance inconnue | L'ID de projet, la région et l'ID d'instance ne vont pas ensemble. Copiez les trois valeurs depuis votre instance SecOps, sans espaces. |
SecOps not yet provisioned | L'export n'est pas encore configuré pour votre environnement. Contactez le support PoisonZero. |
| L'étape 2 est refusée parce que la politique Domain Restricted Sharing bloque l'octroi d'accès | Utilisez le flux webhook (OCSF) de la section Alternative. |
Le flux webhook signale HTTP 401 ou HTTP 403 | Vérifiez la clé API et le secret. Un secret perdu se régénère avec Generate Secret Key. |
| Le test réussit, mais rien n'apparaît dans SecOps | Les événements apparaissent en quelques minutes. Dernier export indique l'état et l'erreur. |
À lire ensuite
Export SIEM (fichiers locaux, appareils privés, configuration sans la console). CrowdStrike Falcon Next-Gen SIEM. Export OpenTelemetry. Incidents et audit.