收集 BlueCat DDI 日志

解析器版本：1.0

支持的平台：

本文档介绍了如何使用 Bindplane 将 BlueCat DDI 日志注入到 Google Security Operations。BlueCat DDI 是一种集成的 DNS、DHCP 和 IP 地址管理 (IPAM) 解决方案，可集中管理和自动执行核心网络服务。它可帮助组织在复杂的企业环境中管理 DNS 区域、DHCP 范围和 IP 地址分配。

准备工作

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

  • Google SecOps 实例。
  • 搭载 systemd 的 Windows 2016 或更高版本或 Linux 主机。
  • 如果在代理后面运行，请确保防火墙端口已根据 Bindplane 代理要求打开。
  • 对 BlueCat Address Manager 管理控制台的特权访问权限。

获取 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 上的 /observiq-otel-collector/ 目录中或 Windows 上的安装目录中。
    • 使用文本编辑器（例如 nano、vi 或记事本）打开该文件。

  2. 按如下方式修改 config.yaml 文件：

    receivers:
    udplog:
        listen_address: "0.0.0.0:514"

exporters:
    chronicle/bluecat_ddi:
        compression: gzip
        creds_file_path: '/path/to/ingestion-authentication-file.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: BLUECAT_DDI
        raw_log_field: body
        ingestion_labels:

service:
    pipelines:
        logs/bluecat_ddi:
            receivers:
                - udplog
            exporters:
                - chronicle/bluecat_ddi
  • 根据基础架构的需要替换端口和 IP 地址。
  • 将 <customer_id> 替换为实际的客户 ID。
  • 将 /path/to/ingestion-authentication-file.json 更新为获取 Google SecOps 注入身份验证文件部分中保存身份验证文件的路径。

重启 Bindplane 代理以应用更改

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

  1. 运行以下命令：

    sudo systemctl restart observiq-otel-collector

  2. 验证服务是否正在运行：

    sudo systemctl status observiq-otel-collector

  3. 检查日志是否存在错误：

    sudo journalctl -u observiq-otel-collector -f

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

  1. 请从下列选项中选择一项：

    • 以管理员身份运行命令提示符或 PowerShell：
    net stop observiq-otel-collector && net start observiq-otel-collector
    • 服务控制台：
      1. 按 Win+R，输入 services.msc，然后按 Enter 键。
      2. 找到 observIQ OpenTelemetry 收集器。
      3. 右键点击并选择重新启动。

  2. 验证服务是否正在运行：

    sc query observiq-otel-collector

  3. 检查日志是否存在错误：

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

配置 BlueCat DDI syslog 转发

在 BlueCat Address Manager 上配置 syslog

  1. 登录 BlueCat Address Manager 网页界面。
  2. 从配置下拉菜单中，选择一种配置。
  3. 选择服务器标签页。
  4. 在 Servers（服务器）下，点击要配置的 BDDS（BlueCat DNS/DHCP 服务器）的名称。
  5. 点击 Syslog 标签页。
  6. 在 Syslog 下，点击 New。
  7. 提供以下配置详细信息：
    • 服务器地址：输入 Bindplane 代理主机（例如 192.168.1.100）的 IP 地址。
    • 端口：输入 514（或您配置的 Bindplane 代理端口）。
    • 传输：选择 UDP。
  8. 点击添加以保存 syslog 重定向条目。
  9. 点击 Deploy 以将更新后的配置推送到 BDDS 设备。

通过 CLI 在 BlueCat DNS/DHCP 服务器 (BDDS) 上配置 syslog

如果您希望直接在 BDDS 设备上配置 syslog 转发，而不是通过 Address Manager 进行配置，请执行以下操作：

  1. 通过 SSH 连接到 BDDS 设备。
  2. 使用管理员凭据登录。

  3. 修改 syslog-ng 配置文件：

    sudo vi /etc/syslog-ng/syslog-ng.conf

  4. 添加以下目标位置和日志语句：

    destination d_bindplane {
    udp("<BINDPLANE_IP>" port(514));
};

log {
    source(s_local);
    destination(d_bindplane);
};

  5. 将 <BINDPLANE_IP> 替换为 Bindplane 代理主机 IP 地址。

  6. 保存文件并重启 syslog-ng 服务：

    sudo systemctl restart syslog-ng

  7. 通过检查 Bindplane 代理日志，验证日志是否正在转发。

UDM 映射表

日志字段 UDM 映射 逻辑
auth_mechanism extensions.auth.mechanism 已合并
log_type extensions.auth.mechanism 已映射：systemd → auth_mechanism
log_type extensions.auth.type 已映射：CRON → AUTHTYPE_UNSPECIFIED，audit → AUTHTYPE_UNSPECIFIED
log_type intermediary 已映射：named → intermediary
relay_ip intermediary.ip 已合并
description metadata.description 已重命名/已映射
inner_message metadata.description 直接映射
kv.cat metadata.description 直接映射
msg metadata.description 直接映射
ts metadata.event_timestamp 解析为 MMM d HH:mm:ss
ts_date metadata.event_timestamp 解析为 MMM d HH:mm:ss
ts_timestamp metadata.event_timestamp 解析为 yyyy-MM-dd HH:mm:ss
has_principal metadata.event_type 已映射：true → NETWORK_CONNECTION
log_type metadata.event_type 映射的值（总共 15 个，例如 named → USER_UNCATEGORIZED、named → NETWORK_DNS、`dhcp...
message metadata.event_type 已映射：session closed → USER_LOGOUT
operation_type metadata.event_type 已映射：view → USER_UNCATEGORIZED
csv.event_id metadata.product_event_type 直接映射
log_type network.application_protocol 已映射：named → DNS，dhcpd → DHCP
client_mac network.dhcp.chaddr 直接映射
client_ip network.dhcp.ciaddr 直接映射
src_ip network.dhcp.ciaddr 直接映射
relay_ip network.dhcp.giaddr 直接映射
log_type network.dhcp.opcode 已映射：dhcpd → BOOTREQUEST、dhcpd → BOOTREPLY
message_type network.dhcp.opcode 映射的值（共 7 个，例如 DHCPDISCOVER → BOOTREQUEST、"DHCPREQUEST", "BOOTREQUEST" ...
src_ip network.dhcp.siaddr 直接映射
server_host network.dhcp.sname 已重命名/已映射
log_type network.dhcp.type 映射的值（总共 7 个，例如 dhcpd → DISCOVER、dhcpd → REQUEST、dhcpd → OFFER）
message_type network.dhcp.type 映射值（共 7 个，例如 DHCPDISCOVER → DISCOVER、"DHCPREQUEST", "BOOTREQUEST" → `...
src_ip network.dhcp.yiaddr 直接映射
log_type network.dns.answers 已映射：named → response
response network.dns.answers 已合并
log_type network.dns.questions 已映射：named → query
query network.dns.questions 已合并
question network.dns.questions 已合并
ses network.session_id 直接映射
hostname principal.hostname 直接映射
server_host principal.hostname 直接映射
kv.src principal.ip 已合并
log_type principal.ip 映射：named → src_ip、dhcpd → src_ip、syslog-ng → src_ip
src_ip principal.ip 已合并
client_mac principal.mac 已合并
log_type principal.mac 已映射：dhcpd → client_mac
message_type principal.mac 映射：DHCPDISCOVER → client_mac、"DHCPREQUEST", "BOOTREQUEST" → client_mac、`DHCPR...
src_port principal.port 已重命名/已映射
acct principal.user.userid 直接映射
src_user principal.user.userid 直接映射
application target.application 直接映射
terminal target.application 直接映射
file_path target.file.full_path 直接映射
server_host target.hostname 直接映射
target_host target.hostname 直接映射
log_type target.ip 映射：named → target_ip、dhcpd → target_ip、syslog-ng → target_ip
server_ip target.ip 已合并
target_ip target.ip 已合并
client_mac target.mac 已合并
log_type target.mac 已映射：dhcpd → client_mac
message_type target.mac 映射："DHCPOFFER", "BOOTREPLY" → client_mac、DHCPACK → client_mac、DHCPNAK → `cl...
tgt_port target.port 已重命名/已映射
cmd target.process.command_line 直接映射
exe target.process.command_line 直接映射
file_path target.process.file.full_path 直接映射
pid target.process.pid 直接映射
不适用 extensions.auth.type 常量：AUTHTYPE_UNSPECIFIED
不适用 metadata.event_type 常量：USER_UNCATEGORIZED
不适用 metadata.product_name 常量：Bluecat DDI
不适用 metadata.vendor_name 常量：Bluecat Networks
不适用 network.application_protocol 常量：DNS
不适用 network.dhcp.opcode 常量：BOOTREQUEST
不适用 network.dhcp.type 常量：DISCOVER

更新日志

查看相应解析器的更改日志

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