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

收集 Cisco APIC 日志

解析器版本： 1.0

支持：

Google SecOps SIEM

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

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

准备工作

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

Google SecOps 实例
具有 systemd 的 Windows 2016 或更高版本或 Linux 主机
如果通过代理运行，请确保防火墙端口符合 Bindplane 代理要求
对 Cisco APIC 管理控制台的特权访问权限

获取 Bindplane 代理的 Google SecOps 凭据

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

新部署：使用 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 编辑器 。
点击继续，然后点击完成。
点击您创建的服务帐号，然后前往密钥标签页。
依次点击添加密钥 > 创建新密钥。
选择 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 代理

按照以下说明在 Windows 或 Linux 操作系统上安装 Bindplane 代理。

Windows 安装

以管理员身份打开命令提示符 或 PowerShell 。

运行以下命令：

msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet

Linux 安装

使用 root 或 sudo 权限打开终端。

运行以下命令：

sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh

其他安装资源

如需了解其他安装选项，请参阅此安装指南。

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

访问配置文件：
- 找到 config.yaml 文件。通常，该文件位于 Linux 上的 /opt/observiq-otel-collector/ 目录或 Windows 上的安装目录中。
- 使用文本编辑器（例如 nano、vi 或记事本）打开该文件。
按如下方式修改 config.yaml 文件： yaml receivers: udplog: # Replace the port and IP address as required listen_address: "0.0.0.0:514" exporters: chronicle/chronicle_w_labels: 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 # 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: chronicle.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 地址：
- 将 <LOCATION> 替换为 Google SecOps 实例的区域（例如 us、europe 或 asia-southeast1）。导出器会使用此值为 chronicle.googleapis.com 添加前缀。
- 将 <PROJECT_NUMBER> 替换为 IAM 和管理 > 设置 中的项目编号。
- 将 YOUR_CUSTOMER_ID 替换为实际的客户 ID。
- 将 /path/to/ingestion-authentication-file.json 更新为在第 1 步中保存服务帐号密钥文件（方法 1）的文件路径。
- 确保 log_type 值与在 Google SecOps Feed 配置中选择的日志类型匹配。

旧版注入 API 导出器

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

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:

重启 Bindplane 代理以应用更改

如需在 Linux 中重启 Bindplane 代理，请运行以下命令：
```
sudo systemctl restart observiq-otel-collector
```
如需在 Windows 中重启 Bindplane 代理，您可以使用服务控制台，也可以输入以下命令：
```
net stop observiq-otel-collector && net start observiq-otel-collector
```

在 Cisco APIC 上配置 Syslog 转发

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

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

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

创建 Syslog 监控目标组

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

配置 Syslog 来源

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

配置 Fabric 政策 Syslog 来源

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

配置通用政策 Syslog 来源

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

配置访问权限政策 Syslog 来源

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

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

依次前往 Fabric > Fabric 政策 > 监控政策。
展开 common > System Message Policies 。
选择 Policy for System Syslog Messages 。
选择 default 设施。
将严重级别 更改为信息。
点击更新。

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`

更新日志

查看此解析器的更新日志