收集 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),直到 Ingestion API 于 2027 年 7 月 20 日停用。
方法 1:为 Chronicle API 创建服务账号(推荐)
- 登录 Google Cloud 控制台,然后选择与您的 Google SecOps 实例关联的 Google Cloud 项目。
- 依次前往 IAM 和管理 > 服务账号。
- 点击创建服务账号。
- 提供以下配置详细信息:
- 服务账号名称:输入账号的名称(例如
bindplane-ingest)。 - 服务账号说明:输入说明(例如
Bindplane agent log ingestion)。
- 服务账号名称:输入账号的名称(例如
- 点击创建并继续。
- 在向此服务账号授予对项目的访问权限部分,点击选择角色,然后选择 Chronicle Editor。
- 点击继续,然后点击完成。
- 点击您创建的服务账号,然后前往密钥标签页。
- 依次点击添加密钥 > 创建新密钥。
- 选择 JSON,然后点击创建。密钥文件会下载到您的计算机上。
- 将密钥文件另存为 Bindplane 收集器目录(Linux 上的
/opt/observiq-otel-collector/ingestion-auth.json或 Windows 上的C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json)中的ingestion-auth.json,或更新config.yaml中的creds_file_path以匹配您保存它的路径。 - 前往 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 服务器)。
- 服务器名称:输入 Bindplane 代理的 IP 地址。
- 服务器端口:输入 Bindplane 代理的端口(例如 514)。
- 传输:选择 UDP。
- Event Format(事件格式):选择 Syslog。
- 在事件中包含时区:保持未选中状态。
- Facility:与事件关联的进程类型。
- 代理应转发日志:选择 Syslog 服务器。
- 点击保存。
在 Trend Micro Cloud One 中导出系统事件
- 依次前往管理 > 系统设置 > 事件转发。
- 将系统事件转发到远程计算机(通过 Syslog),使用配置,选择在上一步中创建的配置。
- 点击保存。
在 Trend Micro Cloud One 中导出安全性事件
- 前往政策。
- 点击这些计算机使用的政策。
- 前往设置 > 事件转发。
- Event Forwarding Frequency (from the Agent/Appliance)(事件转发频率 [来自代理/设备]):选择 Period between sending of events(事件发送间隔时间),然后选择安全性事件的转发频率。
- Event Forwarding Configuration (from the Agent/Appliance)(事件转发配置 [来自代理/设备]):选择 Anti-Malware Syslog Configuration(反恶意软件 Syslog 配置),然后选择在上一步中创建的配置。
- 点击保存。
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 |
直接映射。 |
| 猫 | security_result.category_details |
直接映射。 |
| cn1 | target.asset_id |
如果 cn1Label 为“Host ID”,则前缀为“Host Id:”。 |
| 降序 | 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 专业人士的解答。