Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

收集 Windows 防火墙日志

支持：

Google SecOps SIEM

本文档介绍了如何使用 Bindplane 将 Windows 防火墙日志注入 Google Security Operations。

Windows 防火墙是内置的 Windows 主机防火墙，可生成连接允许/阻止、规则更改和服务事件日志。Bindplane 代理会直接从本地文件系统收集防火墙日志文件。

准备工作

请确保满足以下前提条件：

Google SecOps 实例
Windows Server 2016 或更高版本，且支持 observiq-otel-collector 服务
如果通过代理运行，请确保防火墙端口根据 Bindplane 代理要求处于开放状态
对生成防火墙日志的 Windows 主机拥有管理员权限

获取 Bindplane 代理的 Google SecOps 凭据

如需对 Bindplane 代理进行 Google SecOps 身份验证，请选择以下方法之一：

新部署：使用 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 代理导出器需要客户 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
```

该服务应显示为 RUNNING 。

其他安装资源

如需了解其他安装选项和问题排查信息，请参阅 Bindplane 代理安装指南。

配置 Bindplane 代理以注入日志并发送到 Google SecOps

找到配置文件

Windows ：

notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"

修改配置文件

将 config.yaml 的全部内容替换为以下配置：

receivers:
  filelog:
    include:
      - C:\Windows\system32\LogFiles\Firewall\pfirewall.log
    start_at: beginning

exporters:
  chronicle/windows_firewall:
    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: WINDOWS_FIREWALL
    raw_log_field: body
    ingestion_labels:
      env: production

service:
  pipelines:
    logs/firewall_to_chronicle:
      receivers:
        - filelog
      exporters:
        - chronicle/windows_firewall

配置参数

替换以下占位符：

接收器配置：
- filelog：用于从磁盘收集日志文件的接收器类型
- include：要监控的文件路径列表。默认 Windows 防火墙日志位置：
  - C:\Windows\system32\LogFiles\Firewall\pfirewall.log
- start_at：设置为 beginning 可读取现有日志，设置为 end 可仅读取新条目
导出器配置：
- windows_firewall：导出器的描述性名称
- creds_file_path：服务帐号 JSON 密钥文件的完整路径（方法 1）：
  - Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- <customer_id>：上一步中的客户 ID
- location：将 <LOCATION> 替换为 Google SecOps 实例的区域（例如 us、europe 或 asia-southeast1）。导出器会使用此值为 chronicle.googleapis.com 添加前缀。如需查看完整列表，请参阅区域级端点。
- project：将 <PROJECT_NUMBER> 替换为 IAM 和管理 > 设置 中的项目编号。
- endpoint：保持设置为 chronicle.googleapis.com。
- WINDOWS_FIREWALL：日志类型，与 Chronicle 中显示的内容完全一致
- ingestion_labels：YAML 格式的可选标签（例如 env: production）
流水线配置：
- firewall_to_chronicle：流水线的描述性名称

旧版注入 API 导出器

如果您使用方法 2 中的注入身份验证文件，请将 exporters 代码块替换为以下内容。将 creds_file_path 设置为注入身份验证文件的路径，如果您的实例位于美国境外，请将 malachiteingestion-pa.googleapis.com 替换为您的区域级端点（例如 europe-malachiteingestion-pa.googleapis.com）。

exporters:
  chronicle/windows_firewall:
    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: WINDOWS_FIREWALL
    raw_log_field: body
    ingestion_labels:
      env: production

保存配置文件

修改后，保存文件：
- Windows：依次点击文件 > 保存

重启 Bindplane 代理以应用更改

如需在 Windows 中重启 Bindplane 代理，请执行以下操作：

请从下列选项中选择一项：
- 以管理员身份运行命令提示符或 PowerShell：
```
net stop observiq-otel-collector && net start observiq-otel-collector
```
- 服务控制台：
  1. 按 Win+R，输入 services.msc，然后按 Enter 键。
  2. 找到 observIQ OpenTelemetry Collector 。
  3. 右键点击，然后选择重启。
验证服务是否正在运行：
```
sc query observiq-otel-collector
```

检查日志中的错误：

type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"

配置 Windows 防火墙日志记录

按 Win+R，输入 wf.msc，然后按 Enter 键，打开 Windows Defender Firewall with Advanced Security 。
在左侧窗格中，右键点击 Windows Defender Firewall with Advanced Security on Local Computer ，然后选择属性。
选择相应的个人资料标签页（网域个人资料、不公开个人资料或公开个人资料）。
在日志记录 下，点击自定义 。
提供以下配置详细信息：
- 记录丢弃的数据包：选择是。
- 记录成功的连接：选择是。
- 名称：验证日志文件路径是否为 %systemroot%\system32\LogFiles\Firewall\pfirewall.log（默认）。
- 大小限制 (KB)：设置为至少 4096 以捕获足够的日志数据。
点击 OK 保存日志记录设置。
根据需要，针对每个个人资料标签页（网域、不公开、公开）重复执行第 3-6 步。
验证日志文件是否正在写入 C:\Windows\system32\LogFiles\Firewall\pfirewall.log。
确保 config.yaml 中的 Bindplane 代理 include 路径与防火墙日志文件路径匹配。

注意：默认情况下，Windows 防火墙仅记录丢弃的数据包。如需捕获所有连接事件以进行安全监控，请同时启用记录丢弃的数据包 和记录成功的连接 。Bindplane 代理服务帐号必须拥有日志文件的读取权限。

UDM 映射表

日志字段	UDM 映射	逻辑
tcpflags、tcpsyn、tcpack、tcpwin、icmptype、icmpcode	about.labels	如果字段 !=“-”，则合并为键值对
时间戳	metadata.event_timestamp	使用 yyyy-MM-dd HH:mm:ss 格式进行解析
	metadata.event_type	设置为“NETWORK_CONNECTION”
方向	network.direction	如果方向在 [“SEND”“FORWARD”] 中，则设置为“OUTBOUND”；如果方向 ==“RECEIVE”，则设置为“INBOUND”
协议	network.ip_protocol	如果协议在 [“TCP”“UDP”“ICMP”] 中，则直接复制值
大小	network.received_bytes	如果方向 ==“RECEIVE”且大小 !=“-”，则转换为 uinteger
大小	network.sent_bytes	如果方向在 [“SEND”“FORWARD”] 中且大小 !=“-”，则转换为 uinteger
src_ip	principal.ip	直接复制值
src_port	principal.port	如果 src_port !=“-”，则转换为整数
操作	security_result.action	如果操作 ==“DROP”，则设置为“BLOCK”；如果操作 ==“ALLOW”，则设置为“ALLOW”
信息	security_result.summary	如果信息 !=“-”，则直接复制值
dst_ip	target.ip	直接复制值
dst_port	target.port	如果 dst_port !=“-”，则转换为整数
	metadata.product_name	设置为“Windows Firewall”
	metadata.vendor_name	设置为“Microsoft”