收集 Cisco CTS 記錄

支援的國家/地區：

Google SecOps SIEM

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

Cisco TelePresence System (CTS) 是指舊版視訊會議硬體端點，包括 CTS 500、CTS 1000、CTS 1100、CTS 1300、CTS 3000、CTS 3200 和 TX 系列系統。這類沉浸式遠距呈現會議室系統提供高畫質視訊會議功能，並透過 Cisco Unified Communications Manager (CUCM) 管理。系統會針對系統作業、通話活動和疑難排解產生系統記錄訊息。

事前準備

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

Google SecOps 執行個體
Windows Server 2016 以上版本，或搭載 systemd 的 Linux 主機
Bindplane 代理程式與 Cisco TelePresence System 之間的網路連線
如果透過 Proxy 執行，請確保防火牆通訊埠已根據 Bindplane 代理程式需求開啟
Cisco Unified Communications Manager (CUCM) 的管理員存取權
Cisco TelePresence System Administration 介面的管理員存取權
從 CTS 編解碼器到 Bindplane 代理程式的網路連線 (UDP 通訊埠 514 或已設定的通訊埠)

取得 Google SecOps 擷取驗證檔案

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

注意： 這個 JSON 檔案包含驗證 Bindplane 代理程式與 Google SecOps 的憑證。

取得 Google SecOps 客戶 ID

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

注意： 設定 Bindplane 代理程式匯出工具時，必須提供客戶 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
```
3. 等待安裝完成。
4. 執行下列指令來驗證安裝：
```
sc query observiq-otel-collector
```
  服務應顯示為「RUNNING」(執行中)。

Linux 安裝

開啟具有根層級或 sudo 權限的終端機。

執行下列指令：

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

等待安裝完成。
執行下列指令來驗證安裝：
```
sudo systemctl status observiq-otel-collector
```
服務應顯示為啟用 (執行中)。

其他安裝資源

如需其他安裝選項和疑難排解資訊，請參閱 Bindplane 代理程式安裝指南。

設定 Bindplane 代理程式，擷取系統記錄檔並傳送至 Google SecOps

找出設定檔

Linux：

sudo nano /etc/bindplane-agent/config.yaml

Windows：

notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"

編輯設定檔

將 config.yaml 的所有內容替換為下列設定：

receivers:
    udplog:
        listen_address: "0.0.0.0:514"

exporters:
    chronicle/cisco_cts:
        compression: gzip
        creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
        customer_id: 'YOUR_CUSTOMER_ID'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: CISCO_CTS
        raw_log_field: body

service:
    pipelines:
        logs/cts_to_chronicle:
            receivers:
                - udplog
            exporters:
                - chronicle/cisco_cts

替換下列預留位置：
- 接收器設定：
  - 接收器使用 udplog (CTS 裝置的標準) 進行 UDP Syslog
  - listen_address 設為 0.0.0.0:514，即可監聽 UDP 通訊埠 514 的所有介面
  - 如果 Linux 系統以非根身分執行，請將通訊埠變更為 1514 以上
- 匯出工具設定：
  - creds_file_path：擷取驗證檔案的完整路徑：
    - Linux：/etc/bindplane-agent/ingestion-auth.json
    - Windows：C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
  - customer_id：將 YOUR_CUSTOMER_ID 替換為您的 customer ID。詳情請參閱「取得 Google SecOps 客戶 ID」。
  - endpoint：區域端點網址：
    - 美國：malachiteingestion-pa.googleapis.com
    - 歐洲：europe-malachiteingestion-pa.googleapis.com
    - 亞洲：asia-southeast1-malachiteingestion-pa.googleapis.com
    - 如需完整清單，請參閱「區域端點」
  - log_type：設為 CISCO_CTS (必須完全比對)

儲存設定檔

編輯完成後，請儲存檔案：

Linux：依序按下 Ctrl+O、Enter 和 Ctrl+X
Windows：依序點選「檔案」>「儲存」

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

如要在 Linux 中重新啟動 Bindplane 代理程式，請執行下列步驟：
1. 執行下列指令：
```
sudo systemctl restart observiq-otel-collector
```
2. 確認服務正在執行：
```
sudo systemctl status observiq-otel-collector
```
3. 檢查記錄中是否有錯誤：
```
sudo journalctl -u observiq-otel-collector -f
```
如要在 Windows 中重新啟動 Bindplane 代理程式，請按照下列步驟操作：
1. 您可以選擇下列其中一個選項：
  - 以管理員身分開啟命令提示字元或 PowerShell：
```
net stop observiq-otel-collector && net start observiq-otel-collector
```
  - 服務控制台：
  1. 按下 Win+R 鍵，輸入 services.msc，然後按下 Enter 鍵。
  2. 找出 observIQ OpenTelemetry Collector。
  3. 按一下滑鼠右鍵，然後選取「重新啟動」。
2. 確認服務正在執行：
```
sc query observiq-otel-collector
```
3. 檢查記錄中是否有錯誤：
```
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
```

設定 Cisco CTS 系統記錄轉送

Cisco TelePresence System (CTS) 系統記錄轉送功能是透過 Cisco Unified Communications Manager (CUCM) 設定。您必須在每個 CTS 裝置的產品專屬設定版面配置中，設定外部 Syslog 位址。

在 CUCM 中設定外部系統記錄位址

使用網路瀏覽器登入 Cisco Unified Communications Manager Administration 介面。
依序前往「裝置」>「手機」。
使用搜尋功能找出 Cisco TelePresence System 裝置。
按一下裝置名稱，開啟「手機設定」視窗。
向下捲動至「Product Specific Configuration Layout」(產品專屬設定版面配置) 區段。
找出「外部 SYSLOG 位址」欄位。
在「External SYSLOG Address」(外部 SYSLOG 位址) 欄位中，輸入下列其中一種格式的系統記錄伺服器位址：
- 僅限 IP 位址：192.168.1.100 (使用預設通訊埠 514)
- 設有通訊埠的 IP 位址：192.168.1.100:514
- 僅限主機名稱：bindplane-server.example.com (使用預設通訊埠 514)
- 含通訊埠的主機名稱：bindplane-server.example.com:1514
注意： IP 位址或主機名稱應指向 Bindplane 代理程式主機。這個通訊埠必須與 Bindplane 代理程式 config.yaml 檔案中設定的通訊埠一致 (預設為 514)。欄位長度上限為 60 個半形字元。
按一下頁面底部的「儲存」，儲存設定。
按一下「套用設定」，將變更套用至裝置。

注意： 系統會顯示訊息，指出正在套用設定。等待程序完成。
按一下「重設」或「重新啟動」，重新啟動 CTS 裝置並啟用系統記錄轉送功能。

注意： 重新啟動期間，CTS 裝置無法接聽電話。請在維護期間排定這項重新啟動作業。

在 CTS 裝置上驗證系統記錄設定

開啟網路瀏覽器，然後前往 https://<CTS-IP-ADDRESS> 的 CTS 管理介面。
使用 CUCM 中設定的 SSH 管理員使用者名稱和密碼登入。
依序前往「Configuration」>「Network Settings」。
確認「Syslog Address」欄位顯示 Bindplane 代理程式的 IP 位址或主機名稱。

注意： 這個欄位為唯讀，反映 CUCM 中設定的值。

為多部 CTS 裝置設定系統記錄

如有多部 CTS 裝置，請為每部裝置重複設定步驟：

在 CUCM 中，依序前往「Device」>「Phone」。
搜尋並選取各個 CTS 裝置。
在「Product Specific Configuration Layout」(產品專屬設定版面配置) 區段中，設定「External SYSLOG Address」(外部 SYSLOG 位址) 欄位。
儲存並套用各裝置的設定。
重新啟動每部裝置，啟用系統記錄轉送功能。

確認是否收到系統記錄訊息

查看 Bindplane 代理程式記錄，確認是否收到 Syslog 訊息：

Linux：

sudo journalctl -u observiq-otel-collector -f | grep -i cisco

Windows：

type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log" | findstr /i cisco

登入 Google SecOps 控制台。
前往「搜尋」，然後執行最近 CTS 記錄的搜尋查詢：
```
metadata.log_type = "CISCO_CTS"
```
確認搜尋結果中是否顯示記錄，且時間戳記為最近的時間。

系統記錄檔訊息格式

Cisco TelePresence System 會以 RFC 3164 (BSD syslog) 格式傳送系統記錄訊息。訊息包括：

通話活動、視訊/音訊事件和系統作業的系統管理員 (sysop) 記錄訊息
設施代碼：依訊息類型而異
預設通訊埠：UDP 514
訊息儲存空間：CTS 裝置上最多 20 個輪替記錄檔

排解系統記錄檔轉送問題

如果沒有收到系統記錄訊息，請採取下列行動：

確認 CTS 編解碼器與 Bindplane 代理程式之間的網路連線：
```
ping <BINDPLANE_AGENT_IP>
```
確認防火牆規則允許從 CTS IP 位址到 Bindplane 代理程式，透過通訊埠 514 (或設定的通訊埠) 傳輸 UDP 流量。
確認 CUCM 產品專屬設定版面配置中的外部 SYSLOG 位址設定正確無誤。
確認套用系統記錄設定後，CTS 裝置已重新啟動。
在「Troubleshooting」>「Log Files」中，檢查 CTS 管理介面記錄是否有任何與系統記錄相關的錯誤。
確認 Bindplane 代理程式正在正確的通訊埠上接聽：
- Linux：
```
sudo netstat -ulnp | grep 514
```
- Windows：
```
netstat -an | findstr :514
```

UDM 對應表

記錄欄位	UDM 對應	邏輯
AuditDetails、data2	security_result.description	如果 AuditDetails 的值不為空，則為該值，否則為 data2
ClientAddress、LoginFrom	principal.ip	如果 ClientAddress 的值不為空且不是 IP 位址，則為 LoginFrom，否則為 ClientAddress
EventType	metadata.product_event_type	直接複製值
logType	metadata.description	直接複製值
嚴重性	security_result.severity	如果嚴重程度介於 [6,7]，請設為「INFORMATIONAL」；如果為 5，請設為「LOW」；如果為 4，請設為「MEDIUM」；如果為 3，請設為「ERROR」；如果為 2，請設為「HIGH」；否則請設為「CRITICAL」
logType、EventStatus	security_result.action	如果 logType == AuthenticationSucceeded 或 EventStatus == Success，則設為 ALLOW
EventType、logType	metadata.event_type	如果 EventType == UserAccess，則設為 USER_RESOURCE_ACCESS；如果 EventType == UserLogging 或 logType 符合 LOGIN，則設為 USER_LOGIN；如果 EventType 位於 [UserRoleMembershipUpdate, GeneralConfigurationUpdate]，則設為 USER_RESOURCE_UPDATE_CONTENT；否則設為 GENERIC_EVENT
AppID	principal.application	直接複製值
NodeID	target.hostname	直接複製值
process_id	principal.process.pid	直接複製值
ResourceAccessed	target.resource.name	直接複製值
UserID	principal.user.userid	直接複製值
	metadata.product_name	設為「CISCO_CTS」
	metadata.vendor_name	設為「CISCO」

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