收集 Trend Micro Cloud One 日志

支持:

此解析器可处理来自 Trend Micro Cloud One 的 Syslog 和 JSON 格式的日志。它可以从 LEEF 格式的消息中提取键值对,对严重程度值进行规范化,识别主体和目标实体(IP、主机名、用户),并将数据映射到 UDM 架构。如果未检测到 LEEF 格式,解析器会尝试将输入作为 JSON 进行处理,并相应地提取相关字段。

准备工作

  • 确保您拥有 Google SecOps 实例。
  • 确保您拥有对 Trend Micro Cloud One 的特权访问权限。
  • 确保您拥有 Windows 2012 SP2 或更高版本或带有 systemd 的 Linux 主机。
  • 如果通过代理运行,请确保防火墙端口处于开放状态。

获取 Bindplane 代理的 Google SecOps 凭据

如需向 Google SecOps 验证 Bindplane 代理的身份,请选择以下方法之一:

  • 新部署:使用 Chronicle API(方法 1)。
  • 旧版部署:继续使用数据注入身份验证文件(方法 2),直到数据注入 API 于 2027 年 7 月 20 日停用为止。
  1. 登录 Google Cloud 控制台,然后选择与您的 Google SecOps 实例关联的 Google Cloud 项目。
  2. 依次前往 IAM 和管理 > 服务账号。
  3. 点击创建服务账号 。
  4. 提供以下配置详细信息:
    • 服务账号名称:输入账号的名称(例如 bindplane-ingest)。
    • 服务账号说明:输入说明(例如 Bindplane agent log ingestion)。
  5. 点击创建并继续 。
  6. 在向此服务帐号授予对项目的访问权限 部分,点击选择角色 ,然后选择 Chronicle Editor 。
  7. 点击继续 ,然后点击完成 。
  8. 点击您创建的服务帐号,然后前往密钥 标签页。
  9. 依次点击添加密钥 > 创建新密钥。
  10. 选择 JSON ,然后点击创建 。密钥文件会下载到您的计算机上。
  11. 将密钥文件另存为 Bindplane 收集器目录中的 ingestion-auth.json(在 Linux 上为 /opt/observiq-otel-collector/ingestion-auth.json,在 Windows 上为 C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json),或者更新 creds_file_path 在 config.yaml 中以与您保存该文件的路径匹配。
  12. 依次前往 IAM 和管理 > 设置 ,然后复制项目编号 。您需要此编号进行导出器配置。

方法 2:下载数据注入身份验证文件(旧版)

  1. 登录 Google SecOps 控制台。
  2. 依次前往 SIEM 设置 > 收集代理。
  3. 下载数据注入身份验证文件 。
  4. 将该文件安全地保存在将安装 Bindplane 代理的系统上。

获取 Google SecOps 客户 ID

  1. 登录 Google SecOps 控制台。
  2. 依次前往 SIEM 设置 > 个人资料 。
  3. 从组织详细信息 部分复制并保存客户 ID 。

安装 Bindplane 代理

  1. 对于 Windows 安装,请运行以下脚本:msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet。
  2. 对于 Linux 安装,请运行以下脚本:sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh。
  3. 如需了解其他安装选项,请参阅此安装指南。

将 Bindplane 代理配置为注入 Syslog 并将其发送到 Google SecOps

  1. 访问装有 Bindplane 代理的机器。
  2. 按如下方式修改 config.yaml 文件:

    receivers:
      udplog:
        # Replace the below port <5514> and IP (0.0.0.0) with your specific values
        listen_address: "0.0.0.0:514"
    
    exporters:
      chronicle/chronicle_w_labels:
        protocol: https
        # Region of your instance, for example us, europe, asia-southeast1
        location: <LOCATION>
        # Project number of the Google Cloud project linked to the instance
        project: '<PROJECT_NUMBER>'
        compression: gzip
        # Adjust the path to the credentials file you saved in Step 1
        creds: '{ json file for creds }'
        # Replace <customer_id> below with your actual ID that you copied
        customer_id: <customer_id>
        endpoint: chronicle.googleapis.com
        # You can apply ingestion labels below as preferred
        ingestion_labels:
        log_type: SYSLOG
        namespace:
        raw_log_field: body
    service:
      pipelines:
        logs/source0__chronicle_w_labels-0:
          receivers:
            - udplog
          exporters:
            - chronicle/chronicle_w_labels
    
    • 根据基础架构的需要替换端口和 IP 地址。
    • 将 <LOCATION> 替换为 Google SecOps 实例的区域(例如 us、europe 或 asia-southeast1)。导出器会使用此值为 chronicle.googleapis.com 添加前缀。
    • 将 <PROJECT_NUMBER> 替换为 IAM 和管理 > 设置 中的项目编号。
    • 将 <customer_id> 替换为实际客户 ID。
    • 将 { json file for creds } 更新为服务帐号密钥文件(方法 1)的保存路径。
  3. 使用以下命令重启 Bindplane 代理以应用更改: sudo systemctl bindplane restart

旧版数据注入 API 导出器

  • 如果您使用方法 2 中的数据注入身份验证文件,请将 exporters 代码块替换为以下内容。将 creds 设置为数据注入身份验证文件的路径,如果您的实例位于美国境外,请将 malachiteingestion-pa.googleapis.com 替换为您的 区域端点(例如 europe-malachiteingestion-pa.googleapis.com)。

    exporters:
      chronicle/chronicle_w_labels:
        compression: gzip
        # Adjust the path to the credentials file you saved in Step 1
        creds: '{ json file for creds }'
        # Replace <customer_id> below with your actual ID that you copied
        customer_id: <customer_id>
        endpoint: malachiteingestion-pa.googleapis.com
        # You can apply ingestion labels below as preferred
        ingestion_labels:
        log_type: SYSLOG
        namespace:
        raw_log_field: body
    

配置来自 Trend Micro Cloud One 的 Syslog

  1. 依次前往政策 > 通用对象 > 其他 > Syslog 配置。
  2. 依次点击新建 > 新配置 > 常规
  3. 为以下参数指定值:
    • 名称:用于标识配置的唯一名称(例如 Google SecOps BindPlance server )。
    • 服务器名称:输入 Bindplane 代理的 IP 地址。
    • 服务器端口:输入 Bindplane 代理的端口(例如 514 )。
    • 传输:选择 UDP。
    • 事件格式:选择 Syslog。
    • 在事件中包含时区:保持未选中状态。
    • 设施:事件将与之关联的进程类型。
    • 代理应转发日志:选择 Syslog 服务器。
    • 点击保存 。

导出 Trend Micro Cloud One 中的系统事件

  1. 依次前往管理 > 系统设置 > 事件转发。
  2. 使用配置将系统事件转发到远程计算机 (通过 Syslog),选择在上一步中创建的配置。
  3. 点击保存 。

导出 Trend Micro Cloud One 中的安全事件

  1. 点击政策 。
  2. 点击计算机使用的政策。
  3. 依次前往设置 > 事件转发。
  4. 事件转发频率(来自代理/设备):选择发送事件的时间间隔,然后选择安全性事件的转发频率。
  5. 事件转发配置(来自代理/设备):选择 Anti-Malware Syslog Configuration ,然后选择在上一步中创建的配置。
  6. 点击保存 。

UDM 映射表

日志字段 UDM 映射 逻辑
act security_result.action 如果 act 为“deny”或“block”(不区分大小写),则为 BLOCK。如果 act 为“pass”或“allow”(不区分大小写),则为 ALLOW。如果 act 为“update”或“rename”(不区分大小写),则为 ALLOW_WITH_MODIFICATION。如果 act 为“quarantine”(不区分大小写),则为 QUARANTINE。否则,为 UNKNOWN_ACTION。
act security_result.action_details 直接映射。
cat security_result.category_details 直接映射。
cn1 target.asset_id 如果 cn1Label 为“Host ID”,则添加前缀“Host Id:”。
desc metadata.description 直接映射。
dvchost target.asset.hostname 直接映射。
dvchost target.hostname 直接映射。
log_type metadata.product_name 直接映射。
msg security_result.description 直接映射。
name security_result.summary 直接映射。
组织 target.administrative_domain 直接映射。
proto additional.fields.key 如果 proto 字段无法转换为整数,则设置为“Protocol”。
proto additional.fields.value.string_value 如果 proto 字段无法转换为整数,则直接映射。
proto network.ip_protocol 使用 parse_ip_protocol.include 逻辑进行映射,该逻辑会将协议号转换为相应的名称(例如,“6”变为“TCP”)。
product_version metadata.product_version 直接映射。
sev security_result.severity 如果 sev 为“0”“1”“2”“3”或“low”(不区分大小写),则为 LOW。如果 sev 为“4”“5”“6”或“medium”(不区分大小写),则为 MEDIUM。如果 sev 为“7”“8”或“high”(不区分大小写),则为 HIGH。如果 sev 为“9”“10”或“very high”(不区分大小写),则为 CRITICAL。
sev security_result.severity_details 直接映射。
src principal.asset.hostname 如果不是有效的 IP 地址,则直接映射。
src principal.asset.ip 如果是有效的 IP 地址,则直接映射。
src principal.hostname 如果不是有效的 IP 地址,则直接映射。
src principal.ip 如果是有效的 IP 地址,则直接映射。
TrendMicroDsTenant security_result.detection_fields.key 设置为“TrendMicroDsTenant”。
TrendMicroDsTenant security_result.detection_fields.value 直接映射。
TrendMicroDsTenantId security_result.detection_fields.key 设置为“TrendMicroDsTenantId”。
TrendMicroDsTenantId security_result.detection_fields.value 直接映射。
usrName principal.user.userid 直接映射。如果 has_principal 为 true 且 has_target 为 true,则为 NETWORK_CONNECTION。否则,如果 has_principal 为 true,则为 STATUS_UPDATE。否则,如果 has_target 为 true 且 has_principal 为 false,则为 USER_UNCATEGORIZED。否则,为 GENERIC_EVENT。如果 event_type 为 USER_UNCATEGORIZED,则设置为 AUTHTYPE_UNSPECIFIED。如果提取了主体 IP、主机名或 MAC 地址,则设置为“true”。否则,初始化为“false”。如果提取了目标 IP、主机名或 MAC 地址,则设置为“true”。否则,初始化为“false”。与顶级事件时间戳相同。设置为“Trend Micro”。

更新日志

查看此解析器的更新日志

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