收集 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 主機 - 如果透過 Proxy 執行,請確保防火牆通訊埠已根據 Bindplane 代理程式需求開啟
- Cisco APIC 管理控制台的特殊權限
取得 Google SecOps 擷取驗證檔案
- 登入 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 安裝
- 開啟具有根層級或 sudo 權限的終端機。
執行下列指令:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
其他安裝資源
如需其他安裝選項,請參閱這份安裝指南。
設定 Bindplane 代理程式,擷取系統記錄檔並傳送至 Google SecOps
- 存取設定檔:
- 找出
config.yaml檔案。通常位於 Linux 的/etc/bindplane-agent/目錄,或 Windows 的安裝目錄。 - 使用文字編輯器 (例如
nano、vi或記事本) 開啟檔案。
- 找出
按照下列方式編輯
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 動態饋給設定中選取的記錄類型相符。
- 將
重新啟動 Bindplane 代理程式,以套用變更
如要在 Linux 中重新啟動 Bindplane 代理程式,請執行下列指令:
sudo systemctl restart observiq-otel-collector如要在 Windows 中重新啟動 Bindplane 代理程式,可以使用「服務」主控台,或輸入下列指令:
net stop observiq-otel-collector && net start observiq-otel-collector
在 Cisco APIC 上設定 Syslog 轉送
設定管理合約 (疑難排解)
如果系統記錄訊息未傳送至 Google SecOps,請檢查管理存取權設定:
- 登入 Cisco APIC 控制台。
- 依序前往「Tenants」>「mgmt」>「Security Policies」。
- 確認管理合約允許使用 UDP 通訊埠 514:
- 如要進行頻外管理 > 請確認 OOB 合約允許使用 UDP 通訊埠 514。
- 如要使用頻內管理功能,請確認 INB 合約允許使用 UDP 通訊埠 514。
- 視需要建立或修改篩選條件,允許所選管理 EPG 的 UDP 連接埠 514。
建立 Syslog 監控目的地群組
- 依序前往「管理」>「外部資料收集器」>「監控目的地」>「系統記錄」。
- 按一下「+」符號,建立 Syslog 監控目的地群組。
- 請提供下列設定詳細資料:
- 名稱:輸入描述性名稱 (例如
Google SecOps-Syslog)。 - 說明:輸入說明 (例如
Syslog destination for Google Security Operations)。 - 管理員狀態:選取「已啟用」。
- 格式:選取 aci (建議) 或 nxos。
- 名稱:輸入描述性名稱 (例如
- 點選「下一步」。
- 在「Create Syslog Remote Destination」(建立 Syslog 遠端目的地) 部分,提供下列設定詳細資料:
- 主機名稱/IP:輸入 Bindplane 代理程式 IP 位址。
- 名稱:輸入目的地的描述性名稱。
- 管理員狀態:選取「已啟用」。
- 嚴重程度:選取「資訊」 (或偏好的嚴重程度等級)。
- 連接埠:輸入 514 (或在 Bindplane 代理程式上設定的連接埠)。
- 管理電子節目表:選取適當的管理電子節目表:
- 預設 (頻外),適用於頻外管理
- In-Band 管理的 inb-default
- 轉送設施:選取 local7 (或偏好的設施)。
- 按一下 [確定]。
- 檢查設定,然後按一下「完成」。
設定系統記錄來源
設定系統記錄來源,將不同類型的事件傳送至目的地群組:
設定 Fabric 政策 Syslog 來源
- 依序前往「Fabric」>「Fabric Policies」>「Monitoring Policies」。
- 展開「default」並選取「Callhome/SNMP/Syslog」。
- 按一下「+」符號即可建立系統記錄來源。
- 請提供下列設定詳細資料:
- 來源名稱:輸入名稱 (例如
fabric-syslog-source)。 - 最低嚴重程度:選取「資訊」。
- 包含:選取「全部勾選」,即可納入稽核記錄、事件、錯誤和工作階段記錄。
- 目的地群組:選取先前建立的系統記錄監控目的地群組。
- 來源名稱:輸入名稱 (例如
- 按一下「提交」。
設定通用政策 Syslog 來源
- 依序前往「Fabric」>「Fabric Policies」>「Monitoring Policies」。
- 展開「common」,然後選取「Callhome/SNMP/Syslog」。
- 按一下「+」建立系統記錄來源。
- 請提供下列設定詳細資料:
- 來源名稱:輸入名稱 (例如
common-syslog-source)。 - 最低嚴重程度:選取「資訊」。
- 包含:選取「全部勾選」,即可納入稽核記錄、事件、錯誤和工作階段記錄。
- 目的地群組:選取先前建立的系統記錄監控目的地群組。
- 來源名稱:輸入名稱 (例如
- 按一下「提交」。
設定存取權政策 Syslog 來源
- 依序前往「Fabric」>「Access Policies」>「Monitoring Policies」。
- 展開「default」並選取「Callhome/SNMP/Syslog」。
- 按一下「+」符號即可建立系統記錄來源。
- 請提供下列設定詳細資料:
- 來源名稱:輸入名稱 (例如
access-syslog-source)。 - 最低嚴重程度:選取「資訊」。
- 包含:選取「全部勾選」,即可納入稽核記錄、事件、錯誤和工作階段記錄。
- 目的地群組:選取先前建立的系統記錄監控目的地群組。
- 來源名稱:輸入名稱 (例如
- 按一下「提交」。
設定系統訊息政策 (選用)
- 依序前往「Fabric」>「Fabric Policies」>「Monitoring Policies」。
- 展開「common」>「System Message Policies」。
- 選取「系統 Syslog 訊息政策」。
- 選取「預設」設施。
- 將「嚴重程度」變更為「資訊」。
- 按一下「Update」。
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 專業人員尋求答案。