收集 Trellix Endpoint Security (HX) 提醒日志

支持的平台:

本文档介绍了如何通过使用第三方 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 凭据。

  1. 以管理员身份登录终端威胁防护 (HX) Web 界面。
  2. 依次前往管理 > 设备设置 > 用户账号。
  3. 添加一个具有 api_analyst 角色的新用户账号,以便与 Google SecOps 搭配使用。请勿重复使用内置的 api_analyst 账号。
  4. 复制并保存以下值:
    • 用户名:本地 HX 账号的用户名。
    • 密码:本地 HX 账号密码。

在 Google SecOps 中配置 Feed 以注入 Trellix HX 提醒日志

  1. 前往 SIEM 设置 > Feed。
  2. 点击添加新 Feed。
  3. 在下一页上,点击配置单个 Feed。
  4. 在 Feed 名称字段中,输入 Feed 的名称(例如 Trellix HX Alerts)。
  5. 选择第三方 API 作为来源类型。
  6. 选择 Trellix HX 提醒作为日志类型。
  7. 点击下一步。
  8. 为以下输入参数指定值:

    • HX 端点网址:HX 设备的基础网址(例如 https://xxxxxxxx-hx-webui-1.hex03.apps.xdr.trellix.com)。
    • 身份验证:Trellix 本地身份验证

      • 用户名:输入为此集成创建的本地 HX 账号用户名。
      • 密码:输入相应用户名的密码。
      • 令牌 API 端点路径:/hx/api/v3/token
      • 令牌标头:X-FeApi-Token
    • 资源命名空间:资源命名空间。

    • 注入标签:要应用于此 Feed 中事件的标签。

  9. 点击下一步。

  10. 在最终确定界面中查看新的 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 专业人士的解答。