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.generateThreatDetectionOpportunitychronicle.ade.generateSyntheticEventschronicle.ade.evaluateRuleCoveragechronicle.ade.generateRuleschronicle.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.listchronicle.rules.getchronicle.rules.verifychronicle.rules.createchronicle.rules.updatechronicle.ruleDeployments.getchronicle.ruleDeployments.updatechronicle.parsers.listchronicle.parsers.getchronicle.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 rolroles/mcp.toolUser)serviceusage.services.use(otorgado por el rolroles/serviceusage.serviceUsageConsumer)
Roles predefinidos obligatorios y recomendados
Los siguientes roles predefinidos proporcionan los permisos necesarios para los usuarios humanos y las cuentas de servicio:
roles/chronicle.admin(oroles/chronicle.editor)roles/mcp.toolUserroles/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 usecurlpara 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-evaluationte solicita que apruebes o rechaces cada regla de prueba. Para cada regla que apruebes, el cliente de IA llama a la herramientacreate_ruleen 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.