收集 Check Point Harmony 日志

支持的语言:

本文档介绍了如何使用 Bindplane 将 Check Point Harmony Email and Collaboration (HEC) 日志注入到 Google Security Operations。此解析器代码从 Check Point Harmony syslog 消息中提取键值对,并将其映射到统一数据模型 (UDM)。它首先对消息格式进行归一化处理,然后以迭代方式解析字段并将其映射到 principaltargetnetworksecurity_result 等 UDM 类别,从而丰富数据以供安全分析。

准备工作

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

  • Google SecOps 实例
  • Windows 2016 或更高版本,或者具有 systemd 的 Linux 主机
  • 如果在代理后运行,防火墙端口处于开放状态
  • 对 Check Point Harmony HEC (Infinity Portal) 的特权访问权限

获取 Google SecOps 注入身份验证文件

  1. 登录 Google SecOps 控制台。
  2. 依次前往 SIEM 设置 > 收集代理
  3. 下载注入身份验证文件。将该文件安全地保存在将要安装 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
    

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
    

其他安装资源

如需了解其他安装选项,请参阅安装指南

配置 Bindplane 代理以注入 Syslog 并将其发送到 Google SecOps

  1. 访问配置文件:
    • 找到 config.yaml 文件。通常,它位于 Linux 上的 /etc/bindplane-agent/ 目录中或 Windows 上的安装目录中。
    • 使用文本编辑器(例如 nanovi 或记事本)打开该文件。
  2. 按如下方式修改 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_file_path: '/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
            log_type: 'CHECKPOINT_HARMONY'
            raw_log_field: body
            ingestion_labels:
    
    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
    

为 Check Point Harmony HEC 配置 Syslog

  1. 登录 Infinity Portal > Harmony Email & Collaboration Web 界面。
  2. 依次前往设置> 监控 > SIEM
  3. 点击添加 SIEM 服务器
  4. 提供以下配置详细信息:
    • 主机:输入 Bindplane 代理 IP 地址。
    • 端口:输入 Bindplane 代理端口号。
    • 协议:选择 UDP
    • (可选)令牌:为日志输入可选标记。
  5. 点击保存

UDM 映射表

日志字段 UDM 映射 逻辑
操作 security_result.action_details 直接映射。
security_result.action 根据操作字段的值映射到 ALLOW、BLOCK、ALLOW_WITH_MODIFICATION 或 QUARANTINE。
additional_info additional.fields.value.string_value 直接映射,键 = additional_info
analyzed_on security_result.detection_fields.value 直接映射,键 = analyzed_on
client_name additional.fields.value.string_value 直接映射,键 = client_name
client_version intermediary.platform_version 直接映射。
confidence_level security_result.detection_fields.value 直接映射,键 = confidence_level
security_result.confidence 根据 confidence_level 字段的值映射到 UNKNOWN_CONFIDENCE、LOW_CONFIDENCE、MEDIUM_CONFIDENCE 或 HIGH_CONFIDENCE。
说明 security_result.description 直接映射。
dst target.ip 直接映射。
dst_dns_name security_result.detection_fields.value 直接映射,键 = dst_dns_name
dst_machine_name security_result.detection_fields.value 直接映射,键 = dst_machine_name
target.asset.hostname 直接映射。
target.hostname 直接映射。
dst_user_dn security_result.detection_fields.value 直接映射,键 = dst_user_dn
dst_user_name target.user.userid 直接映射。
ep_rule_id security_result.rule_id 如果 rule_uid 为空,则直接映射。
错误 security_result.summary 直接映射。
event_type metadata.product_event_type 直接映射。
file_md5 target.process.file.md5 如果该值是有效的 MD5 哈希且不全为零,则直接映射。
target.file.md5 如果该值是有效的 MD5 哈希且不全为零,则直接映射。
file_name target.process.file.full_path 直接映射。
file_sha1 target.process.file.sha1 如果该值是有效的 SHA-1 哈希值且不全为零,则直接映射。
target.file.sha1 如果该值是有效的 SHA-1 哈希值且不全为零,则直接映射。
file_sha256 target.process.file.sha256 如果该值是有效的 SHA256 哈希值且不全为零,则直接映射。
target.file.sha256 如果该值是有效的 SHA256 哈希值且不全为零,则直接映射。
file_size target.file.size 直接映射。
file_type target.file.file_type 根据 file_type 字段的值,映射到 FILE_TYPE_ZIP、FILE_TYPE_DOS_EXE、FILE_TYPE_PDF 或 FILE_TYPE_XLSX。
flags additional.fields.value.string_value 直接映射,键 = flags
fw_subproduct additional.fields.value.string_value 如果商品为空,则直接映射到键 = fw_subproduct
metadata.product_name 如果商品为空,则直接映射。
host_type security_result.detection_fields.value 直接映射,键 = host_type
ifdir network.direction 转换为大写后直接映射。
ifname security_result.detection_fields.value 直接映射,键 = ifname
installed_products security_result.detection_fields.value 直接映射,键 = installed_products
is_scanned security_result.detection_fields.value 直接映射,键 = is_scanned
layer_name security_result.detection_fields.value 直接映射,键 = layer_name
security_result.rule_set_display_name 直接映射。
layer_uuid security_result.detection_fields.value 直接映射,键 = layer_uuid
security_result.rule_set 直接映射。
loguid metadata.product_log_id 直接映射。
machine_guid principal.asset.attribute.labels.value 直接映射,键 = machine_guid
malware_action security_result.detection_fields.value 直接映射,键 = malware_action
malware_family security_result.detection_fields.value 直接映射,键 = malware_family
media_authorized security_result.detection_fields.value 直接映射,键 = media_authorized
media_class_id security_result.detection_fields.value 直接映射,键 = media_class_id
media_description security_result.detection_fields.value 直接映射,键 = media_description
media_encrypted security_result.detection_fields.value 直接映射,键 = media_encrypted
media_manufacturer security_result.detection_fields.value 直接映射,键 = media_manufacturer
media_type security_result.detection_fields.value 直接映射,键 = media_type
方法 security_result.detection_fields.value 直接映射,键 = methods
originsicname security_result.detection_fields.value 直接映射,键 = originsicname
来源 intermediary.ip 直接映射。
os_version principal.asset.platform_software.platform_patch_level 直接映射。
outzone security_result.detection_fields.value 直接映射,键 = outzone
parent_rule security_result.detection_fields.value 直接映射,键 = parent_rule
peer_gateway intermediary.ip 直接映射。
policy_guid security_result.detection_fields.value 直接映射,键 = policy_guid
policy_name security_result.detection_fields.value 直接映射,键 = policy_name
policy_number security_result.detection_fields.value 直接映射,键 = policy_number
policy_type security_result.detection_fields.value 直接映射,键 = policy_type
产品 additional.fields.value.string_value 直接映射,键 = product
metadata.product_name 直接映射。
product_family additional.fields.value.string_value 直接映射,键 = product_family
program_name additional.fields.value.string_value 直接映射,键 = program_name
protection_name security_result.detection_fields.value 直接映射,键 = protection_name
protection_type security_result.detection_fields.value 直接映射,键 = protection_type
reading_data_access security_result.detection_fields.value 直接映射,键 = reading_data_access
rule_action security_result.detection_fields.value 直接映射,键 = rule_action
rule_name security_result.rule_name 直接映射。
rule_uid security_result.rule_id 如果 ep_rule_id 为空,则直接映射。
s_port principal.port 直接映射。
scheme security_result.detection_fields.value 直接映射,键 = scheme
sequencenum additional.fields.value.string_value 直接映射,键 = sequencenum
服务 target.port 直接映射。
service_id security_result.detection_fields.value 直接映射,键 = service_id
session_uid network.session_id 直接映射。
src principal.ip 直接映射。
src_dns_name security_result.detection_fields.value 直接映射,键 = src_dns_name
src_machine_name security_result.detection_fields.value 直接映射,键 = src_machine_name
principal.asset.hostname 直接映射。
principal.hostname 直接映射。
src_user_dn security_result.detection_fields.value 直接映射,键 = src_user_dn
src_user_name principal.user.userid 直接映射。
principal.user.email_addresses 如果 src_user_name 字段存在且采用 userid (email) 格式,则从中提取电子邮件地址。
te_verdict_determined_by security_result.detection_fields.value 直接映射,键 = te_verdict_determined_by
时间戳 metadata.event_timestamp 直接映射。
trusted_domain security_result.detection_fields.value 直接映射,键 = trusted_domain
用户 principal.user.userid 如果 src_user_name 为空,则直接映射。
principal.user.email_addresses 如果用户字段存在且采用 userid (email) 格式,则从中提取电子邮件地址。
user_name principal.user.email_addresses 如果值是有效的电子邮件地址,则直接映射。
user_sid principal.user.windows_sid 直接映射。
判决 security_result.detection_fields.value 直接映射,键 = verdict
版本 additional.fields.value.string_value 直接映射,键 = version
vpn_feature_name security_result.detection_fields.value 直接映射,键 = vpn_feature_name
web_client_type security_result.detection_fields.value 直接映射,键 = web_client_type
metadata.log_type 此字段已硬编码为 CHECKPOINT_HARMONY
metadata.vendor_name 此字段已硬编码为 CHECKPOINT_HARMONY
principal.asset.platform_software.platform 根据 os_name 字段的值映射到 WINDOWS、MAC 或 LINUX。
network.ip_protocol 根据 proto 字段的值以及服务和 service_id 等其他字段映射到 TCP、UDP、ICMP、IP6IN4 或 GRE。
security_result.severity 根据严重程度字段的值映射到 LOW、MEDIUM、HIGH 或 CRITICAL。
metadata.event_type 如果主账号和目标账号都存在,则此字段设置为 NETWORK_CONNECTION;如果只有主账号存在,则设置为 STATUS_UNCATEGORIZED;否则设置为 GENERIC_EVENT

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