将 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 服务器的基础网址,格式为 |
ClientID |
必填。 当 如果 |
Secret |
必填。 当 如果 |
Product Version |
必填。 要使用的 LevelBlue USM Anywhere 身份验证版本。 如需使用获取闹钟详情和列出事件操作,必须将此参数设置为 可能的值如下:
默认值为 |
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. |
操作失败。 验证指定的 |
This action is not supported for AlienVault Anywhere V1
integration. Please use V2. |
操作失败。 在 Google SecOps 中打开集成配置,将 |
脚本结果
下表列出了使用获取闹钟详情操作时脚本结果输出的值:
| 脚本结果名称 | 值 |
|---|---|
is_success |
true 或 false |
列出事件
使用列出事件操作,按账号名称、事件名称、来源资产、日期窗口或抑制状态在 LevelBlue USM Anywhere 中搜索历史安全事件,并在案例墙上显示匹配的事件。
此操作不会在 Google SecOps 实体上运行。
操作输入
列出事件操作需要以下参数:
| 参数 | 说明 |
|---|---|
Account Name |
可选。 与要搜索的安全事件关联的 LevelBlue USM Anywhere 账号名称。 |
Event Name |
可选。 要搜索的安全性事件的完整或部分名称,例如 |
Source Name |
可选。 生成安全性事件的来源资产的主机名或 IP 地址。 |
Start Time |
可选。 事件搜索范围的开始日期,格式为 |
End Time |
可选。 事件搜索范围的结束日期,格式为 |
Suppressed |
可选。 如果选中,则操作会包含或匹配在 LevelBlue USM Anywhere 中标记为已抑制的事件。 |
Events Limit |
可选。 要返回的匹配安全性事件的数量上限。 默认值为 |
操作输出
列出事件操作提供以下输出:
| 操作输出类型 | 可用性 |
|---|---|
| 案例墙附件 | 不可用 |
| 案例墙链接 | 不可用 |
| 案例墙表格 | 可用 |
| 实体丰富化表 | 不可用 |
| 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. |
操作失败。 更新 |
Unable to parse end time
END_TIME. Valid format is
DD/MM/YYYY. |
操作失败。 更新 |
This action is not supported for AlienVault Anywhere V1
integration. Please use V2. |
操作失败。 在 Google SecOps 中打开集成配置,将 |
脚本结果
下表列出了使用列出事件操作时脚本结果输出的值:
| 脚本结果名称 | 值 |
|---|---|
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 |
操作失败。 验证 |
脚本结果
下表列出了使用 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 提醒中填充设备商品属性的事件字段名称。 默认值为 |
EventClassId |
可选。 决定事件名称(子类型)的字段名称。 默认值为 |
PythonProcessTimeout |
必填。 运行当前脚本的 Python 进程的超时限制(以秒为单位)。 默认值为 |
Api Root |
必填。 LevelBlue USM Anywhere 服务器的基础网址,格式为 |
ClientID |
必填。 当 |
Secret |
必填。 当 |
Product Version |
必填。 在提取提醒期间要使用的 LevelBlue USM Anywhere 身份验证版本。 可能的值如下:
默认值为 |
Verify SSL |
必填。 如果选中此选项,则集成会在连接到 LevelBlue USM Anywhere 服务器时验证 SSL 证书。 |
Max Alerts Per Cycle |
必填。 每次连接器运行时要注入的警报数量上限。 默认值为 |
Max Days Backwards |
必填。 从首次连接器运行之前检索警报的天数。 此参数可应用于您首次启用连接器后的初始连接器迭代,或已过期连接器时间戳的后备值。 默认值为 |
Padding Period |
可选。 回溯缓冲区(以小时为单位,从 默认值为 |
Show Suppressed |
可选。 如果在启用 |
Use Suppressed Filter |
可选。 如果选中,连接器会根据
如需详细了解 LevelBlue USM Anywhere 中的警报抑制,请参阅“编排规则”页面中的抑制规则。 |
Priority |
可选。 要注入的警报优先级逗号分隔列表(例如 可能的值如下:
|
Rule Intent |
可选。 按威胁意图类别过滤提取的警报。 可能的值如下:
|
Rule Strategy |
可选。 按触发检测规则的攻击策略(例如 |
Rule Method |
可选。 按特定检测方法或规则签名(例如 |
Proxy Server Address |
可选。 要使用的代理服务器的地址。 |
Proxy Username |
可选。 用于进行身份验证的代理用户名。 |
Proxy Password |
可选。 用于进行身份验证的代理密码。 |
连接器规则
- 此连接器支持代理。