收集 Nasuni File Services Platform 日志
支持的语言:
Google SecOps
SIEM
本文档介绍了如何使用 Bindplane 代理将 Nasuni File Services Platform 日志注入到 Google Security Operations。解析器从 SYSLOG 和 JSON 日志中提取字段。它使用 grok 模式解析初始消息,然后利用 JSON 过滤器处理嵌入式 JSON 数据,将提取的字段映射到 UDM,处理各种事件类型(例如文件读取、修改和通用事件),并使用供应商和产品信息丰富数据。它还会根据提取的字段执行条件逻辑,以对事件进行分类并填充 UDM 元数据。
准备工作
- 确保您拥有 Google SecOps 实例。
- 确保您使用的是 Windows 2016 或更高版本,或者具有
systemd
的 Linux 主机。 - 如果通过代理运行,请确保防火墙端口处于开放状态。
- 确保您拥有对 Claroty CTD 的特权访问权限。
获取 Google SecOps 注入身份验证文件
- 登录 Google SecOps 控制台。
- 依次前往 SIEM 设置 > 收集代理。
- 下载注入身份验证文件。将文件安全地保存在将要安装 Bindplane 的系统上。
获取 Google SecOps 客户 ID
- 登录 Google SecOps 控制台。
- 依次前往 SIEM 设置 > 配置文件。
- 复制并保存组织详细信息部分中的客户 ID。
安装 Bindplane 代理
Windows 安装
- 以管理员身份打开命令提示符或 PowerShell。
运行以下命令:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
Linux 安装
- 打开具有 root 或 sudo 权限的终端。
运行以下命令:
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: NASUNI_FILE_SERVICES 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
在 Nasuni File Service 平台中配置 Syslog
- 登录 Nasuni Console 网页界面。
- 依次前往控制台设置 > Syslog 导出。
- 在“网络”部分中,输入以下配置详细信息:
- 主机名:输入一个唯一且有意义的名称(例如 Google SecOps syslog)。
- IP 地址:输入 Bindplane IP 地址。
- 端口:输入 Bindplane 配置端口号(例如,UDP 为 514)。
- 协议:选择 UDP(您也可以选择 TCP,具体取决于您的 Bindplane 配置)。
- 格式:选择 SYSLOG+JSON。
- 点击保存。
UDM 映射表
日志字段 | UDM 映射 | 逻辑 |
---|---|---|
application |
target.application |
当 msg 字段存在且不是 JSON,且 application 字段不为空时填充。 |
event_type |
metadata.product_event_type |
直接从原始日志中的 event_type 字段映射。 |
gid |
target.group.product_object_id |
直接从原始日志中的 gid 字段映射,并转换为字符串。 |
groupname |
target.group.group_display_name |
直接从原始日志中的 groupname 字段映射。 |
host |
principal.hostname |
直接从原始日志中的 host 字段映射。 |
ipaddr |
principal.ip |
直接从原始日志中的 ipaddr 字段映射。 |
is_dir |
additional.fields.value.string_value (其中密钥为 is_dir ) |
直接从原始日志中的 is_dir 字段映射,并转换为字符串。已添加为附加字段。 |
msg |
metadata.description |
当存在 msg 字段、该字段不是 JSON,且未从中提取 ipaddr 和 prin_port 时填充。也用于 STATUS_UPDATE 事件。 |
newpath |
additional.fields.value.string_value (其中密钥为 newpath ) |
直接从原始日志中的 newpath 字段映射。已添加为附加字段。 |
offset |
additional.fields.value.string_value (其中密钥为 offset ) |
直接从原始日志中的 offset 字段映射,并转换为字符串。已添加为附加字段。 |
path |
target.file.full_path |
直接从原始日志中的 path 字段映射。 |
pid |
target.process.pid |
直接从原始日志中的 pid 字段映射,并转换为字符串。 |
prin_port |
principal.port |
当 msg 不是 JSON 时,使用 grok 从 msg 字段中提取,并转换为整数。 |
proc_id |
principal.process.pid |
直接从原始日志中的 proc_id 字段映射。 |
product_log_id |
metadata.product_log_id |
直接从原始日志中的 product_log_id 字段映射。 |
proto |
metadata.description |
直接从原始日志中的 proto 字段映射。 |
resource |
target.resource.resource_subtype |
直接从原始日志中的 resource 字段映射。 |
sequence |
additional.fields.value.string_value (其中密钥为 sequence ) |
直接从原始日志中的 sequence 字段映射,并转换为字符串。已添加为附加字段。 |
sid |
principal.user.windows_sid |
直接从原始日志中的 sid 字段映射。 |
tid |
target.resource.product_object_id |
直接从原始日志中的 tid 字段映射,并转换为字符串。 |
time |
metadata.event_timestamp.seconds ,timestamp.seconds |
时间戳的秒部分是从 time 字段中提取的,用于填充 metadata.event_timestamp 和顶级 timestamp 。由基于 ipaddr 、path 和 event_type 值的逻辑确定。可以是 FILE_READ 、FILE_MODIFICATION 、FILE_UNCATEGORIZED 、STATUS_UPDATE 或 GENERIC_EVENT 。硬编码为 NASUNI_FILE_SERVICES 。硬编码为 Nasuni File Services Platform 。硬编码为 Nasuni 。 |
uid |
additional.fields.value.string_value (其中密钥为 uid ) |
直接从原始日志中的 uid 字段映射,并转换为字符串。已添加为附加字段。 |
username |
principal.user.user_display_name |
直接从原始日志中的 username 字段映射。 |
volume |
additional.fields.value.string_value (其中密钥为 volume ) |
直接从原始日志中的 volume 字段映射。已添加为附加字段。 |
需要更多帮助?从社区成员和 Google SecOps 专业人士那里获得解答。