收集 Cisco APIC 日志

解析器版本： 1.0

支持的环境：

本文档介绍了如何使用 Bindplane 代理将 Cisco APIC 日志注入到 Google Security Operations 中。

解析器会从 Cisco APIC syslog 格式的日志中提取字段。它使用 grok 和/或 kv 解析日志消息，然后将这些值映射到统一数据模型 (UDM)。它还会为事件来源和类型设置默认元数据值。

准备工作

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

  • Google SecOps 实例
  • 搭载 systemd 的 Windows 2016 或更高版本或 Linux 主机
  • 如果通过代理运行，请确保防火墙端口根据 Bindplane 代理要求处于开放状态
  • 拥有对 Cisco APIC 管理控制台的特权访问权限

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

  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

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

  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: YOUR_CUSTOMER_ID
    endpoint: malachiteingestion-pa.googleapis.com
    # Specify the log type that matches your Chronicle feed configuration
    # Commonly used: CISCO_ACI or CISCO_APIC depending on your setup
    log_type: 'CISCO_APIC'
    raw_log_field: body
    ingestion_labels:

service:
  pipelines:
    logs/source0__chronicle_w_labels-0:
      receivers:
        - udplog
      exporters:
        - chronicle/chronicle_w_labels
  • 根据基础架构的需要替换端口和 IP 地址：
    • 将 YOUR_CUSTOMER_ID 替换为实际的客户 ID。
    • 将 /path/to/ingestion-authentication-file.json 更新为在第 1 步中保存身份验证文件的文件路径。
    • 确保 log_type 值与在 Google SecOps Feed 配置中选择的日志类型一致。

重启 Bindplane 代理以应用更改

  1. 如需在 Linux 中重启 Bindplane 代理，请运行以下命令：

    sudo systemctl restart observiq-otel-collector

  2. 如需在 Windows 中重启 Bindplane 代理，您可以使用服务 控制台，也可以输入以下命令：

    net stop observiq-otel-collector && net start observiq-otel-collector

在 Cisco APIC 上配置 Syslog 转发

配置管理合同（问题排查）

如果 syslog 消息未到达 Google SecOps，请验证管理访问权限配置：

  1. 登录 Cisco APIC 控制台 。
  2. 前往 Tenants > mgmt > Security Policies。
  3. 检查管理合同是否允许 UDP 端口 514：
    • 对于带外管理 > 确保 OOB 合同允许 UDP 端口 514。
    • 对于带内管理 > 确保 INB 合同允许 UDP 端口 514。
  4. 如果需要，请创建或修改过滤器，以允许所选管理 EPG 使用 UDP 端口 514。

创建 Syslog 监控目标群组

  1. 前往管理 > 外部数据收集器 > 监控目标 > Syslog。
  2. 点击 + 号以创建 Syslog 监控目标群组 。
  3. 提供以下配置详细信息：
    • 名称：输入描述性名称（例如 Google SecOps-Syslog）。
    • 说明：输入说明（例如 Syslog destination for Google Security Operations）。
    • 管理状态：选择已启用。
    • 格式：选择 aci（推荐）或 nxos。
  4. 点击下一步 。
  5. 在 Create Syslog Remote Destination 部分，提供以下配置详细信息：
    • 主机名/IP：输入 Bindplane 代理 IP 地址。
    • 名称：输入目标的描述性名称。
    • 管理状态：选择已启用。
    • 严重级别：选择信息 （或您偏好的严重级别）。
    • 端口：输入 514 （或在 Bindplane 代理上配置的端口）。
    • 管理 EPG：选择适当的管理 EPG：
      • 对于 OOB 管理，选择 default (Out-of-Band)
      • 对于带内管理，选择 inb-default
    • 转发设施：选择 local7 （或您偏好的设施）。
  6. 点击确定 。
  7. 检查配置，然后点击 Finish 。

配置 syslog 来源

配置 syslog 来源，以将不同类型的事件发送到目标群组：

配置 Fabric 政策 Syslog 来源

  1. 前往 Fabric > Fabric Policies > Monitoring Policies。
  2. 展开 default ，然后选择 Callhome/SNMP/Syslog 。
  3. 点击 + 号以创建 syslog 来源。
  4. 提供以下配置详细信息：
    • 来源名称：输入名称（例如 fabric-syslog-source）。
    • 最低严重级别：选择信息。
    • 包含：选择全选以包含审核日志、事件、故障和会话日志。
    • 目标群组：选择之前创建的 syslog 监控目标群组。
  5. 点击提交 。

配置通用政策 Syslog 来源

  1. 前往 Fabric > Fabric Policies > Monitoring Policies。
  2. 展开 common ，然后选择 Callhome/SNMP/Syslog 。
  3. 点击 + 以创建 syslog 来源。
  4. 提供以下配置详细信息：
    • 来源名称：输入名称（例如 common-syslog-source）。
    • 最低严重级别：选择信息。
    • 包含：选择全选以包含审核日志、事件、故障和会话日志。
    • 目标群组：选择之前创建的 syslog 监控目标群组。
  5. 点击提交 。

配置访问权限政策 Syslog 来源

  1. 前往 Fabric > Access Policies > Monitoring Policies。
  2. 展开 default ，然后选择 Callhome/SNMP/Syslog 。
  3. 点击 + 号以创建 syslog 来源。
  4. 提供以下配置详细信息：
    • 来源名称：输入名称（例如 access-syslog-source）。
    • 最低严重级别：选择信息。
    • 包含：选择全选以包含审核日志、事件、故障和会话日志。
    • 目标群组：选择之前创建的 syslog 监控目标群组。
  5. 点击提交 。

配置系统消息政策（可选）

  1. 前往 Fabric > Fabric Policies > Monitoring Policies。
  2. 展开 common > System Message Policies 。
  3. 选择 Policy for System Syslog Messages 。
  4. 选择 default 设施。
  5. 将严重级别 更改为信息 。
  6. 点击更新 。

UDM 映射表

日志字段 UDM 映射 逻辑
fault_cause_label additional.fields 已合并
ts metadata.event_timestamp 解析为 ISO8601
event_type metadata.event_type 直接映射
lifecycle_state metadata.product_event_type 直接映射
host principal.asset.hostname 直接映射
prin_ip principal.asset.ip 已合并
host principal.hostname 直接映射
prin_ip principal.ip 已合并
mac principal.mac 已合并
desc security_result.description 直接映射
severity_detail security_result.severity_details 直接映射
不适用 metadata.product_name 常量：CISCO APIC
不适用 metadata.vendor_name 常量：CISCO

更新日志

查看此解析器的更新日志

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