使用事件模拟进行检测覆盖率评估
本指南适用于希望使用事件模拟以编程方式将真实威胁序列传送到实时注入流水线的检测工程和 SOC 团队。事件模拟是直接嵌入在 Google Security Operations 中的威胁模拟和检测覆盖率评估框架。作为检测工程智能体 (DEA) 架构的基础功能,事件模拟可验证从遥测注入和标准化到多事件关联和提醒的检测生命周期,同时保留运维 SOC 工作流。
通过将 Google SecOps MCP 工具与 AI 辅助(例如 Gemini 或 Claude Code)相结合,事件模拟可实现检测工程生命周期的自动化:提取原始威胁报告、将威胁策略结构化为可操作的威胁检测机会 (TDO)、合成真实的统一数据模型 (UDM) 遥测数据、评估现有 YARA-L 2.0 规则在单事件、多事件和复合规则中的覆盖范围,以及起草新的检测规则以弥补已识别的安全漏洞。
主要应用场景
事件模拟和 Detection Engineering Agent (DEA) 支持以下核心工作流:
- 实时流水线注入和标准化测试:通过实时注入流水线、上下文丰富模块和实体图,以编程方式直接流式传输合成的统一数据模型 (UDM) 遥测数据,从而实现全面的端到端检测就绪状态。
- 持续威胁覆盖和回归验证:针对特定的攻击者战术、技术和程序 (TTP) 评估托管和自定义 YARA-L 2.0 规则,在生产部署之前跨规则集建立自动化单元测试和持续回归测试。
- 合成遥测数据生成:生成符合架构的 UDM 事件,模拟复杂的攻击链(例如 Web 应用漏洞利用、凭据访问或横向移动),以在实际生产环境中测试规则。
主要优势和价值主张
- 主动安全状况和威胁验证:在实际事件发生之前,针对新披露的漏洞和威胁行为者行为测试 YARA-L 2.0 规则。
- 直接合成和提取保证:直接从威胁情报文本中合成架构有效的 UDM 事件,这些事件会流经实时 Google SecOps 提取流水线 (
ImportEvents),以进行完整的规范化、字段对齐和上下文丰富。 - 隔离遥测和生产安全:事件模拟生成的合成事件会使用模拟元数据(
SIMULATION注入标签)进行标记,并导致检测结果标记为INCLUDES_SIMULATION_DATA。系统会自动从生产用例、Playbook、风险分析 (RBA) 流和提醒分类信息中心中排除来自模拟数据的检测结果。
了解事件模拟概念和架构
事件模拟和检测工程代理 (DEA) 框架的以下核心组件对于部署至关重要:
- 威胁检测机会 (TDO):一种形式化的数据模型,充当单元测试,用于识别、确定优先级并分类从威胁情报报告或自然语言描述中提取的特定攻击者 TTP。TDO 标识符遵循严格的格式要求(例如
t01、t02,与正则表达式^[a-zA-Z]\d{2}$匹配)。 - 合成 UDM 事件:机器生成的日志事件,严格按照 Google SecOps 统一数据模型 (UDM) 架构进行格式化。这些事件会模拟使用
ImportEvents测试检测规则逻辑所需的特定攻击者操作。 - 模拟标签和提醒标记:合成事件带有注入标签 (
metadata.ingestion_labels["SIMULATION"])。在Collectionproto 中,由模拟数据产生的检测结果会在tags下标记为INCLUDES_SIMULATION_DATA。检测元数据 proto 字段包括simulated_event_count(促成检测的模拟事件总数)和simulated_event_names(促成事件中的SIMULATION标签值集)。 - 数据公开范围和搜索抑制:默认情况下,标准 Google SecOps UDM 搜索会抑制带有模拟标签的事件。搜索查询和界面视图可以使用
simulated_data_visibility配置参数或用户偏好设置切换开关,明确包含模拟数据。 - 长时间运行的操作 (LRO):一种异步后端执行机制 (
evaluate_rule_coverage_long_running),可编排按需规则执行批处理,而不会遇到 API HTTP 超时。
准备工作
事件模拟与 Detection Engineering Agent 工具包共享底层环境前提条件、IAM 权限和服务器设置。在开始之前,请确认满足以下前提条件:
- IAM 角色:需要 Chronicle API Viewer、Chronicle API Editor 和 MCP Tool User 角色。
- MCP 服务器和技能设置:如需了解有关配置
settings.jsonMCP 服务器载荷、设置工作区上下文 (Gemini.md) 以及启用检测工程技能的分步指导,请参阅使用检测工程代理评估威胁覆盖范围和使用 Google SecOps MCP 服务器。
如何注入合成遥测数据
合成遥测数据会通过 MCP 代理工具包或直接调用 Chronicle API 注入到 Google SecOps 中:
- MCP 子代理调用:使用目标威胁检测机会 (TDO) ID 和行为规范调用
generate_synthetic_events工具。 - Chronicle API 端点:使用
ImportEventsREST API 端点 (POST /v1alpha/projects/{project}/locations/{location}/instances/{instance}/events:import) 以编程方式流式传输合成 UDM 事件。 - 模拟标签:直接调用
ImportEventsAPI 时,调用方必须在请求载荷中手动添加metadata.ingestion_labels,其中包含键"SIMULATION"和唯一的模拟或测试运行标识符作为值(例如"key": "SIMULATION", "value": "TEST123"或"t01")。API 不会自动填充模拟标签。
UDM 提取调用示例
发送以下 HTTP 请求,以使用 ImportEvents 端点注入合成 PROCESS_LAUNCH 事件:
POST https://REGION-chronicle.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID/events:import
替换以下内容:
REGION:区域级服务端点前缀,例如us或europePROJECT_ID:您的 Google Cloud 项目 IDLOCATION:Google SecOps 实例预配到的区域,例如usINSTANCE_ID:您的 Google SecOps 客户实例 ID
添加以下 JSON 请求正文:
{
"inline_source": {
"events": [
{
"udm": {
"metadata": {
"event_type": "PROCESS_LAUNCH",
"event_timestamp": "2026-08-05T20:00:00Z",
"ingestion_labels": [
{
"key": "SIMULATION",
"value": "TEST123"
}
]
},
"principal": {
"hostname": "victim-machine",
"user": {
"userid": "victim_user"
}
},
"target": {
"process": {
"command_line": "powershell.exe -ExecutionPolicy Bypass -File dump.ps1"
}
}
}
}
]
}
}
对于 PROCESS_LAUNCH 事件,UDM 架构验证要求 principal 或 target 块中至少有一个机器标识符,例如 hostname、ip、mac 或 asset_id。省略机器标识符会导致 ImportEvents 返回 400 INVALID_ARGUMENT 错误。
事件模拟会使用 ImportEvents 直接注入合成 UDM 事件,以评估 UDM 规范化、情境丰富和规则检测。在检测工程代理 (DEA) 工具中生成合成事件期间,系统会测试原始日志解析。
为合成测试数据配置用户偏好设置
如需在 Google SecOps 中通过界面、API 或 MCP 工具查看合成测试事件和模拟提醒,请根据您的界面配置公开范围:
Google SecOps 控制台
如需在 SIEM 搜索页或界面控制台中查看合成事件,请执行以下操作:
- 在 Google SecOps 控制台中,点击导航栏中的个人资料头像,然后选择用户偏好设置。
- 前往数据公开范围。
- 将显示合成测试数据设置为开启。
- 点击保存。
Chronicle API
对于程序化 API 查询,在使用 Chronicle API 查询 UDM 搜索、规则或检测端点时,请提供 simulated_data_visibility = "SIMULATED_DATA_INCLUDED":
{
"query": "metadata.event_type = \"USER_LOGIN\"",
"simulated_data_visibility": "SIMULATED_DATA_INCLUDED"
}
支持的 simulated_data_visibility 参数枚举值:
SIMULATED_DATA_EXCLUDED(默认):禁止显示带有模拟标签的事件和提醒。SIMULATED_DATA_INCLUDED:在查询结果中同时返回商品数据和合成测试数据。
Google SecOps MCP 服务器
使用 MCP 客户端(例如 Gemini CLI 或 AntiGravity)与 Google SecOps 交互时,请在工作区上下文文件(Gemini.md 或 settings.json)中配置租户级模拟可见性:
使用 GoogleSecOps MCP 服务器时,请为所有 UDM 搜索、规则评估和检测查询工具设置 simulated_data_visibility = "SIMULATED_DATA_INCLUDED"。
了解下游系统隔离
为确保在整个 Google SecOps 中妥善处理测试数据,事件模拟会为下游组件强制执行清晰的隔离边界:
| 系统或功能 | 合成数据处理 | 隔离机制 |
|---|---|---|
| 检测和提醒存储区 | 隔离并标记 | 在 Collection proto 中,由模拟遥测产生的检测结果会在 tags 下标记为 INCLUDES_SIMULATION_DATA,并包含检测元数据 proto 字段 simulated_event_count 和 simulated_event_names。除非请求 simulated_data_visibility = "SIMULATED_DATA_INCLUDED",否则不会在标准检测读取和列表 API 中显示。 |
| UDM 搜索和信息中心 | 默认情况下隐藏 | 除非指定了 simulated_data_visibility = "SIMULATED_DATA_INCLUDED",否则会被过滤掉。 |
| 案例和突发事件分类 | 已排除 | 带有模拟标记的检测结果不会自动创建案例。 |
| Playbook 和 SOAR 自动化 | 已排除 | 自动 SOAR playbook 不会针对模拟提醒触发。 |
| 风险分析 (RBA) | 已排除 | 流式风险评分汇总流水线会丢弃带有模拟标签的事件。 |
| 威胁搜寻智能体 (THA) | 已排除 | 威胁搜寻数据集查询会自动抑制带有模拟标签的遥测数据。 |
智能体套件和工具功能
事件模拟利用了 Google SecOps MCP 服务器公开的子代理工具功能。如需详细了解可用的子代理工具(包括 generate_threat_detection_opportunity、generate_synthetic_events、evaluate_rule_coverage_long_running、get_operation、generate_rules 和 create_rule)、关键输入和输出架构,请参阅使用检测工程代理评估威胁覆盖范围。
了解检测工程生命周期和工作流
端到端事件模拟检测工程工作流遵循结构化的多阶段生命周期:
- 情报处理和遥测数据提取:将原始威胁情报文本传递给
generate_threat_detection_opportunity,以提取结构化 TDO(例如t01、t02),应用预检时间戳偏移,并调用generate_synthetic_events,通过实时 Google SecOps 提取流水线 (ImportEvents) 流式传输带有SIMULATION标签的 UDM 日志。 - 异步覆盖率评估:执行
evaluate_rule_coverage_long_running以评估 YARA-L 2.0 规则在合成遥测数据中的覆盖率,轮询get_operation直至完成,以检索规则匹配矩阵。 - 差距修复和规则生命周期管理:针对任何未涵盖的 TDO 调用
generate_rules,以生成经过验证的 YARA-L 2.0 规则草稿,并使用create_rule将经过审核的规则部署到生产环境。
如需详细了解检测生命周期各个阶段的工具调用载荷和完整代码示例,请参阅使用检测工程代理评估威胁覆盖范围。
问题排查
本部分包含一些常见的问题排查问题及解答。
问:为什么合成 UDM 事件没有出现在标准 UDM 搜索中?
根据设计,标准 Google SecOps UDM 搜索会抑制带有 SIMULATION 提取标签的事件,以维护 SOC 运营秩序。如需在 UDM 搜索或界面控制台中查看合成事件,请确保在“用户偏好设置”中启用显示合成测试数据,或在查询请求中设置 simulated_data_visibility = "SIMULATED_DATA_INCLUDED"。
问:如何防止模拟数据中的检测结果向 SOC 分析师发出提醒?
当规则针对合成事件触发时,后端编译器会使用 INCLUDES_SIMULATION_DATA 标记生成的检测结果。默认情况下,带有此标记的检测结果会从生产环境中的案例、Playbook、风险分析 (RBA) 和提醒分类信息中心内排除。
问:为什么 evaluate_rule_coverage_long_running 针对我的合成事件返回了 0 个匹配项?
验证您的合成事件时间戳是否在 1 小时滚动执行窗口 ([StartTime - 1 hour, StartTime]) 内。确保您的 TDO ID 符合所需的正则表达式(^[a-zA-Z]\d{2}$,例如 t01)。
问:原子指标(IP 地址、域名、文件哈希)与行为规则应如何处理?
使用 Google SecOps IOC 匹配或数据表管理原子指标,而不是直接将静态 IP 地址或哈希值硬编码到 YARA-L 2.0 检测规则中。将 YARA-L 2.0 用于行为模式和 TTP 关联。
问:TDO 覆盖率评估调用的批次大小上限是多少?
为优化性能并遵守 API Gateway 参数,每次 evaluate_rule_coverage_long_running 调用最多只能包含 3 个 TDO 或 40 个合成事件。