收集 Trend Micro Cloud One 日志
支持:
Google SecOps
SIEM
此解析器可处理来自 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:为 Chronicle API 创建服务帐号(推荐)
- 登录 Google Cloud 控制台,然后选择与您的 Google SecOps 实例关联的 Google Cloud 项目。
- 依次前往 IAM 和管理 > 服务账号。
- 点击创建服务账号 。
- 提供以下配置详细信息:
- 服务账号名称:输入账号的名称(例如
bindplane-ingest)。 - 服务账号说明:输入说明(例如
Bindplane agent log ingestion)。
- 服务账号名称:输入账号的名称(例如
- 点击创建并继续 。
- 在向此服务帐号授予对项目的访问权限 部分,点击选择角色 ,然后选择 Chronicle Editor 。
- 点击继续 ,然后点击完成 。
- 点击您创建的服务帐号,然后前往密钥 标签页。
- 依次点击添加密钥 > 创建新密钥。
- 选择 JSON ,然后点击创建 。密钥文件会下载到您的计算机上。
- 将密钥文件另存为 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中以与您保存该文件的路径匹配。 - 依次前往 IAM 和管理 > 设置 ,然后复制项目编号 。您需要此编号进行导出器配置。
方法 2:下载数据注入身份验证文件(旧版)
- 登录 Google SecOps 控制台。
- 依次前往 SIEM 设置 > 收集代理。
- 下载数据注入身份验证文件 。
- 将该文件安全地保存在将安装 Bindplane 代理的系统上。
获取 Google SecOps 客户 ID
- 登录 Google SecOps 控制台。
- 依次前往 SIEM 设置 > 个人资料 。
- 从组织详细信息 部分复制并保存客户 ID 。
安装 Bindplane 代理
- 对于 Windows 安装,请运行以下脚本:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet。 - 对于 Linux 安装,请运行以下脚本:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh。 - 如需了解其他安装选项,请参阅此安装指南。
将 Bindplane 代理配置为注入 Syslog 并将其发送到 Google SecOps
- 访问装有 Bindplane 代理的机器。
按如下方式修改
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)的保存路径。
使用以下命令重启 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
- 依次前往政策 > 通用对象 > 其他 > Syslog 配置。
- 依次点击新建 > 新配置 > 常规
- 为以下参数指定值:
- 名称:用于标识配置的唯一名称(例如 Google SecOps BindPlance server )。
- 服务器名称:输入 Bindplane 代理的 IP 地址。
- 服务器端口:输入 Bindplane 代理的端口(例如 514 )。
- 传输:选择 UDP。
- 事件格式:选择 Syslog。
- 在事件中包含时区:保持未选中状态。
- 设施:事件将与之关联的进程类型。
- 代理应转发日志:选择 Syslog 服务器。
- 点击保存 。
导出 Trend Micro Cloud One 中的系统事件
- 依次前往管理 > 系统设置 > 事件转发。
- 使用配置将系统事件转发到远程计算机 (通过 Syslog),选择在上一步中创建的配置。
- 点击保存 。
导出 Trend Micro Cloud One 中的安全事件
- 点击政策 。
- 点击计算机使用的政策。
- 依次前往设置 > 事件转发。
- 事件转发频率(来自代理/设备):选择发送事件的时间间隔,然后选择安全性事件的转发频率。
- 事件转发配置(来自代理/设备):选择 Anti-Malware Syslog Configuration ,然后选择在上一步中创建的配置。
- 点击保存 。
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”。 |