收集 Nokia 路由器記錄
本文說明如何使用 Bindplane 代理程式,將 Nokia 路由器記錄擷取至 Google Security Operations。
Nokia 服務路由器是一種網路路由器,會針對 BGP 事件、介面狀態變更、MKA 工作階段、LLDP 鄰近探索、IS-IS 路由和安全篩選器比對,產生系統記錄訊息。剖析器會使用 Grok 模式從 Syslog 格式的記錄檔中擷取欄位,並將這些欄位對應至統合式資料模型 (UDM)。
事前準備
請確認您已完成下列事前準備事項:
- Google SecOps 執行個體
- Windows Server 2016 以上版本,或搭載
systemd的 Linux 主機 - Bindplane 代理程式與 Nokia 服務路由器之間的網路連線
- 如果透過 Proxy 執行,請確保防火牆通訊埠已根據 Bindplane 代理程式需求開啟
- Nokia 路由器特殊存取權
取得 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等待安裝完成。
執行下列指令,確認安裝成功:
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 /opt/observiq-otel-collector/config.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
編輯設定檔
將
config.yaml的所有內容替換為下列設定:receivers: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/nokia_router: compression: gzip creds_file_path: '/etc/bindplane-agent/ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: NOKIA_ROUTER raw_log_field: body service: pipelines: logs/nokia_router_to_chronicle: receivers: - udplog exporters: - chronicle/nokia_router
設定參數
替換下列預留位置:
接收器設定:
listen_address:要接聽的 IP 位址和通訊埠:0.0.0.0,監聽所有介面 (建議)- 通訊埠
514是標準的系統記錄通訊埠 (在 Linux 上需要根層級權限;非根層級權限請使用1514)
匯出工具設定:
creds_file_path:擷取驗證檔案的完整路徑:- Linux:
/etc/bindplane-agent/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
customer_id:從 Google SecOps 控制台複製的客戶 IDendpoint:區域端點網址:- 美國:
malachiteingestion-pa.googleapis.com - 歐洲:
europe-malachiteingestion-pa.googleapis.com - 亞洲:
asia-southeast1-malachiteingestion-pa.googleapis.com - 如需完整清單,請參閱「區域端點」
- 美國:
儲存設定檔
- 編輯完成後,請儲存檔案:
- Linux:依序按下
Ctrl+O、Enter和Ctrl+X - Windows:依序點選「檔案」>「儲存」
- Linux:依序按下
重新啟動 Bindplane 代理程式,以套用變更
如要在 Linux 中重新啟動 Bindplane 代理程式,請執行下列指令:
sudo systemctl restart observiq-otel-collector確認服務正在執行:
sudo systemctl status observiq-otel-collector檢查記錄中是否有錯誤:
sudo journalctl -u observiq-otel-collector -f
如要在 Windows 中重新啟動 Bindplane 代理程式,請選擇下列其中一個選項:
以管理員身分開啟命令提示字元或 PowerShell:
net stop observiq-otel-collector && net start observiq-otel-collector服務控制台:
- 按下
Win+R,輸入services.msc,然後按下 Enter 鍵。 - 找出 observIQ OpenTelemetry Collector。
- 按一下滑鼠右鍵,然後選取「重新啟動」。
確認服務正在執行:
sc query observiq-otel-collector檢查記錄中是否有錯誤:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
- 按下
在 Nokia 服務路由器上設定系統記錄
進入設定模式:
config# log定義系統記錄目的地:
config>log# syslog 1設定系統記錄參數:
config>log>syslog# address <syslog-server-ip> config>log>syslog# port <port-number> config>log>syslog# facility local0 config>log>syslog# level info config>log>syslog# log-prefix "Nokia-SR" config>log>syslog# description "Syslog to Bindplane"- 將
<syslog-server-ip>替換為 Bindplane 代理程式 IP 位址,並將<port-number>替換為適當的通訊埠 (例如 UDP 的514)。
- 將
將系統記錄目的地套用至記錄檔:
config>log# log-id 1 config>log>log-id# to syslog 1啟用記錄檔:
config>log>log-id# no shutdown儲存設定:
config>log>log-id# exit config>log# save
UDM 對應表
| 記錄欄位 | UDM 對應 | 邏輯 |
|---|---|---|
%{SYSLOGTIMESTAMP:date_time} |
metadata.event_timestamp |
從原始記錄擷取並轉換為時間戳記。 |
%{IP:src_ip} |
principal.ip |
從原始記錄中擷取。 |
%{HOSTNAME:host_name} |
principal.hostname |
從原始記錄中擷取。 |
%{INT:sequence_id} |
metadata.product_log_id |
從原始記錄中擷取。 |
%{DATA:router_name} |
metadata.product_name |
從原始記錄中擷取。 |
%{DATA:application} |
target.application |
從原始記錄中擷取。 |
%{WORD:severity} |
security_result.severity |
根據下列邏輯從原始記錄嚴重程度對應而來: - CLEARED、INFO -> INFORMATIONAL - MINOR -> ERROR - WARNING -> LOW - MAJOR -> HIGH - CRITICAL -> CRITICAL |
%{DATA:event_name} |
metadata.product_event_type |
從原始記錄中擷取。 |
%{INT:event_id} |
additional.fields.value.string_value |
從原始記錄檔擷取,並放置在 additional fields 中,金鑰為 Event Id。 |
%{GREEDYDATA:message1} |
用於根據 event_name 擷取各種欄位。請參閱下方特定欄位的邏輯。 |
|
Group %{NOTSPACE:group_id} |
target.group.product_object_id |
如果 event_name 與 BGP 事件相關,則會從 message1 中擷取。 |
%{WORD} %{IP:dest_ip} |
target.ip |
如果 event_name 與 BGP 事件相關,則會從 message1 中擷取。 |
%{GREEDYDATA:desc} |
security_result.description |
從 message1 擷取,適用於各種 event_name 情境。 |
SAP %{DATA:sap_id} |
additional.fields.value.string_value |
從 message1 中擷取,當 event_name 為 sapStatusChanged 時,會放置在 additional fields 中,並使用 SAP Id 金鑰。 |
in service %{INT:service_id} |
additional.fields.value.string_value |
從 message1 中擷取,當 event_name 為 sapStatusChanged 時,會放置在 additional fields 中,並使用 Service Id 金鑰。 |
\\(customer %{INT:customer_id}\\) |
additional.fields.value.string_value |
從 message1 中擷取,當 event_name 為 sapStatusChanged 時,會放置在 additional fields 中,並使用 Customer Id 金鑰。 |
admin=%{WORD:admin_status} |
additional.fields.value.string_value |
從 message1 中擷取,當 event_name 為 sapStatusChanged 時,會放置在 additional fields 中,並使用 Admin Status 金鑰。 |
oper=%{WORD:operation_status} |
additional.fields.value.string_value |
從 message1 中擷取,當 event_name 為 sapStatusChanged 時,會放置在 additional fields 中,並使用 Operation Status 金鑰。 |
flags=%{WORD:flag} |
additional.fields.value.string_value |
從 message1 中擷取,當 event_name 為 sapStatusChanged 時,會放置在 additional fields 中,並使用 Flag 金鑰。 |
with MI:SCI %{DATA:mi_sci} |
additional.fields.value.string_value |
從 message1 中擷取,當 event_name 為 tmnxMkaSessionEstablished 時,會放置在 additional fields 中,並使用 MI:SCI 金鑰。 |
on port %{DATA:port_id} |
additional.fields.value.string_value |
從 message1 中擷取,當 event_name 為 tmnxMkaSessionEstablished 時,會放置在 additional fields 中,並使用 Port Id 金鑰。 |
sub-port %{INT:sub_port_id} |
additional.fields.value.string_value |
從 message1 中擷取,當 event_name 為 tmnxMkaSessionEstablished 時,會放置在 additional fields 中,並使用 Sub-port Id 金鑰。 |
CA %{INT:ca} |
additional.fields.value.string_value |
從 message1 中擷取,當 event_name 為 tmnxMkaSessionEstablished 時,會放置在 additional fields 中,並使用 CA 金鑰。 |
EAPOL-destination %{MAC:dest_mac} |
target.mac |
當 event_name 為 tmnxMkaSessionEstablished 時,從 message1 擷取。 |
local port-id %{DATA:local_port_id} |
target.resource.attribute.labels.value |
從 message1 擷取特定 event_name 值,並以索引鍵 local_port_id 放置在 target.resource.attribute.labels 中。 |
dest-mac-type %{NOTSPACE:mac_type} |
target.resource.attribute.labels.value |
從 message1 擷取特定 event_name 值,並以索引鍵 mac_type 放置在 target.resource.attribute.labels 中。 |
remote system name %{HOSTNAME:dest_host} |
target.hostname |
從 message1 擷取特定 event_name 值。 |
remote chassis-id %{DATA:dest_mac} |
target.mac |
從 message1 擷取特定 event_name 值。 |
remote port-id %{DATA:port_id} |
target.resource.attribute.labels.value |
從 message1 擷取特定 event_name 值,並以索引鍵 port_id 放置在 target.resource.attribute.labels 中。 |
remote-index %{INT:remote_index} |
target.resource.attribute.labels.value |
從 message1 擷取特定 event_name 值,並以索引鍵 remote_index 放置在 target.resource.attribute.labels 中。 |
remote management address %{IP:dest_ip} |
target.ip |
從 message1 擷取特定 event_name 值。 |
advRtr:%{HOSTNAME:dest_host}%{GREEDYDATA}, ip@:%{IP:dest_ip}/%{INT:dest_port} |
target.hostname、target.ip、target.port |
從 message1 擷取特定 event_name 值。 |
SID:%{INT:sid} |
network.session_id |
從 message1 擷取特定 event_name 值。 |
level:%{DATA:level} |
target.resource.attribute.labels.value |
從 message1 擷取特定 event_name 值,並以索引鍵 level 放置在 target.resource.attribute.labels 中。 |
mtid:%{INT:mtid} |
target.resource.attribute.labels.value |
從 message1 擷取特定 event_name 值,並以索引鍵 mtid 放置在 target.resource.attribute.labels 中。 |
type:%{WORD:type} |
target.resource.attribute.labels.value |
從 message1 擷取特定 event_name 值,並以索引鍵 type 放置在 target.resource.attribute.labels 中。 |
flags:%{WORD:flag} |
target.resource.attribute.labels.value |
從 message1 擷取特定 event_name 值,並以索引鍵 flag 放置在 target.resource.attribute.labels 中。 |
, algo:%{INT:algo} |
target.resource.attribute.labels.value |
從 message1 擷取特定 event_name 值,並以索引鍵 algo 放置在 target.resource.attribute.labels 中。 |
Description:%{GREEDYDATA:desc}. |
security_result.description |
當 event_name 為 mafEntryMatch 時,從 message1 擷取。 |
SrcIP |
principal.ip |
當 event_name 為 mafEntryMatch 時,系統會從 kv_data 欄位擷取這項資訊。 |
SrcIP: %{INT:src_port} |
principal.port |
當 event_name 為 mafEntryMatch 時,系統會從 kv_data 欄位擷取這項資訊。 |
DstIP |
target.ip |
當 event_name 為 mafEntryMatch 時,系統會從 kv_data 欄位擷取這項資訊。 |
DstIP: %{INT:dest_port} |
target.port |
當 event_name 為 mafEntryMatch 時,系統會從 kv_data 欄位擷取這項資訊。 |
Protocol |
network.ip_protocol |
當 event_name 為 mafEntryMatch 時,系統會從 kv_data 欄位擷取這項資訊。 |
| 不適用 | metadata.vendor_name |
設為 NOKIA_ROUTER。 |
| 不適用 | metadata.event_type |
根據擷取的欄位是否存在及組合判斷: - src_ip、dest_ip 和 network 存在 -> NETWORK_CONNECTION- principal 存在 -> STATUS_UPDATE- 否則 -> GENERIC_EVENT |
%{GREEDYDATA:description} |
metadata.description |
當 event_name 為 tmnxMkaSessionEstablished 時,從 message1 擷取。 |
src_ip |
event.idm.read_only_udm.intermediary.ip |
從變更記錄對應 |
src_ip |
event.idm.read_only_udm.intermediary.asset.ip |
從變更記錄對應 |
變更記錄
還有其他問題嗎?向社群成員和 Google SecOps 專業人員尋求答案。