收集 Cisco APIC 記錄

剖析器版本:1.0

支援的國家/地區:

本文說明如何使用 Bindplane 代理程式,將 Cisco APIC 記錄擷取至 Google Security Operations。

剖析器會從 Cisco APIC syslog 格式的記錄檔中擷取欄位。它會使用 grok 和/或 kv 剖析記錄訊息,然後將這些值對應至統合式資料模型 (UDM)。此外,也會為事件來源和類型設定預設中繼資料值。

事前準備

請確認您已完成下列事前準備事項:

  • Google SecOps 執行個體
  • 搭載 systemd 的 Windows 2016 以上版本或 Linux 主機
  • 如果透過 Proxy 執行,請確保防火牆通訊埠已根據 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. 開啟具有根層級或 sudo 權限的終端機。
  2. 執行下列指令:

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

其他安裝資源

如需其他安裝選項,請參閱這份安裝指南

設定 Bindplane 代理程式,擷取系統記錄檔並傳送至 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: 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 代理程式,以套用變更

  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 轉送

設定管理合約 (疑難排解)

如果系統記錄訊息未傳送至 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. 依序前往「管理」>「外部資料收集器」>「監控目的地」>「系統記錄」
  2. 按一下「+」符號,建立 Syslog 監控目的地群組
  3. 請提供下列設定詳細資料:
    • 名稱:輸入描述性名稱 (例如 Google SecOps-Syslog)。
    • 說明:輸入說明 (例如 Syslog destination for Google Security Operations)。
    • 管理員狀態:選取「已啟用」
    • 格式:選取 aci (建議) 或 nxos
  4. 點選「下一步」
  5. 在「Create Syslog Remote Destination」(建立 Syslog 遠端目的地) 部分,提供下列設定詳細資料:
    • 主機名稱/IP:輸入 Bindplane 代理程式 IP 位址。
    • 名稱:輸入目的地的描述性名稱。
    • 管理員狀態:選取「已啟用」
    • 嚴重程度:選取「資訊」 (或偏好的嚴重程度等級)。
    • 連接埠:輸入 514 (或在 Bindplane 代理程式上設定的連接埠)。
    • 管理電子節目表:選取適當的管理電子節目表:
      • 預設 (頻外),適用於頻外管理
      • In-Band 管理的 inb-default
    • 轉送設施:選取 local7 (或偏好的設施)。
  6. 按一下 [確定]
  7. 檢查設定,然後按一下「完成」

設定系統記錄來源

設定系統記錄來源,將不同類型的事件傳送至目的地群組:

設定 Fabric 政策 Syslog 來源

  1. 依序前往「Fabric」>「Fabric Policies」>「Monitoring Policies」
  2. 展開「default」並選取「Callhome/SNMP/Syslog」
  3. 按一下「+」符號即可建立系統記錄來源。
  4. 請提供下列設定詳細資料:
    • 來源名稱:輸入名稱 (例如 fabric-syslog-source)。
    • 最低嚴重程度:選取「資訊」
    • 包含:選取「全部勾選」,即可納入稽核記錄、事件、錯誤和工作階段記錄。
    • 目的地群組:選取先前建立的系統記錄監控目的地群組。
  5. 按一下「提交」

設定通用政策 Syslog 來源

  1. 依序前往「Fabric」>「Fabric Policies」>「Monitoring Policies」
  2. 展開「common」,然後選取「Callhome/SNMP/Syslog」
  3. 按一下「+」建立系統記錄來源。
  4. 請提供下列設定詳細資料:
    • 來源名稱:輸入名稱 (例如 common-syslog-source)。
    • 最低嚴重程度:選取「資訊」
    • 包含:選取「全部勾選」,即可納入稽核記錄、事件、錯誤和工作階段記錄。
    • 目的地群組:選取先前建立的系統記錄監控目的地群組。
  5. 按一下「提交」

設定存取權政策 Syslog 來源

  1. 依序前往「Fabric」>「Access Policies」>「Monitoring Policies」
  2. 展開「default」並選取「Callhome/SNMP/Syslog」
  3. 按一下「+」符號即可建立系統記錄來源。
  4. 請提供下列設定詳細資料:
    • 來源名稱:輸入名稱 (例如 access-syslog-source)。
    • 最低嚴重程度:選取「資訊」
    • 包含:選取「全部勾選」,即可納入稽核記錄、事件、錯誤和工作階段記錄。
    • 目的地群組:選取先前建立的系統記錄監控目的地群組。
  5. 按一下「提交」

設定系統訊息政策 (選用)

  1. 依序前往「Fabric」>「Fabric Policies」>「Monitoring Policies」
  2. 展開「common」>「System Message Policies」
  3. 選取「系統 Syslog 訊息政策」
  4. 選取「預設」設施。
  5. 將「嚴重程度」變更為「資訊」
  6. 按一下「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 專業人員尋求答案。