收集 Symantec Web Isolation 日志
支持的语言:
Google SecOps
SIEM
本文档介绍了如何使用 Bindplane 将 Symantec Web Isolation 日志注入到 Google Security Operations。解析器可处理来自 Symantec Web Isolation 的两种主要消息类型:数据跟踪消息和设备消息。
它从 JSON 格式的日志中提取字段,执行日期解析和用户代理转换等数据转换,并将提取的数据映射到统一数据模型 (UDM),根据 traceId
和 event_type
字段处理不同的日志结构。
准备工作
确保您满足以下前提条件:
- Google SecOps 实例
- Windows 2016 或更高版本,或者具有 systemd 的 Linux 主机
- 如果在代理后运行,防火墙端口处于开放状态
- 对 Symantec Web Isolation 平台的特权访问权限
获取 Google SecOps 注入身份验证文件
- 登录 Google SecOps 控制台。
- 依次前往 SIEM 设置 > 收集代理。
- 下载注入身份验证文件。将该文件安全地保存在将要安装 Bindplane 的系统上。
获取 Google SecOps 客户 ID
- 登录 Google SecOps 控制台。
- 依次前往 SIEM 设置 > 配置文件。
- 复制并保存组织详细信息部分中的客户 ID。
安装 Bindplane 代理
Windows 安装
- 以管理员身份打开命令提示符或 PowerShell。
运行以下命令:
```cmd msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet ```
Linux 安装
- 打开具有 root 或 sudo 权限的终端。
运行以下命令:
```bash sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh ```
其他安装资源
如需了解其他安装选项,请参阅安装指南。
配置 Bindplane 代理以注入 Syslog 并将其发送到 Google SecOps
- 访问配置文件:
- 找到
config.yaml
文件。通常,它位于 Linux 上的/etc/bindplane-agent/
目录中或 Windows 上的安装目录中。 - 使用文本编辑器(例如
nano
、vi
或记事本)打开该文件。
- 找到
按如下方式修改
config.yaml
文件:receivers: udplog: # Replace the port and IP address as required listen_address: "0.0.0.0:514" exporters: chronicle/chronicle_w_labels: compression: gzip # Adjust the path to the credentials file you downloaded in Step 1 creds: '/path/to/ingestion-authentication-file.json' # Replace with your actual customer ID from Step 2 customer_id: <customer_id> endpoint: malachiteingestion-pa.googleapis.com # Add optional ingestion labels for better organization ingestion_labels: log_type: 'SYMANTEC_WEB_ISOLATION' raw_log_field: body service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labels
根据基础架构的需要替换端口和 IP 地址。
将
<customer_id>
替换为实际的客户 ID。将
/path/to/ingestion-authentication-file.json
更新为获取 Google SecOps 提取身份验证文件部分中保存身份验证文件的路径。
重启 Bindplane 代理以应用更改
如需在 Linux 中重启 Bindplane 代理,请运行以下命令:
sudo systemctl restart bindplane-agent
如需在 Windows 中重启 Bindplane 代理,您可以使用服务控制台,也可以输入以下命令:
net stop BindPlaneAgent && net start BindPlaneAgent
在 Symantec Web Isolation 平台中配置 Syslog
- 登录 Symantec Web Isolation 网页界面。
- 依次前往系统配置 > 外部日志服务器 > 新的外部日志服务器 > Syslog 服务器。
- 提供以下配置详细信息:
- 状态:选中复选框以启用。
- 主机:输入 Bindplane 代理 IP 地址。
- 端口:输入 Bindplane 代理端口号(例如,UDP 为
514
)。 - 协议:选择 UDP。
- Appname:输入用于标识 Web 隔离平台的标记。
- 设施:与 Web 隔离日志相关的 Syslog 设施名称。
- 点击创建。
- 依次前往报告 > 日志转发。
- 点击修改。
- 提供以下配置详细信息:
- 活动日志:选择新添加的 Bindplane 服务器。
- 管理审核日志:选择新添加的 Bindplane 服务器。
- 网关审核日志:选择新添加的 Bindplane 服务器。
- 点击更新。
UDM 映射表
日志字段 | UDM 映射 | 逻辑 |
---|---|---|
action |
security_result.summary |
与 action_reason 连接以形成摘要。 |
action_reason |
security_result.summary |
与 action 连接以形成摘要。 |
content_action |
security_result.action_details |
直接映射。 |
createdAt |
metadata.event_timestamp |
使用 UNIX_MS 格式转换为时间戳。 |
creationDate |
metadata.event_timestamp |
使用 UNIX_MS 格式转换为时间戳。 |
data.level |
security_result.severity |
根据值映射到 INFORMATIONAL、LOW 或 HIGH。 |
data.properties.environment.str |
intermediary.location.name |
直接映射。 |
data.properties.hostname.str |
intermediary.hostname |
直接映射。 |
destination_ip |
target.ip |
直接映射。 |
destination_ip_country_name |
target.location.country_or_region |
直接映射。 |
device.current_risk_warnings |
security_result.category_details |
直接映射。 |
device.identifier |
target.asset.product_object_id |
直接映射。 |
device.model |
hardware.model |
直接映射。 |
device.os_version |
target.asset.platform_software.platform_version |
直接映射。 |
device.serial_number |
hardware.serial_number |
直接映射。 |
device.udid |
target.asset.asset_id |
在映射之前,以“UDID:”为前缀。 |
device.user.email |
target.user.email_addresses |
直接映射。 |
device.user.id |
target.user.userid |
直接映射。 |
device.user.name |
target.user.user_display_name |
直接映射。 |
device.user.organization.id |
target.user.groupid |
直接映射。 |
device.user.organization.name |
target.user.group_identifiers |
直接映射。 |
event |
metadata.product_event_type |
直接映射。 |
event_type |
metadata.event_type |
根据日志数据,设置为“GENERIC_EVENT”或“NETWORK_HTTP”。 |
file_name |
target.file.names |
直接映射。 |
file_type |
about.labels ,about.resource.attribute.labels |
添加为键为“file_type”的标签。 |
id |
metadata.product_log_id |
直接映射。 |
isolation_session_id |
network.parent_session_id |
直接映射。 |
level |
security_result.severity |
根据值映射到 INFORMATIONAL、LOW 或 HIGH。 |
original_source_ip |
principal.ip |
直接映射。 |
policy_version |
security_result.rule_version |
直接映射。 |
properties.environment |
intermediary.location.name |
直接映射。 |
properties.hostname |
intermediary.hostname |
直接映射。 |
referer_url |
network.http.referral_url |
直接映射。 |
request_method |
network.http.method |
直接映射。 |
resource_response_headers.x-nauthilus-traceid |
network.community_id |
直接映射。 |
response_status_code |
network.http.response_code |
直接映射。 |
rule_id |
security_result.rule_id |
直接映射。 |
rule_name_at_log_time |
security_result.rule_name |
直接映射。 |
rule_type |
security_result.rule_type |
直接映射。 |
service |
principal.application |
直接映射。 |
session_id |
network.session_id |
直接映射。 |
severity |
security_result.severity |
根据值映射到 LOW、MEDIUM 或 HIGH。 |
source_ip |
principal.ip |
直接映射。 |
source_ip_country_name |
principal.location.country_or_region |
直接映射。 |
source_port |
principal.port |
直接映射。 |
sub_type |
security_result.summary |
直接映射。 |
target.asset.type |
target.asset.type |
如果 device.model 包含“ipad”或“iphone”,则设置为“MOBILE”。 |
target.asset.platform_software.platform |
target.asset.platform_software.platform |
如果 device.model 包含“ipad”或“iphone”,则设置为“MAC”。 |
timestamp |
metadata.event_timestamp |
使用 yyyy-MM-dd HH:mm:ss.SSS Z 格式进行解析。 |
total_bytes |
network.received_bytes |
如果大于 0,则直接映射。 |
traceId |
metadata.product_log_id |
直接映射。 |
type |
metadata.product_event_type |
直接映射。 |
url |
target.url |
直接映射。 |
url_host |
principal.hostname |
直接映射。 |
user_download_usage_bytes |
network.received_bytes |
直接映射。 |
user_total_usage_bytes |
about.labels ,about.resource.attribute.labels |
添加为键为“user_total_usage_bytes”的标签。 |
user_upload_usage_bytes |
network.sent_bytes |
直接映射。 |
username |
principal.user.user_display_name |
直接映射。 |
vendor_name |
metadata.vendor_name |
设置为“Broadcom Inc.”。 |
product_name |
metadata.product_name |
设置为“Symantec Web Isolation”。 |
log_type |
metadata.log_type |
设置为“SYMANTEC_WEB_ISOLATION”。 |
sandbox |
about.labels ,about.resource.attribute.labels |
以标签的形式添加,键为“Sandbox”,值从网址中提取。 |
utub |
about.labels ,about.resource.attribute.labels |
添加为键为“user_total_usage_bytes”的标签。 |
userid |
target.user.userid |
从网址中提取。 |
需要更多帮助?从社区成员和 Google SecOps 专业人士那里获得解答。