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.generateThreatDetectionOpportunity
  • chronicle.ade.generateSyntheticEvents
  • chronicle.ade.evaluateRuleCoverage
  • chronicle.ade.generateRules
  • chronicle.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.list
  • chronicle.rules.get
  • chronicle.rules.verify
  • chronicle.rules.create
  • chronicle.rules.update
  • chronicle.ruleDeployments.get
  • chronicle.ruleDeployments.update
  • chronicle.parsers.list
  • chronicle.parsers.get
  • chronicle.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ôle roles/mcp.toolUser)
  • serviceusage.services.use (accordée par le rôle roles/serviceusage.serviceUsageConsumer)

Les rôles prédéfinis suivants fournissent les autorisations nécessaires aux utilisateurs humains et aux comptes de service :

  • roles/chronicle.admin (ou roles/chronicle.editor)
  • roles/mcp.toolUser
  • roles/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'utiliser curl pour 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-evaluation vous invite à approuver ou à rejeter chaque brouillon de règle. Pour chaque règle que vous approuvez, le client IA appelle l'outil create_rule sur 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.