收集 Zscaler NSS Feeds for Alerts 日志

支持范围:

本文档介绍了如何使用 Bindplane 代理将 Zscaler NSS Feeds for Alerts 日志注入 Google Security Operations。

Zscaler Nanolog Streaming Service (NSS) 可提供 Web、防火墙和 DLP 事件的云安全提醒日志。NSS 使用 Cloud NSS(云原生)或 NSS 虚拟机(本地虚拟设备)将日志从 Zscaler 云流式传输到指定目标位置。

准备工作

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

  • Google SecOps 实例
  • Windows Server 2016 或更高版本,或者安装了 systemd 的 Linux 主机
  • Bindplane 代理与 Zscaler NSS 输出之间的网络连接
  • 如果在代理后面运行,请确保按照 Bindplane 代理要求打开防火墙端口
  • 对 Zscaler Internet Access (ZIA) 管理员门户的特权访问权限
  • 已配置的 Zscaler NSS 服务器或 NSS for Cloud,且具有流式传输日志的权限

获取 Bindplane 代理的 Google SecOps 凭证

如需向 Google SecOps 验证 Bindplane 代理,请选择以下方法之一:

  • 新部署:使用 Chronicle API(选项 1)。
  • 旧版部署:继续使用数据注入身份验证文件(方法 2),直到 Ingestion API 于 2027 年 7 月 20 日停用。
  1. 登录 Google Cloud 控制台,然后选择与您的 Google SecOps 实例关联的 Google Cloud 项目。
  2. 依次前往 IAM 和管理 > 服务账号。
  3. 点击创建服务账号。
  4. 提供以下配置详细信息:
    • 服务账号名称:输入账号的名称(例如 bindplane-ingest)。
    • 服务账号说明:输入说明(例如 Bindplane agent log ingestion)。
  5. 点击创建并继续。
  6. 在向此服务账号授予对项目的访问权限部分,点击选择角色,然后选择 Chronicle Editor。
  7. 点击继续,然后点击完成。
  8. 点击您创建的服务账号,然后前往密钥标签页。
  9. 依次点击添加密钥 > 创建新密钥。
  10. 选择 JSON,然后点击创建。密钥文件会下载到您的计算机上。
  11. 将密钥文件另存为 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 以匹配您保存它的路径。
  12. 前往 IAM 和管理 > 设置,然后复制项目编号。您在配置导出器时需要用到该名称。

方法 2:下载数据注入身份验证文件(旧版)

  1. 登录 Google SecOps 控制台。
  2. 依次前往设置 > 数据管理 > 收集代理。如果您使用的是仅限 SIEM 的平台,请依次前往设置 > 收集代理。
  3. 下载数据注入身份验证文件。
  4. 将该文件安全地保存在将要安装 Bindplane 代理的系统上。

获取 Google SecOps 客户 ID

  1. 登录 Google SecOps 控制台。
  2. 依次前往设置 > 管理 > 个人资料。如果您使用的是仅限 SIEM 的平台,请依次前往设置 > 个人资料。
  3. 复制并保存组织详细信息部分中的客户 ID。

安装 Bindplane 代理

根据以下说明,在 Windows 或 Linux 操作系统上安装 Bindplane 代理。

Windows 安装

  1. 以管理员身份打开命令提示符或 PowerShell。
  2. 运行以下命令:

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    
  3. 等待安装完成。

  4. 运行以下命令,验证安装是否成功:

    sc query observiq-otel-collector
    

    该服务应显示为正在运行。

Linux 安装

  1. 打开具有 root 或 sudo 权限的终端。
  2. 运行以下命令:

    sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
    
  3. 等待安装完成。

  4. 运行以下命令,验证安装是否成功:

    sudo systemctl status observiq-otel-collector
    

    该服务应显示为 active (running)。

其他安装资源

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

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

找到配置文件

  • Linux:

    sudo nano /opt/observiq-otel-collector/config.yaml
    
  • Windows:

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

修改配置文件

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

    receivers:
      tcplog:
        listen_address: "0.0.0.0:514"
    
    exporters:
      chronicle/zscaler_nss:
        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: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: chronicle.googleapis.com
        log_type: ZSCALER_NSS_FEEDS
        raw_log_field: body
    
    service:
      pipelines:
        logs/zscaler_nss_to_chronicle:
          receivers:
            - tcplog
          exporters:
            - chronicle/zscaler_nss
    

配置参数

替换以下占位符:

  • 接收器配置:

    • listen_address:要监听的 IP 地址和端口:
      • 0.0.0.0,以监听所有接口(推荐)
      • 端口 514 是标准 syslog 端口(在 Linux 上需要 root 权限;对于非 root 用户,请使用 1514)
  • 导出器配置:

    • creds_file_path:服务账号 JSON 密钥文件的完整路径(选项 1):
      • Linux:/opt/observiq-otel-collector/ingestion-auth.json
      • Windows:C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • customer_id:从 Google SecOps 控制台复制的客户 ID
    • location:将 <LOCATION> 替换为 Google SecOps 实例所在的区域(例如 us、europe 或 asia-southeast1)。导出工具会在此值前面加上 chronicle.googleapis.com。如需查看完整列表,请参阅区域级端点。
    • project:将 <PROJECT_NUMBER> 替换为 IAM 和管理 > 设置中的项目编号。
    • endpoint:保持设置为 chronicle.googleapis.com。

旧版提取 API 导出工具

  • 如果您使用选项 2 中的数据注入身份验证文件,请将 exporters 代码块替换为以下内容。将 creds_file_path 设置为数据注入身份验证文件的路径,如果您的实例位于美国境外,请将 malachiteingestion-pa.googleapis.com 替换为您的区域端点(例如 europe-malachiteingestion-pa.googleapis.com)。

    exporters:
      chronicle/zscaler_nss:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: ZSCALER_NSS_FEEDS
        raw_log_field: body
    

保存配置文件

  • 修改后,保存文件:

    • Linux:依次按 Ctrl+O、Enter 和 Ctrl+X
    • Windows:依次点击文件 > 保存

重启 Bindplane 代理以应用更改

  • 如需在 Linux 中重启 Bindplane 代理,请运行以下命令:

    sudo systemctl restart observiq-otel-collector
    
    1. 验证服务是否正在运行:

      sudo systemctl status observiq-otel-collector
      
    2. 检查日志中的错误:

      sudo journalctl -u observiq-otel-collector -f
      
  • 如需在 Windows 中重启 Bindplane 代理,请选择以下选项之一:

    • 以管理员身份运行命令提示符或 PowerShell:
    net stop observiq-otel-collector && net start observiq-otel-collector
    
    • “服务”控制台:

      1. 按 Win+R,输入 services.msc,然后按 Enter 键。
      2. 找到 observIQ OpenTelemetry 收集器。
      3. 右键点击并选择重启。
      4. 验证服务是否正在运行:

          sc query observiq-otel-collector
        
      5. 检查日志中的错误:

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

配置 Zscaler NSS syslog 转发

Zscaler NSS 会将日志从 Zscaler 云流式传输到指定目标位置。选择与您的环境匹配的选项。

  1. 登录 Zscaler Internet Access (ZIA) 管理门户。
  2. 依次前往管理 > Nanolog Streaming Service > Cloud NSS Feeds。
  3. 点击添加 Cloud NSS Feed。
  4. 配置以下参数:
    • Feed 名称:输入描述性名称(例如 NSS-Alerts-to-Chronicle)。
    • NSS Type(NSS 类型):选择日志类型:NSS for Alerts(提醒 NSS)。
    • SIEM 类型:选择其他,以进行基于 syslog 的通用注入。
    • 状态:选择已启用。
    • API 网址:输入 Bindplane 代理主机的 IP 地址和端口(例如 http://BINDPLANE_AGENT_IP:514)。
    • Feed Output Type(Feed 输出类型):选择 JSON(建议用于 Chronicle 提取)。
    • 时区:选择 GMT(默认)。
  5. (可选)配置 Feed Output Filters(Feed 输出过滤条件),以仅包含特定日志字段,或按部门、位置或操作等条件过滤日志。
  6. 点击保存。
  7. 点击启用以启用待处理的配置更改。

选项 2:部署和配置 NSS 虚拟机(本地)

  1. 从 Zscaler 管理员门户下载 NSS 虚拟机映像:
    1. 依次前往管理 > Nanolog Streaming Service > NSS 服务器。
    2. 下载 NSS OVA(适用于 VMware)或 VHD(适用于 Hyper-V/Azure)映像。
  2. 在您的 hypervisor(VMware vSphere、Hyper-V 或 Azure)中部署 NSS 虚拟机:
    1. 导入下载的映像,并使用推荐的资源配置虚拟机(请参阅适用于您平台的 NSS 部署指南)。
    2. 配置网络设置,以便 NSS 虚拟机可以与 Zscaler 云建立出站 TLS 连接。
  3. 在 ZIA 管理门户中注册 NSS 虚拟机:
    1. 依次前往管理 > Nanolog Streaming Service > NSS 服务器。
    2. 验证 NSS 虚拟机是否显示,并且其状态列是否显示为正常。
  4. 配置 NSS Feed:
    1. 依次前往 Administration(管理)> Nanolog Streaming Service(Nanolog 流式传输服务)> NSS Feeds(NSS Feed)。
    2. 点击添加 NSS Feed。
    3. 配置以下参数:
      • Feed 名称:输入描述性名称(例如 NSS-Alerts-Feed)。
      • NSS 服务器:选择已部署的 NSS 虚拟机。
      • NSS Type(NSS 类型):选择日志类型:NSS for Alerts(提醒 NSS)。
      • SIEM IP 地址:输入 Bindplane 代理主机的 IP 地址。
      • SIEM TCP 端口:输入 514(或在 Bindplane 代理中配置的端口)。
      • Feed 输出类型:选择 JSON(推荐)。
    4. (可选)配置 Feed 过滤条件,以限制流式传输哪些日志条目。
    5. 点击保存。
  5. 点击启用以启用待处理的配置更改。

UDM 映射表

日志字段 UDM 映射 逻辑
其他 其他 事件的其他信息
meta.slt.node, meta.slt.pipeline, meta.customer, meta.source.type additional.fields 其他 UDM 字段未涵盖的其他元数据字段
metadata.event_type 事件类型
网络 网络 事件的网络信息
主体 主体 事件中涉及的主体实体
meta.source.host principal.asset.hostname 与主账号关联的资产的主机名
meta.source.host principal.hostname 主账号的主机名
meta.source.port principal.port 端口号
security_result security_result 安全结果信息
目标 目标 事件中涉及的目标实体
meta.proxy.host target.asset.hostname 与目标关联的资产的主机名
meta.proxy.host target.hostname 目标的主机名
meta.proxy.port target.port 端口号
metadata.product_name 商品名称
metadata.vendor_name 供应商名称

更新日志

查看此解析器的更新日志

需要更多帮助?获得社区成员和 Google SecOps 专业人士的解答。