Utiliser l'agent d'ingénierie de la détection
Ce guide s'adresse aux ingénieurs en sécurité et aux analystes SOC qui souhaitent évaluer et renforcer leur stratégie de sécurité Google Security Operations contre les menaces nouvelles et existantes, à l'aide de l'agent d'ingénierie de détection basé sur l'IA dans Google SecOps.
Vous pouvez accéder à l'agent à l'aide d'outils MCP (Model Context Protocol) exploités par des clients IA compatibles (par exemple, Google Antigravity ou Claude Code). L'agent d'ingénierie de détection vous permet d'extraire des renseignements sur les menaces et de rédiger automatiquement des règles YARA-L, ce qui améliore le délai de rentabilisation de l'automatisation de la sécurité personnalisée et accélère l'atténuation des risques.
Terminologie clé
- Agent d'ingénierie de détection : assistant d'ingénierie optimisé par l'IA intégré à Google SecOps, exploité par des clients IA (par exemple, Antigravity ou Claude Code) à l'aide d'outils MCP.
- Model Context Protocol (MCP) : norme Open Source permettant de connecter des applications d'IA à des systèmes externes, utilisée dans les services Google Cloud pour connecter de manière sécurisée des agents IA et des applications d'IA à diverses sources de données et outils d'infrastructure.
- Opportunité de détection des menaces (TDO) : modèle de données formalisé conçu pour identifier, suivre et hiérarchiser les nouvelles règles de détection ou analyses potentielles.
- Événements synthétiques : journaux Unified Data Model (UDM) générés pour simuler un TDO d'entrée.
Avant de commencer
Avant de commencer, assurez-vous que les conditions préalables suivantes sont remplies :
Vérification de l'environnement : client IA
Vous devez utiliser un client d'IA (comme Antigravity ou Claude Code) capable de s'interfacer avec les outils MCP.
Rôles et autorisations nécessaires
Cette section liste les autorisations IAM (Identity and Access Management) requises et les rôles prédéfinis recommandés pour les utilisateurs humains et les comptes de service.
Rôles requis pour tous les utilisateurs principaux
Chaque compte principal appelant l'agent Detection Engineering doit disposer des rôles suivants : Utilisateur de l'outil MCP et Lecteur de l'API Chronicle. Assurez-vous qu'un administrateur système met à jour ces rôles pour tous les utilisateurs principaux.
Pour en savoir plus, consultez Configurer MCP.
Autorisations de base requises
Les autorisations suivantes sont requises pour exécuter l'agent d'ingénierie de détection :
chronicle.ade.generateThreatDetectionOpportunitychronicle.ade.generateSyntheticEventschronicle.ade.evaluateRuleCoveragechronicle.ade.generateRuleschronicle.operations.get
Autorisations requises pour la gestion des règles et l'analyseur syntaxique
Les autorisations suivantes sont requises pour gérer les règles et les analyseurs :
chronicle.rules.listchronicle.rules.getchronicle.rules.verifychronicle.rules.createchronicle.rules.updatechronicle.ruleDeployments.getchronicle.ruleDeployments.updatechronicle.parsers.listchronicle.parsers.getchronicle.logTypes.list
Autorisations d'utilisation du service de projet et du serveur MCP distant requises
Les autorisations suivantes sont requises pour appeler le serveur MCP distant et utiliser les services du projet pour les outils MCP :
mcp.tools.call(accordée par le rôleroles/mcp.toolUser)serviceusage.services.use(accordée par le rôleroles/serviceusage.serviceUsageConsumer)
Rôles prédéfinis obligatoires et recommandés
Les rôles prédéfinis suivants fournissent les autorisations nécessaires aux utilisateurs humains et aux comptes de service :
roles/chronicle.admin(ouroles/chronicle.editor)roles/mcp.toolUserroles/serviceusage.serviceUsageConsumer
Configurer le serveur MCP
Pour créer votre fichier settings.json, consultez Configurer MCP. Une fois que vous avez collecté les valeurs requises, assurez-vous que le contenu de votre fichier settings.json ressemble à ce qui suit :
{
"name": "my_extension_name",
"version": "1.0.0",
"mcpServers": {
"GoogleSecOps": {
"httpUrl": "https://us-chronicle.googleapis.com/mcp",
"authProviderType": "google_credentials",
"oauth": {
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/chronicle"
]
},
"timeout": 300000,
"headers": {
"x-goog-user-project": "my-cloud-project-name"
}
}
}
}
Configurer un fichier de contexte
Pour commencer, configurez un fichier de contexte afin de vous assurer que Gemini cible la bonne instance Google SecOps pour chaque requête.
Pour que tout reste léger, Google vous recommande de commencer par le contenu suivant dans votre fichier GEMINI.md, puis de le développer. Remplacez les valeurs d'espace réservé par les informations appropriées pour votre instance et votre environnement Google SecOps :
When using the Google SecOps MCP server, use these parameters for EVERY request: Customer ID: aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa Region: us Project ID: my-cloud-project-name
Configurer la compétence pour interagir avec les outils
Google vous recommande vivement d'utiliser la compétence detection-engineering-coverage-evaluation pour interagir avec les outils. Cette compétence empêche l'IA de résumer ou d'abréger les résultats d'outils critiques.
Cette compétence est intégrée en tant que detection-engineering-coverage-evaluation et est hébergée publiquement dans le dépôt GitHub Google Agent Skills.
Capacités clés
Cette section décrit les principales fonctionnalités d'analyse des menaces et de génération de règles fournies par l'agent Detection Engineering.
Générer des opportunités de détection des menaces
L'outil generate_threat_detection_opportunity extrait et enrichit les renseignements bruts sur les menaces provenant de sources (par exemple, des blogs de sécurité et des résultats internes) pour créer des TDO hiérarchisés à analyser. Les TDO produits à cette étape informent les étapes suivantes de l'agent d'ingénierie de détection pour évaluer la couverture des règles existantes ou générer de nouvelles règles.
- Pour utiliser l'outil
generate_threat_detection_opportunity, demandez à Gemini d'utilisercurlpour extraire le texte, ou copiez et collez le texte brut d'un rapport sur les menaces dans l'outil.
Générer des événements synthétiques
Pour générer des événements synthétiques pour un TDO, votre instance Google SecOps doit avoir ingéré des journaux bruts et un analyseur actif pour au moins l'un des types de journaux compatibles dans ce TDO.
Types de journaux compatibles
La génération d'événements synthétiques est compatible avec les huit types de journaux suivants :
| Catégorie | Fournisseur ou produit | Type de journal |
|---|---|---|
| Détection et réponse pour les points de terminaison (EDR) | CrowdStrike Falcon | CS_EDR |
| Détection et réponse pour les points de terminaison (EDR) | Microsoft Defender for Endpoint | MICROSOFT_DEFENDER_ENDPOINT |
| Détection et réponse pour les points de terminaison (EDR) | SentinelOne EDR | SENTINEL_EDR |
| Antivirus et point de terminaison | Windows Defender ATP | WINDOWS_DEFENDER_ATP |
| DNS | DNS Zscaler | ZSCALER_DNS |
| Google Cloud | Activités Google Workspace | WORKSPACE_ACTIVITY |
| Gestion de l'authentification et des accès | Okta | OKTA |
| Applications SaaS | Microsoft 365 (Office 365) | OFFICE_365 |
Évaluer la couverture
L'agent d'ingénierie de détection vérifie si les règles existantes dans votre instance Google SecOps se déclenchent sur des événements simulés ingérés via la simulation d'événements. Si des règles correspondent aux événements simulés, l'outil renvoie les identifiants des règles correspondantes et les métadonnées des résultats de couverture. Si aucune règle ne correspond, un résultat vide est renvoyé, ce qui indique un manque de couverture.
Générer des règles de test
L'agent d'ingénierie de détection codifie la logique de détection en créant des brouillons de règles YARA-L à partir d'entrées utilisateur ou de langage naturel pour combler les lacunes identifiées lors de l'évaluation de la couverture. Lorsque vous utilisez la compétence detection-engineering-coverage-evaluation, l'agent ne génère des brouillons de règles que pour les TDO qui ne correspondent à aucune règle existante, et seulement une fois l'évaluation de la couverture terminée pour tous les TDO. Cela évite les règles en double pour les menaces déjà couvertes par les règles existantes.
L'outil generate_rules n'ajoute pas automatiquement les règles de brouillon à votre instance Google SecOps. Après avoir examiné les règles de test, vous pouvez les ajouter de l'une des manières suivantes :
- Utiliser votre client d'IA : la compétence
detection-engineering-coverage-evaluationvous invite à approuver ou à rejeter chaque brouillon de règle. Pour chaque règle que vous approuvez, le client IA appelle l'outilcreate_rulesur le serveur MCP Google SecOps pour créer la règle dans votre instance. - Créer la règle manuellement : copiez le texte de la règle à partir du résultat de l'outil et créez la règle dans l'éditeur de règles.
Dépannage
Utilisez le tableau suivant pour résoudre vous-même les problèmes courants lors du processus d'évaluation :
| Problème | Description | Corriger |
|---|---|---|
| Échec de l'outil | L'outil generate_synthetic_events échoue de manière répétée. |
Vérifiez que le TDO inclut au moins l'un des types de journaux compatibles et que votre instance Google SecOps a ingéré des journaux bruts et un analyseur actif pour ce type de journal. Sinon, ignorez la génération d'événements synthétiques pour ce TDO et passez aux TDO restants. |
| Erreur de synthèse | L'IA abrège les types de journaux ou prend des raccourcis lors de l'exécution. | Assurez-vous que la compétence detection-engineering-coverage-evaluation est activement utilisée pour interagir avec le système. |
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.