收集 Trellix Endpoint Security (HX) 提醒日志
支持的平台:
Google SecOps
SIEM
本文档介绍了如何使用第三方 API 设置 Google Security Operations Feed,以收集 Trellix Endpoint Security (HX) 提醒日志。
Trellix Endpoint Security (HX) 是一种端点检测和响应平台,可在受管理的端点上检测到威胁时生成提醒,包括恶意软件检测、漏洞利用尝试、IOC 匹配和实时指标提醒。在 Google SecOps 中收集这些提醒,可集中了解端点威胁,以便进行检测、调查和响应工作流程。
准备工作
确保您满足以下前提条件:
- Google SecOps 实例
- 对 Trellix Endpoint Security (HX) 管理控制台的特权访问权限
- 已启用 API 访问权限的 Trellix Endpoint Security (HX)
- 已配置以下任一身份验证凭据(请参阅下一部分)
配置 Trellix HX API 访问权限
如需让 Google SecOps 提取提醒数据,您需要从 Trellix HX 环境获取 API 凭据。
- 以管理员身份登录终端威胁防护 (HX) Web 界面。
- 依次前往管理 > 设备设置 > 用户账号。
- 添加一个具有
api_analyst角色的新用户账号,以便与 Google SecOps 搭配使用。请勿重复使用内置的api_analyst账号。 - 复制并保存以下值:
- 用户名:本地 HX 账号用户名。
- 密码:本地 HX 账号密码。
在 Google SecOps 中配置 Feed 以注入 Trellix HX 提醒日志
- 依次前往 SIEM 设置 > Feed。
- 点击添加新 Feed。
- 在下一页上,点击配置单个 Feed。
- 在 Feed 名称字段中,输入 Feed 的名称(例如
Trellix HX Alerts)。 - 选择第三方 API 作为来源类型。
- 选择 Trellix HX 提醒作为日志类型。
- 点击下一步。
为以下输入参数指定值:
- HX 端点网址:HX 设备的基础网址(例如
https://htapdeviceproxy.md.mandiant.net/dphb/hx/e32c3284-8317-48f4-b29d-7feb3babc4fc)。 身份验证:Trellix 本地身份验证
- 用户名:输入为此集成创建的本地 HX 账号用户名。
- 密码:为用户名输入密码。
- 令牌 API 端点路径:
/hx/api/v3/token - 令牌标头:
X-FeApi-Token
资产命名空间:资产命名空间。
注入标签:要应用于此 Feed 中事件的标签。
- HX 端点网址:HX 设备的基础网址(例如
点击下一步。
在最终确定界面中查看新的 Feed 配置,然后点击提交。
设置完成后,该 Feed 会开始按时间顺序从 Trellix HX 实例检索提醒日志。
UDM 映射表
| 日志字段 | UDM 映射 | 逻辑 |
|---|---|---|
event_at |
metadata.event_timestamp |
解析为 RFC3339 |
reported_at |
metadata.event_timestamp |
解析为 RFC3339 |
__event_type |
metadata.event_type |
已映射:fileWriteEvent → FILE_MODIFICATION |
__reg_key_event_type |
metadata.event_type |
映射:0/1/5 → REGISTRY_MODIFICATION、2/4 → REGISTRY_DELETION、3 → `REGISTRY_CREA... |
__source |
metadata.event_type |
映射值(总共 9 个,例如 IOC → FILE_MODIFICATION、IOC → REGISTRY_MODIFICATION、`... |
event_type |
metadata.event_type |
映射值(总共 8 个,例如 regKeyEvent → REGISTRY_MODIFICATION、regKeyEvent → `REGIS... |
__appliance_id |
metadata.product_deployment_id |
当 __appliance_id != `` 时进行映射 |
__event_type |
metadata.product_event_type |
当 __event_type != `` 时进行映射 |
__product_log_id |
metadata.product_log_id |
当 __product_log_id != `` 时进行映射 |
__url |
metadata.url_back_to_product |
当 __url != `` 时进行映射 |
__source |
network.application_protocol |
已映射:IOC → DNS、IOC → HTTP |
event_type |
network.application_protocol |
已映射:dnsLookupEvent → DNS,urlMonitorEvent → HTTP |
__source |
network.direction |
已映射:IOC → UNKNOWN_DIRECTION |
event_type |
network.direction |
已映射:ipv4NetworkEvent → UNKNOWN_DIRECTION |
__dns_lookup_event_question |
network.dns.questions |
已合并 |
__source |
network.dns.questions |
已映射:IOC → __dns_lookup_event_question |
event_type |
network.dns.questions |
已映射:dnsLookupEvent → __dns_lookup_event_question |
event_values.__urlMethod |
network.http.method |
当 __source == IOC 时进行映射 |
event_values.__userAgent |
network.http.user_agent |
当 __source == IOC 时进行映射 |
event_values.__protocol |
network.ip_protocol |
当 __source == IOC 时进行映射 |
__agent_data |
principal |
已重命名/已映射 |
__source |
principal.ip |
已映射:IOC → event_values.__localIP |
event_type |
principal.ip |
已映射:ipv4NetworkEvent → event_values.__localIP |
event_values.__localIP |
principal.ip |
已合并 |
event_values.__localPort |
principal.port |
已重命名/已映射 |
__parent_process_path |
principal.process.file.full_path |
当 __source == IOC 时进行映射 |
__process_full_path |
principal.process.file.full_path |
当 __source == IOC 时进行映射 |
__event_type |
principal.process.file.names |
已映射:fileWriteEvent → __process |
__process |
principal.process.file.names |
已合并 |
__source |
principal.process.file.names |
已映射:IOC → __process、IOC → event_values.__parentProcess |
event_type |
principal.process.file.names |
映射的值(总共 6 个,例如 regKeyEvent → __process、ipv4NetworkEvent → __process 等) |
event_values.__parentProcess |
principal.process.file.names |
已合并 |
__parent_process_path |
principal.process.parent_process.file.full_path |
当 __source == IOC 时进行映射 |
__event_type |
principal.process.parent_process.file.names |
已映射:fileWriteEvent → __parent_process |
__parent_process |
principal.process.parent_process.file.names |
已合并 |
__source |
principal.process.parent_process.file.names |
已映射:IOC → __parent_process |
__parent_pid |
principal.process.parent_process.pid |
当 __source == IOC 时进行映射 |
__parent_pid |
principal.process.pid |
当 __source == IOC 时进行映射 |
__pid |
principal.process.pid |
当 __source == IOC 时进行映射 |
__domain_user |
principal.user.userid |
当 __source == IOC 时进行映射 |
__security_result |
security_result |
已合并 |
__source |
security_result |
已映射:IOC → __security_result |
__agent_data |
target |
已重命名/已映射 |
event_values.__fullPath |
target.file.full_path |
当 __source == IOC 时进行映射 |
event_values.__md5 |
target.file.md5 |
当 __source == IOC 时进行映射 |
__event_type |
target.file.names |
已映射:fileWriteEvent → event_values.__fileName |
__source |
target.file.names |
已映射:IOC → event_values.__fileName |
event_values.__fileName |
target.file.names |
已合并 |
event_values.__size |
target.file.size |
已重命名/已映射 |
event_values.__hostname |
target.hostname |
当 __source == IOC 时进行映射 |
__source |
target.ip |
已映射:IOC → event_values.__remoteIP、IOC → event_values.__remoteIpAddress |
event_type |
target.ip |
已映射:ipv4NetworkEvent → event_values.__remoteIP、urlMonitorEvent → `eventvalues._... |
event_values.__remoteIP |
target.ip |
已合并 |
event_values.__remoteIpAddress |
target.ip |
已合并 |
__event_type |
target.labels |
映射的值(共 9 个,例如 fileWriteEvent → __file_write_event_label_writes、`fileWrit... |
__file_write_event_label_closed |
target.labels |
已合并 |
__file_write_event_label_data_at_lowest_offset |
target.labels |
已合并 |
__file_write_event_label_event_reason |
target.labels |
已合并 |
__file_write_event_label_lowest_file_offset_seen |
target.labels |
已合并 |
__file_write_event_label_num_bytes_seen_written |
target.labels |
已合并 |
__file_write_event_label_open_duration |
target.labels |
已合并 |
__file_write_event_label_open_time |
target.labels |
已合并 |
__file_write_event_label_text_at_lowest_offset |
target.labels |
已合并 |
__file_write_event_label_writes |
target.labels |
已合并 |
__image_load_event_value_device_path_label |
target.labels |
已合并 |
__reg_key_event_type_label |
target.labels |
已合并 |
__reg_key_event_value_basesf_label |
target.labels |
已合并 |
__source |
target.labels |
映射的值(共 13 个,例如 IOC → __file_write_event_label_writes、IOC → `__file_wri... |
__url_monitor_event_headers |
target.labels |
已合并 |
event_type |
target.labels |
已映射:regKeyEvent → __reg_key_event_value_basesf_label、regKeyEvent → `__reg_key_eve... |
event_values.__urlMethod |
target.network.http.method |
当 __source == IOC 时进行映射 |
event_values.__userAgent |
target.network.http.user_agent |
当 __source == IOC 时进行映射 |
event_values.__remotePort |
target.port |
已重命名/已映射 |
event_values.__processCmdLine |
target.process.command_line |
当 __source == IOC 时进行映射 |
__process_full_path |
target.process.file.full_path |
当 __source == IOC 时进行映射 |
event_values.__fullPath |
target.process.file.full_path |
当 __source == IOC 时进行映射 |
event_values.__md5 |
target.process.file.md5 |
当 __source == IOC 时进行映射 |
__process |
target.process.file.names |
已合并 |
__source |
target.process.file.names |
已映射:IOC → __process、IOC → event_values.__fileName |
event_type |
target.process.file.names |
已映射:processEvent → __process,imageLoadEvent → event_values.__fileName |
event_values.__fileName |
target.process.file.names |
已合并 |
__parent_process_path |
target.process.parent_process.file.full_path |
当 __source == IOC 时进行映射 |
__source |
target.process.parent_process.file.names |
已映射:IOC → event_values.__parentProcess |
event_type |
target.process.parent_process.file.names |
已映射:processEvent → event_values.__parentProcess |
event_values.__parentProcess |
target.process.parent_process.file.names |
已合并 |
__parent_pid |
target.process.parent_process.pid |
当 __source == IOC 时进行映射 |
__pid |
target.process.pid |
当 __source == IOC 时进行映射 |
__agent_id |
target.process.product_specific_process_id |
当 __source == IOC 时进行映射 |
__pid |
target.process.product_specific_process_id |
当 __source == IOC 时进行映射 |
event_values.__startTime |
target.process.product_specific_process_id |
当 __source == IOC 时进行映射 |
event_values.__path |
target.registry.registry_key |
当 __source == IOC 时进行映射 |
event_values.__text |
target.registry.registry_value_data |
当 __source == IOC 时进行映射 |
event_values.__value |
target.registry.registry_value_data |
当 __source == IOC 时进行映射 |
event_values.__valueName |
target.registry.registry_value_name |
当 __source == IOC 时进行映射 |
__reg_value_type |
target.registry.registry_value_type |
当 __source == IOC 时进行映射 |
event_values.__requestUrl |
target.url |
当 __source == IOC 时进行映射 |
更新日志
需要更多帮助?获得社区成员和 Google SecOps 专业人士的解答。