收集 Cambium Networks 記錄

支援的國家/地區：

本文說明如何使用 Bindplane，將 Cambium Networks 記錄擷取至 Google Security Operations。剖析器會從 Cambium Networks 交換器和路由器系統記錄訊息中擷取鍵/值組合，並將其對應至統合式資料模型 (UDM)。這項規則會使用 Grok 建立初始訊息結構、使用 KV 分隔鍵/值組合，並使用條件陳述式將擷取的欄位對應至特定 UDM 屬性，將事件分類為「STATUS_UPDATE」或「GENERIC_EVENT」。

事前準備

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

  • Google SecOps 執行個體
  • Windows 2016 以上版本，或搭載 systemd 的 Linux 主機
  • 如果透過 Proxy 執行，防火牆通訊埠已開啟
  • Cambium Networks 裝置的特殊存取權

取得 Google SecOps 擷取驗證檔案

  1. 登入 Google SecOps 控制台。
  2. 依序前往「SIEM 設定」>「收集代理程式」。
  3. 下載擷取驗證檔案。將檔案安全地儲存在要安裝 Bindplane 的系統上。

取得 Google SecOps 客戶 ID

  1. 登入 Google SecOps 控制台。
  2. 依序前往「SIEM 設定」>「設定檔」。
  3. 複製並儲存「機構詳細資料」專區中的客戶 ID。

安裝 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 的安裝目錄。
    • 使用文字編輯器 (例如 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: '/path/to/ingestion-authentication-file.json'
        # Replace with your actual customer ID from Step 2
        customer_id: <customer_id>
        endpoint: malachiteingestion-pa.googleapis.com
        # Add optional ingestion labels for better organization
        ingestion_labels:
            log_type: 'CAMBIUM_NETWORKS'
            raw_log_field: body

service:
    pipelines:
        logs/source0__chronicle_w_labels-0:
            receivers:
                - udplog
            exporters:
                - chronicle/chronicle_w_labels

  3. 視基礎架構需求，替換通訊埠和 IP 位址。

  4. 將 <customer_id> 替換為實際的客戶 ID。

  5. 將 /path/to/ingestion-authentication-file.json 更新為「取得 Google SecOps 擷取驗證檔案」一節中驗證檔案的儲存路徑。

重新啟動 Bindplane 代理程式，以套用變更

  • 如要在 Linux 中重新啟動 Bindplane 代理程式，請執行下列指令：

    sudo systemctl restart bindplane-agent

  • 如要在 Windows 中重新啟動 Bindplane 代理程式，可以使用「服務」控制台，或輸入下列指令：

    net stop BindPlaneAgent && net start BindPlaneAgent

在 ePMP 1000/2000/Force 180/200 和 ePMP Elevate 上設定 Syslog

  1. 登入 Cambium Networks GUI。
  2. 依序前往「Configure」>「System」>「Syslog Logging」。
  3. 提供下列設定詳細資料：
    • 系統記錄遮罩：按一下「全選」。
    • 伺服器 1：輸入 Bindplane 代理程式 IP 位址。
  4. 按一下 [儲存]。

在 ePMP 1000 HS 和 cnPilot E400/E500/E501 上設定系統記錄

  1. 登入 Cambium Networks GUI。
  2. 依序前往「設定」>「系統」>「事件記錄」。
  3. 提供下列設定詳細資料：
    • Syslog 伺服器 1：輸入 Bindplane 代理程式 IP 位址。
  4. 按一下 [儲存]。

  5. 使用 SSH 登入裝置 CLI，然後輸入下列指令來啟用偵錯層級：

    logging  cnmaestro  7

  6. 儲存並套用設定。

  7. 輸入下列指令，從 CLI 驗證裝置代理程式記錄：

    service show debug-logs device-agent

在 cnPilot R200/R201/R190 上設定 Syslog

  1. 登入 Cambium Networks GUI。
  2. 依序前往「管理」>「管理」>「系統記錄設定」。
  3. 提供下列設定詳細資料：
    • 啟用系統記錄：選取「啟用」。
    • 系統記錄層級：選取「INFO」。
    • 啟用遠端系統記錄檔：選取「啟用」。
    • 遠端系統記錄檔伺服器：輸入 Bindplane 代理程式 IP 位址。
  4. 按一下 [儲存]。

在 PMP 450/450i/450m AP 上設定 Syslog

  1. 登入 Cambium Networks GUI。
  2. 依序前往「Configuration」> cnMaestro。
  3. 提供下列設定詳細資料：
    • cnMaestro Agent Debug Log Level：選取「INFO」。
  4. 依序前往「設定」> Syslog。
  5. 提供下列設定詳細資料：
    • Syslog DNS Server Usage：選取「Disable DNS Domain Name」(停用 DNS 網域名稱)。
    • 系統記錄伺服器：輸入 Bindplane 代理程式 IP 位址。
    • 「Syslog Server Port」(系統記錄伺服器通訊埠)：輸入 Bindplane 代理程式通訊埠編號。
    • AP Syslog Transmit：選取「Enabled」。
    • SM Syslog Transmit：選取「Enabled」。
    • 系統記錄檔最低層級：選取「資訊」。
  6. 按一下 [儲存]。

在 PMP 450/450i/450m SM 上設定 Syslog

  1. 登入 Cambium Networks GUI。
  2. 依序前往「Configuration」> cnMaestro。
  3. 提供下列設定詳細資料：
    • cnMaestro Agent Debug Log Level：選取「INFO」。
  4. 依序前往「設定」> Syslog。
  5. 提供下列設定詳細資料：
    • Syslog Configuration Source：選取「AP Preferred」。
    • Syslog DNS Server Usage：選取「Disable DNS Domain Name」(停用 DNS 網域名稱)。
    • 系統記錄伺服器：輸入 Bindplane 代理程式 IP 位址。
    • 「Syslog Server Port」(系統記錄伺服器通訊埠)：輸入 Bindplane 代理程式通訊埠編號。
    • Syslog 傳輸：選取「從 AP 取得」。
    • 系統記錄檔最低層級來源：選取「AP Preferred」(存取點偏好)。
    • 系統記錄檔最低層級：選取「資訊」。
  6. 按一下 [儲存]。

UDM 對應表

記錄欄位 UDM 對應 邏輯
bssid read_only_udm.principal.mac 使用金鑰 bssid 從 kv_fields 擷取。
頻道 read_only_udm.security_result.about.resource.attribute.labels.value 使用金鑰 channel 從 kv_fields 擷取。標籤的一部分。
host_name read_only_udm.principal.hostname 使用 grok 模式從記錄訊息中擷取。
ids_event read_only_udm.security_result.summary 使用金鑰 ids_event 從 kv_fields 擷取。
ids_status read_only_udm.security_result.description 使用金鑰 ids_status 從 kv_fields 擷取。如果存在，則會做為說明使用。
iap read_only_udm.security_result.about.resource.attribute.labels.value 使用金鑰 iap 從 kv_fields 擷取。標籤的一部分。
製造商 read_only_udm.security_result.about.resource.attribute.labels.value 使用金鑰 manufacturer 從 kv_fields 擷取。標籤的一部分。
rssi read_only_udm.security_result.about.resource.attribute.labels.value 使用金鑰 rssi 從 kv_fields 擷取。標籤的一部分。
安全性 read_only_udm.security_result.about.resource.attribute.labels.value 使用金鑰 security 從 kv_fields 擷取。標籤的一部分。
嚴重性 read_only_udm.security_result.severity 使用 grok 模式從記錄訊息對應。alert 會對應到 HIGH，warn 會對應到 MEDIUM，其他所有內容都會對應到 LOW。
嚴重性 read_only_udm.security_result.severity_details 使用 grok 模式從記錄訊息對應。保留原始嚴重程度值。
ssid read_only_udm.principal.application 使用金鑰 ssid 從 kv_fields 擷取。
時間戳記 read_only_udm.metadata.event_timestamp 使用 grok 模式從記錄訊息中擷取，並轉換為時間戳記。
read_only_udm.metadata.event_type 系統會根據 security_result 和 host_name 欄位中是否有值來判斷。如果兩個欄位都存在，事件類型會設為 STATUS_UPDATE，否則會設為 GENERIC_EVENT。
read_only_udm.security_result.about.resource.attribute.labels.key 這個欄位的值是由剖析器邏輯根據處理中的特定鍵/值組合決定。可能的值為：Internet_Access_Provider、manufacturer、channel、received_signal_strength_indicator 和 encryption_standard。
read_only_udm.security_result.description 如果嚴重程度為 warn，這個欄位會採用 kv_fields 的值，否則會採用 ids_status 的值。

還有其他問題嗎？向社群成員和 Google SecOps 專業人員尋求答案。