Usa el agente de ingeniería de detección

Esta guía está dirigida a ingenieros de seguridad y analistas de SOC que desean evaluar y fortalecer su postura de seguridad de Google Security Operations contra amenazas nuevas y existentes con el agente de ingeniería de detección potenciado por IA en Google SecOps.

Puedes acceder al agente con las herramientas del Protocolo de contexto del modelo (MCP) que operan los clientes de IA compatibles (por ejemplo, Google Antigravity o Claude Code). Con el agente de ingeniería de detección, puedes extraer inteligencia contra amenazas y redactar automáticamente reglas de YARA-L, lo que mejora el tiempo de obtención de valor para la automatización de la seguridad personalizada y acelera la mitigación de riesgos.

Terminología clave

  • Agente de ingeniería de detección: Es un asistente de ingeniería potenciado por IA incorporado en Google SecOps, operado por clientes de IA (por ejemplo, Antigravity o Claude Code) con herramientas de MCP.
  • Protocolo de contexto del modelo (MCP): Es un estándar de código abierto para conectar aplicaciones de IA a sistemas externos, que se usa en los servicios de Google Cloud para conectar de forma segura agentes y aplicaciones de IA a varias fuentes de datos y herramientas de infraestructura.
  • Oportunidad de detección de amenazas (TDO): Es un modelo de datos formalizado diseñado para identificar, hacer un seguimiento y priorizar posibles reglas de detección o estadísticas nuevas.
  • Eventos sintéticos: Registros del modelo de datos unificado (UDM) generados para simular un TDO de entrada.

Antes de comenzar

Antes de comenzar, confirma que se cumplan los siguientes requisitos previos:

Verificación del entorno: cliente de IA

Debes operar un cliente de IA (como Antigravity o Claude Code) que pueda interactuar con las herramientas de MCP.

Roles y permisos requeridos

En esta sección, se enumeran los permisos de Identity and Access Management (IAM) necesarios y los roles predefinidos recomendados para los usuarios humanos y las cuentas de servicio.

Roles obligatorios para todos los usuarios principales

Cada principal que llame al agente de ingeniería de detección debe tener los siguientes roles: Usuario de la herramienta de MCP y Visualizador de la API de Chronicle. Asegúrate de que un administrador del sistema actualice estos roles para todos los usuarios principales.

Para obtener más información, consulta Configura MCP.

Permisos principales obligatorios

Se requieren los siguientes permisos para ejecutar el agente de ingeniería de detecciones:

  • chronicle.ade.generateThreatDetectionOpportunity
  • chronicle.ade.generateSyntheticEvents
  • chronicle.ade.evaluateRuleCoverage
  • chronicle.ade.generateRules
  • chronicle.operations.get

Permisos obligatorios para la administración de reglas y el analizador

Se requieren los siguientes permisos para administrar reglas y analizadores:

  • 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

Permisos de uso del servicio del proyecto y del servidor de MCP remoto requeridos

Se requieren los siguientes permisos para llamar al servidor de MCP remoto y usar los servicios del proyecto para las herramientas de MCP:

  • mcp.tools.call (otorgado por el rol roles/mcp.toolUser)
  • serviceusage.services.use (otorgado por el rol roles/serviceusage.serviceUsageConsumer)

Los siguientes roles predefinidos proporcionan los permisos necesarios para los usuarios humanos y las cuentas de servicio:

  • roles/chronicle.admin (o roles/chronicle.editor)
  • roles/mcp.toolUser
  • roles/serviceusage.serviceUsageConsumer

Configura el servidor de MCP

Para crear tu archivo settings.json, consulta Configura MCP. Después de recopilar los valores requeridos, asegúrate de que el contenido de tu archivo settings.json se vea de la siguiente manera:

{
  "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"
      }
    }
  }
}

Configura un archivo de contexto

Para comenzar, configura un archivo de contexto para asegurarte de que Gemini se oriente a la instancia correcta de Google SecOps para cada solicitud.

Para que todo sea liviano, Google recomienda comenzar con el siguiente contenido en tu archivo GEMINI.md y, luego, compilar a partir de allí. Reemplaza los valores de marcador de posición por la información correcta para tu instancia y entorno de 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

Configura la habilidad para interactuar con las herramientas

Google recomienda usar la habilidad detection-engineering-coverage-evaluation para interactuar con las herramientas. Esta habilidad evita que la IA resuma o abrevie los resultados de herramientas críticas.

Esta habilidad está integrada como detection-engineering-coverage-evaluation y se aloja de forma pública en el repositorio de GitHub de Google Agent Skills.

Funciones clave

En esta sección, se describen las capacidades clave para el análisis de amenazas y la generación de reglas que proporciona el agente de ingeniería de detección.

Genera oportunidades de detección de amenazas

La herramienta generate_threat_detection_opportunity extrae y enriquece la inteligencia contra amenazas sin procesar de fuentes (por ejemplo, blogs de seguridad y hallazgos internos) para crear TDO priorizados para el análisis. Los TDO producidos en este paso informan los pasos posteriores del agente de ingeniería de detección para evaluar la cobertura de las reglas existentes o generar reglas nuevas.

  • Para usar la herramienta generate_threat_detection_opportunity, indícale a Gemini que use curl para extraer el texto o copia y pega texto sin procesar de un informe de amenazas en la herramienta.

Genera eventos sintéticos

Para generar eventos sintéticos para un TDO, tu instancia de Google SecOps debe haber transferido registros sin procesar y un analizador activo para al menos uno de los tipos de registros admitidos en ese TDO.

Tipos de registros admitidos

La generación de eventos sintéticos admite los siguientes ocho tipos de registros:

Categoría Proveedor o producto Tipo de registro
Detección y respuesta de extremos (EDR) CrowdStrike Falcon CS_EDR
Detección y respuesta de extremos (EDR) Microsoft Defender para endpoints MICROSOFT_DEFENDER_ENDPOINT
Detección y respuesta de extremos (EDR) EDR de SentinelOne SENTINEL_EDR
Antivirus y extremos Windows Defender ATP WINDOWS_DEFENDER_ATP
DNS Zscaler DNS ZSCALER_DNS
Google Cloud Actividades de Google Workspace WORKSPACE_ACTIVITY
Administración de identidades y accesos Okta OKTA
Aplicaciones de SaaS Microsoft 365 (Office 365) OFFICE_365

Evalúa la cobertura

El agente de ingeniería de detección verifica si las reglas existentes en tu instancia de Google SecOps se activan en eventos simulados transferidos a través de la simulación de eventos. Si alguna regla coincide con los eventos simulados, la herramienta devuelve los identificadores de la regla coincidente y los metadatos del resultado de la cobertura. Si no hay reglas que coincidan, se devuelve un resultado vacío, lo que indica una brecha de cobertura.

Genera reglas de prueba

El agente de ingeniería de detección codifica la lógica de detección creando borradores de reglas de YARA-L a partir de la entrada del usuario o el lenguaje natural para abordar las brechas identificadas durante la evaluación de la cobertura. Cuando usas la habilidad de detection-engineering-coverage-evaluation, el agente genera reglas de prueba solo para los TDO que no coinciden con ninguna regla existente y solo después de que finaliza la evaluación de cobertura para todos los TDO. Esto evita que se creen reglas duplicadas para amenazas que ya están cubiertas por las reglas existentes.

La herramienta generate_rules no agrega automáticamente las reglas de borrador a tu instancia de Google SecOps. Después de revisar las reglas de prueba, puedes agregarlas de una de las siguientes maneras:

  • Usa tu cliente de IA: La habilidad de detection-engineering-coverage-evaluation te solicita que apruebes o rechaces cada regla de prueba. Para cada regla que apruebes, el cliente de IA llama a la herramienta create_rule en el servidor de MCP de Google SecOps para crear la regla en tu instancia.
  • Crea la regla de forma manual: Copia el texto de la regla del resultado de la herramienta y crea la regla en el Editor de reglas.

Soluciona problemas

Usa la siguiente tabla para solucionar problemas habituales durante el proceso de evaluación:

Problema Descripción Corregir
Falla de la herramienta La herramienta generate_synthetic_events falla de forma reiterada. Verifica que el TDO incluya al menos uno de los tipos de registros admitidos y que tu instancia de Google SecOps haya transferido registros sin procesar y un analizador activo para ese tipo de registro. De lo contrario, omite la generación de eventos sintéticos para ese TDO y continúa con los TDO restantes.
Error de resumen La IA abrevia los tipos de registros o toma atajos durante la ejecución. Asegúrate de que la habilidad detection-engineering-coverage-evaluation se esté usando activamente para interactuar con el sistema.

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.