收集 WinSCP 日志
本文档介绍了如何使用 Bindplane 代理将 WinSCP 日志注入 Google Security Operations。
WinSCP 是一款适用于 Windows 的开源 SFTP、SCP 和 FTP 客户端,可生成文件传输、身份验证和会话活动日志。Bindplane 代理会直接从本地文件系统收集 WinSCP 会话日志文件。
准备工作
请确保满足以下前提条件:
- Google SecOps 实例
- Windows Server 2016 或更高版本,支持
observiq-otel-collector服务 - 如果在代理后面运行,请确保按照 Bindplane 代理要求打开防火墙端口
- 运行 WinSCP 且已启用日志记录的 Windows 机器
获取 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 操作系统上安装 Bindplane 代理。
Windows 安装
- 以管理员身份打开命令提示符或 PowerShell。
运行以下命令:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet等待安装完成。
运行以下命令,验证安装是否成功:
sc query observiq-otel-collector该服务应显示为正在运行。
其他安装资源
如需了解其他安装选项和问题排查,请参阅 Bindplane 代理安装指南。
配置 Bindplane 代理以注入日志并发送到 Google SecOps
找到配置文件
Windows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
修改配置文件
将
config.yaml的全部内容替换为以下配置:receivers: filelog: include: - C:\Logs\WinSCP\*.log start_at: beginning exporters: chronicle/winscp: 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 creds_file_path: 'C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json' customer_id: '<customer_id>' endpoint: chronicle.googleapis.com log_type: WINSCP raw_log_field: body ingestion_labels: env: production service: pipelines: logs/winscp_to_chronicle: receivers: - filelog exporters: - chronicle/winscp
配置参数
替换以下占位符:
接收器配置:
filelog:用于从磁盘收集日志文件的接收器类型include:要监控的文件路径列表。将此值设置为 WinSCP 写入会话日志的位置(例如C:\Logs\WinSCP\*.log)start_at:设置为beginning可读取现有日志,设置为end可仅读取新条目
导出器配置:
winscp:导出器的描述性名称creds_file_path:服务账号 JSON 密钥文件的完整路径(选项 1):- Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Windows:
<customer_id>:上一步中的客户 IDlocation:将<LOCATION>替换为 Google SecOps 实例所在的区域(例如us、europe或asia-southeast1)。导出工具会在此值前面加上chronicle.googleapis.com。如需查看完整列表,请参阅区域级端点。project:将<PROJECT_NUMBER>替换为 IAM 和管理 > 设置中的项目编号。endpoint:保持设置为chronicle.googleapis.com。WINSCP:日志类型,与 Chronicle 中显示的完全一致ingestion_labels:YAML 格式的可选标签(例如env: production)
流水线配置:
winscp_to_chronicle:流水线的描述性名称
旧版提取 API 导出工具
如果您使用选项 2 中的数据注入身份验证文件,请将
exporters代码块替换为以下内容。将creds_file_path设置为数据注入身份验证文件的路径,如果您的实例位于美国境外,请将malachiteingestion-pa.googleapis.com替换为您的区域端点(例如europe-malachiteingestion-pa.googleapis.com)。exporters: chronicle/winscp: compression: gzip creds_file_path: 'C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: WINSCP raw_log_field: body ingestion_labels: env: production
保存配置文件
- 修改后,保存文件:
- Windows:依次点击文件 > 保存
重启 Bindplane 代理以应用更改
如需在 Windows 中重启 Bindplane 代理,请选择以下选项之一:
以管理员身份运行命令提示符或 PowerShell:
net stop observiq-otel-collector && net start observiq-otel-collector“服务”控制台:
- 按
Win+R,输入services.msc,然后按 Enter 键。 - 找到 observIQ OpenTelemetry 收集器。
- 右键点击并选择重启。
验证服务是否正在运行:
sc query observiq-otel-collector检查日志中的错误:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
- 按
配置 WinSCP 日志导出
WinSCP 会将会话日志写入用户配置的位置。您需要在 WinSCP 中启用日志记录,并将 Bindplane 代理指向日志目录。
- 在 Windows 机器上打开 WinSCP。
- 依次前往选项 > 偏好设置 > 日志记录。
- 启用会话日志记录:
- 勾选在以下级别启用会话日志记录。
- 选择正常或调试 1 日志记录级别。
- 将日志文件名设置为集中式路径(例如
C:\Logs\WinSCP\winscp.log)。
- 点击确定以保存设置。
如果日志目录不存在,请创建该目录:
mkdir C:\Logs\WinSCP执行文件传输会话后,验证 WinSCP 是否将日志文件写入配置的目录。
确保
config.yaml中的 Bindplane 代理include路径与日志目录匹配。
UDM 映射表
| 日志字段 | UDM 映射 | 逻辑 |
|---|---|---|
| directory,console,consoleinstance,public_key,script,hostkey,total_size | additional.fields | 事件的其他自定义字段 |
| 说明 | metadata.description | 事件的说明 |
| 时间戳 | metadata.event_timestamp | 事件发生时的时间戳 |
| metadata.event_type | 事件的类型 | |
| src_ip | principal.asset.ip | 与主账号关联的资产的 IP 地址 |
| local_file | principal.file.full_path | 与主账号关联的文件的完整路径 |
| src_ip | principal.ip | 主体的 IP 地址 |
| command_line | principal.process.command_line | 用于启动进程的命令行 |
| 用户名 | principal.user.userid | 主账号的用户 ID |
| transfer_speed,result | security_result.detection_fields | 安全结果中与检测相关的字段 |
| file,target_file | target.file.full_path | 目标文件的完整路径 |
| file_type | target.file.mime_type | 目标文件的 MIME 类型 |
| file_size | target.file.size | 目标文件的大小(以字节为单位) |
| metadata.product_name | 生成事件的产品名称 | |
| metadata.vendor_name | 商品供应商的名称 |