将 LevelBlue USM Anywhere 与 Google SecOps 集成

本文档介绍了如何将 LevelBlue USM Anywhere 与 Google Security Operations 集成。

使用场景

LevelBlue USM Anywhere 集成使用 Google SecOps 功能来支持以下用例:

  • 自动安全警报分类:将 LevelBlue USM Anywhere 中具有优先级的安全警报及其相关事件提取到 Google SecOps 案例中,同时过滤掉已抑制或低优先级的检测结果。

  • 快速调查警报背景信息:直接在 Case Wall 上检索特定 LevelBlue USM Anywhere 警报的完整元数据(包括优先级分数、来源和目标资产、地理背景信息以及抑制状态)。

  • 有针对性的历史安全性事件搜寻:在自动或手动调查期间,按账号名称、来源资产、事件名称和日期窗口查询历史安全性事件,以确定可疑活动的范围。

准备工作

在 Google SecOps 中配置 LevelBlue USM Anywhere 集成之前,请验证您的环境是否满足以下要求:

  • 网络连接:确保 Google SecOps(或为专用网络或本地网络部署的远程代理)可以通过 TCP 端口 443 上的 HTTPS 访问 LevelBlue USM Anywhere 云实例。

  • 身份验证凭证和版本选择:确认您的环境使用的 LevelBlue USM Anywhere 身份验证版本。版本 V2(推荐)使用 OAuth 2.0 客户端 ID 和密钥,并且需要运行获取闹钟详情和列出活动操作。旧版 V1 使用标准用户名和密码,仅支持连接性验证和旧版警报提取。

  • 最小权限用户权限:配置一个专用的 LevelBlue USM Anywhere 服务账号,并为其授予工作流中使用的操作和连接器所需的最低权限,详见下表:

    组件 所需的 LevelBlue USM Anywhere 权限
    Get Alarm Details 分析师或自定义只读角色,有权生成 OAuth 2.0 凭证并查看警报记录和关联事件。
    List Events 分析师或自定义只读角色,具有生成 OAuth 2.0 凭证和搜索历史安全事件记录的权限。
    Ping 有效的用户账号凭证,能够对 LevelBlue USM Anywhere 中的基本环境状态进行身份验证和读取。
    AlienVault USM Anywhere Connector 分析师或自定义只读角色,有权查询安全警报、警报元数据和相关事件详细信息。

如需详细了解如何配置角色和生成 OAuth 2.0 客户端凭证,请参阅官方 LevelBlue USM Anywhere 文档和获取 OAuth 令牌 API 参考文档。

集成参数

LevelBlue USM Anywhere 集成需要以下参数:

参数 说明
Api Root

必填。

LevelBlue USM Anywhere 服务器的基础网址,格式为 https://SUBDOMAIN.alienvault.cloud。

ClientID

必填。

当 Product Version 设置为 V2 时,与 LevelBlue USM Anywhere 服务账号关联的 OAuth 2.0 客户端 ID。

如果 Product Version 设置为 V1,请改为在此字段中提供 LevelBlue USM Anywhere 账号用户名。

Secret

必填。

当 Product Version 设置为 V2 时,与 LevelBlue USM Anywhere 服务账号关联的 OAuth 2.0 客户端密钥。

如果 Product Version 设置为 V1,请改为在此字段中提供 LevelBlue USM Anywhere 账号密码。

Product Version

必填。

要使用的 LevelBlue USM Anywhere 身份验证版本。

如需使用获取闹钟详情和列出事件操作,必须将此参数设置为 V2。

可能的值如下:

  • V1
  • V2

默认值为 V2。

Use SSL

必填。

如果选中此选项,则集成会在连接到 LevelBlue USM Anywhere 服务器时验证 SSL 证书。

默认处于启用状态。

如需了解如何在 Google SecOps 中配置集成,请参阅配置集成。

如有需要,您可以在后续阶段进行更改。配置集成实例后,您可以在 playbook 中使用该实例。如需详细了解如何配置和支持多个实例,请参阅支持多个实例。

操作

如需详细了解操作,请参阅在工作桌上响应待处理的操作和在案例中运行手动操作。

获取警报详情

使用获取警报详情操作可检索特定 LevelBlue USM Anywhere 警报的全面元数据(包括优先级、规则意图、攻击策略、方法、来源和目标详情以及抑制状态),并将其显示在案例墙上。

此操作不会在 Google SecOps 实体上运行。

操作输入

获取闹钟详情操作需要以下参数:

参数 说明
Alarm ID

必填。

要调查的 LevelBlue USM Anywhere 警报的唯一标识符。

在由 AlienVault USM Anywhere 连接器触发的 playbook 中,您可以将提醒工单标识符直接映射到此参数。

操作输出

获取警报详情操作会提供以下输出:

操作输出类型 可用性
案例墙附件 不可用
案例墙链接 不可用
案例墙表格 可用
实体丰富化表 不可用
JSON 结果 可用
输出消息 可用
脚本结果 可用
案例墙表格

获取警报详情操作会在案例墙上提供以下表格:

  • 表名称:Alarm <var class="prettyprint readonly">ALARM_ID</var> Details
  • 列:
    • ID
    • 优先级
    • 优先级标签
    • 发生时间
    • 收到时间
    • 规则意图
    • 规则策略
    • 规则方法
    • 来源名称
    • 来源组织
    • 来源国家/地区
    • 目的地名称
    • 目标组织
    • 目的地国家/地区
    • 是否被抑制
JSON 结果

以下示例展示了使用获取闹钟详情操作时收到的 JSON 结果输出:

{
  "uuid": "5e2ee325-7a04-b082-0842-d06a14552f59",
  "status": "open",
  "priority": 36,
  "priority_label": "medium",
  "muted": false,
  "suppressed": false,
  "timestamp_occured": 1580131109000,
  "timestamp_received": 1580131109248,
  "rule_intent": "Environmental Awareness",
  "rule_strategy": "Windows Event Created",
  "rule_method": "Windows Audit Log Cleared",
  "source_name": "192.0.2.10",
  "source_username": "example_user",
  "destination_name": "198.51.100.20",
  "sensor_uuid": "2931521a-39f9-4e0e-88f2-4a2b34610e9a",
  "events_count": 1,
  "has_alarm": true
}
输出消息

获取闹钟详情操作会提供以下输出消息:

输出消息 消息说明
Successfully returned details about alarm ALARM_ID.

操作成功。

Failed to get alarm details. Error is ERROR_REASON.

操作失败。

验证指定的 Alarm ID 是否与 LevelBlue USM Anywhere 中的现有警报匹配,并检查您的 OAuth 2.0 凭证是否具有对警报的读取权限。

This action is not supported for AlienVault Anywhere V1 integration. Please use V2.

操作失败。

在 Google SecOps 中打开集成配置,将 Product Version 更改为 V2,并提供有效的 OAuth 2.0 ClientID 和 Secret 凭证。

脚本结果

下表列出了使用获取闹钟详情操作时脚本结果输出的值:

脚本结果名称 值
is_success true 或 false

列出事件

使用列出事件操作,按账号名称、事件名称、来源资产、日期窗口或抑制状态在 LevelBlue USM Anywhere 中搜索历史安全事件,并在案例墙上显示匹配的事件。

此操作不会在 Google SecOps 实体上运行。

操作输入

列出事件操作需要以下参数:

参数 说明
Account Name

可选。

与要搜索的安全事件关联的 LevelBlue USM Anywhere 账号名称。

Event Name

可选。

要搜索的安全性事件的完整或部分名称,例如 Kerberos service ticket was requested。

Source Name

可选。

生成安全性事件的来源资产的主机名或 IP 地址。

Start Time

可选。

事件搜索范围的开始日期,格式为 DD/MM/YYYY。

End Time

可选。

事件搜索范围的结束日期,格式为 DD/MM/YYYY。

Suppressed

可选。

如果选中,则操作会包含或匹配在 LevelBlue USM Anywhere 中标记为已抑制的事件。

Events Limit

可选。

要返回的匹配安全性事件的数量上限。

默认值为 100。

操作输出

列出事件操作提供以下输出:

操作输出类型 可用性
案例墙附件 不可用
案例墙链接 不可用
案例墙表格 可用
实体丰富化表 不可用
JSON 结果 可用
输出消息 可用
脚本结果 可用
案例墙表格

列出事件操作会在案例墙上提供下表:

  • 表名称:Alien Vault Anywhere Events
  • 列:
    • ID
    • 发生时间
    • 收到时间
    • 子类别
    • 访问权限控制结果
    • 事件严重程度
    • 源端口
    • 来源名称
    • 目标端口
    • 目的地名称
    • 有闹钟
JSON 结果

以下示例展示了使用列出事件操作时收到的 JSON 结果输出:

[
  {
    "access_control_outcome": "OK",
    "destination_canonical": "93f4b513-5390-4a8e-be97-949956761775",
    "destination_name": "EC2AMAZ-44A6GL4",
    "destination_port": "49707",
    "destination_username": "EC2AMAZ-44A6GL4$",
    "event_category": "Access & Authentication",
    "event_name": "Kerberos service ticket was requested",
    "event_severity": "INFO",
    "event_subcategory": "Authentication",
    "has_alarm": false,
    "id": "e489d3b0-bb09-8696-e235-23da207dc9b1",
    "log": "{\"winlogbeat\":{\"record_number\":\"2369959\",\"event_id\":4769}}",
    "packet_type": "log",
    "plugin": "AlienVault NIDS",
    "plugin_device": "AlienVault Sensor",
    "plugin_device_type": "Intrusion Detection",
    "plugin_rule": "4769 - A Kerberos service ticket was requested.",
    "plugin_version": "-",
    "rep_device_address": "192.0.2.15",
    "rep_device_canonical": "93f4b513-5390-4a8e-be97-949956761775",
    "rep_device_hostname": "EC2AMAZ-44A6GL4",
    "rep_device_rule_id": "4769",
    "sensor_uuid": "2931521a-39f9-4e0e-88f2-4a2b34610e9a",
    "source_canonical": "93f4b513-5390-4a8e-be97-949956761775",
    "source_name": "EC2AMAZ-44A6GL4",
    "source_port": "49707",
    "source_process": "C:\\Windows\\System32\\lsass.exe",
    "source_userid": "S-1-5-18",
    "source_username": "example_user",
    "suppressed": false,
    "tag_names": [],
    "timestamp_occured": 1579772348000,
    "timestamp_received": 1579772350000,
    "used_hint": false,
    "was_fuzzied": false,
    "links": {
      "self": {
        "href": "https://example.alienvault.cloud/api/2.0/events/e489d3b0-bb09-8696-e235-23da207dc9b1"
      }
    }
  }
]
输出消息

列出事件操作提供以下输出消息:

输出消息 消息说明
Successfully returned EVENTS_COUNT AlienVault Anywhere events

操作成功。

Failed to list Alien Vault Anywhere events! Error is ERROR_REASON

操作失败。

验证 LevelBlue USM Anywhere 服务器是否可访问,检查 OAuth 2.0 凭证是否有效,并确认过滤条件值与有效的账号或来源名称匹配。

Unable to parse start time START_TIME. Valid format is DD/MM/YYYY.

操作失败。

更新 Start Time 参数,使日期首先显示,后跟两位数月份和四位数年份(例如 22/04/2026)。

Unable to parse end time END_TIME. Valid format is DD/MM/YYYY.

操作失败。

更新 End Time 参数,使日期首先显示,后跟两位数月份和四位数年份(例如 29/04/2026)。

This action is not supported for AlienVault Anywhere V1 integration. Please use V2.

操作失败。

在 Google SecOps 中打开集成配置,将 Product Version 更改为 V2,然后配置有效的 OAuth 2.0 凭证。

脚本结果

下表列出了使用列出事件操作时脚本结果输出的值:

脚本结果名称 值
is_success true 或 false

Ping

使用 Ping 操作测试连接性,并验证您配置的凭据是否可以向 LevelBlue USM Anywhere 服务器进行身份验证。

此操作不会在 Google SecOps 实体上运行。

操作输入

无。

操作输出

Ping 操作提供以下输出:

操作输出类型 可用性
案例墙附件 不可用
案例墙链接 不可用
案例墙表格 不可用
实体丰富化表 不可用
JSON 结果 不可用
输出消息 可用
脚本结果 可用
输出消息

Ping 操作会提供以下输出消息:

输出消息 消息说明
Connected successfully.

操作成功。

Failed to connect to the AlienVaultAnywhere! Error is ERROR_REASON

操作失败。

验证 API Root 网址是否准确,检查是否允许 TCP 端口 443 上的出站 HTTPS 流量,并确认 ClientID 和 Secret 值有效。

脚本结果

下表列出了使用 Ping 操作时脚本结果输出的值:

脚本结果名称 值
success true 或 false

连接器

如需详细了解如何在 Google SecOps 中配置连接器,请参阅注入数据(连接器)。

AlienVault USM Anywhere 连接器

使用 AlienVault USM Anywhere Connector 连接器将 LevelBlue USM Anywhere 中的安全警报及其相关事件注入 Google SecOps 提醒和案例中。

如需详细了解警报轮询端点和过滤条件参数,请参阅获取一页警报 API 参考文档。

连接器输入

AlienVault USM Anywhere Connector 连接器需要以下参数:

参数 说明
DeviceProductField

必填。

用于在 Google SecOps 提醒中填充设备商品属性的事件字段名称。

默认值为 device_product。

EventClassId

可选。

决定事件名称(子类型)的字段名称。

默认值为 message_plugin。

PythonProcessTimeout

必填。

运行当前脚本的 Python 进程的超时限制(以秒为单位)。

默认值为 60。

Api Root

必填。

LevelBlue USM Anywhere 服务器的基础网址,格式为 https://SUBDOMAIN.alienvault.cloud。

ClientID

必填。

当 Product Version 设置为 V2 时,LevelBlue USM Anywhere 服务账号的 OAuth 2.0 客户端 ID;或者当 Product Version 设置为 V1 时,您的账号用户名。

Secret

必填。

当 Product Version 设置为 V2 时,LevelBlue USM Anywhere 服务账号的 OAuth 2.0 客户端密钥;或者当 Product Version 设置为 V1 时,您的账号密码。

Product Version

必填。

在提取提醒期间要使用的 LevelBlue USM Anywhere 身份验证版本。

可能的值如下:

  • V1
  • V2

默认值为 V2。

Verify SSL

必填。

如果选中此选项,则集成会在连接到 LevelBlue USM Anywhere 服务器时验证 SSL 证书。

Max Alerts Per Cycle

必填。

每次连接器运行时要注入的警报数量上限。

默认值为 10。

Max Days Backwards

必填。

从首次连接器运行之前检索警报的天数。

此参数可应用于您首次启用连接器后的初始连接器迭代,或已过期连接器时间戳的后备值。

默认值为 1。

Padding Period

可选。

回溯缓冲区(以小时为单位,从 0 到 12),在查询新警报时从当前时间中减去。如果传感器向 LevelBlue USM Anywhere 传送日志时出现延迟,请配置此设置。超出 0 到 12 范围的值会重置为 0。

默认值为 0。

Show Suppressed

可选。

如果在启用 Use Suppressed Filter 的情况下选择此选项,连接器将仅提取被抑制的警报。如果在 Use Suppressed Filter 处于启用状态时未选择此选项,则连接器仅提取未被抑制的警报。

Use Suppressed Filter

可选。

如果选中,连接器会根据 Show Suppressed 设置过滤警报:

  • 提取所有警报(已抑制和未抑制):清除 Use Suppressed Filter。
  • 仅提取未被抑制的提醒:选择 Use Suppressed Filter 并清除 Show Suppressed。
  • 仅提取被抑制的警报:同时选择 Use Suppressed Filter 和 Show Suppressed。

如需详细了解 LevelBlue USM Anywhere 中的警报抑制,请参阅“编排规则”页面中的抑制规则。

Priority

可选。

要注入的警报优先级逗号分隔列表(例如 high,medium)。如需注入所有优先级的警报,请将此字段留空。

可能的值如下:

  • high
  • medium
  • low
Rule Intent

可选。

按威胁意图类别过滤提取的警报。

可能的值如下:

  • System Compromise
  • Exploitation & Installation
  • Delivery & Attack
  • Reconnaissance & Probing
  • Environmental Awareness
Rule Strategy

可选。

按触发检测规则的攻击策略(例如 Client-Side Attack - Known Vulnerability)过滤提取的警报。

Rule Method

可选。

按特定检测方法或规则签名(例如 Windows Audit Log Cleared)过滤提取的警报。

Proxy Server Address

可选。

要使用的代理服务器的地址。

Proxy Username

可选。

用于进行身份验证的代理用户名。

Proxy Password

可选。

用于进行身份验证的代理密码。

连接器规则

  • 此连接器支持代理。

需要更多帮助?获得社区成员和 Google SecOps 专业人士的解答。