收集 HAProxy 記錄
支援以下發布途徑:
Google secops
Siem
本文說明如何使用 Bindplane 將 HAProxy 記錄匯入 Google Security Operations。Logstash 剖析器會使用一系列 Grok 模式比對規則,從 HAProxy 系統記錄訊息中擷取欄位,這些規則專門用於處理各種 HAProxy 記錄格式。接著,系統會將擷取的欄位對應至統一資料模型 (UDM),藉由額外脈絡豐富資料,並將表示方式標準化以利進一步分析。
事前準備
請確認您已具備下列必要條件:
- Google SecOps 執行個體
- Windows 2016 以上版本,或支援
systemd
的 Linux 主機 - 如果是在 Proxy 後方執行,防火牆通訊埠會開啟
- 對 HAProxy 的特殊存取權
取得 Google SecOps 擷取驗證檔案
- 登入 Google SecOps 控制台。
- 依序前往「SIEM 設定」>「收集代理程式」。
- 下載擷取驗證檔案。請在將要安裝 Bindplane 的系統上,安全地儲存檔案。
取得 Google SecOps 客戶 ID
- 登入 Google SecOps 控制台。
- 依序前往「SIEM 設定」>「設定檔」。
- 複製並儲存「機構詳細資料」部分中的客戶 ID。
安裝 Bindplane 代理程式
Windows 安裝
- 以系統管理員身分開啟命令提示字元或 PowerShell。
執行下列指令:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
Linux 安裝
- 開啟具有 root 或 sudo 權限的終端機。
執行下列指令:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
其他安裝資源
如需其他安裝選項,請參閱安裝指南。
設定 Bindplane 代理程式,以便擷取 syslog 並傳送至 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: <customer_id> endpoint: malachiteingestion-pa.googleapis.com # Add optional ingestion labels for better organization ingestion_labels: log_type: 'HAPROXY' raw_log_field: body service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labels
視基礎架構需求替換通訊埠和 IP 位址。
將
<customer_id>
替換為實際的客戶 ID。在「取得 Google SecOps 攝入驗證檔案」部分,將
/path/to/ingestion-authentication-file.json
更新為驗證檔案的儲存路徑。
重新啟動 Bindplane 代理程式以套用變更
如要在 Linux 中重新啟動 Bindplane 代理程式,請執行下列指令:
sudo systemctl restart bindplane-agent
如要在 Windows 中重新啟動 Bindplane 代理程式,您可以使用「Services」主控台,或輸入下列指令:
net stop BindPlaneAgent && net start BindPlaneAgent
為 HAProxy 設定 Syslog
- 使用 CLI 登入 HAproxy。
將「全域」部分中的「log」指令新增至「設定」,即可透過 UDP 轉送 Syslog 訊息。
- 請將
<bindplane-ips>
替換為實際的 Bindplane 代理程式 IP 位址。
global log <bindplane-ip>:514 local0 defaults log global
- 請將
UDM 對應表
記錄欄位 | UDM 對應 | 邏輯 |
---|---|---|
accept_date_ms | ||
actconn | ||
backend_name | ||
backend_queue | ||
beconn | ||
bytes_read | network.received_bytes | 從記錄中的 bytes_read 欄位擷取,並轉換為無符號整數。 |
captured_request_headers | ||
client_ip | principal.ip | 從記錄檔中的 client_ip 欄位擷取。 |
client_port | principal.port | 從記錄中的 client_port 欄位擷取,並轉換為整數。 |
command_description | metadata.description | 擷取自記錄檔中的 command_description 欄位 (如有)。否則,系統會根據記錄訊息,從 action 或 status 等其他欄位擷取值。 |
日期時間 | metadata.event_timestamp.seconds | 擷取自記錄檔中的 datetime 欄位 (如有)。否則,系統會從記錄項目中的 timestamp 欄位擷取。 |
說明 | metadata.description | 擷取自記錄檔中的 description 欄位 (如有)。否則,系統會根據記錄訊息,從 command_description 或 action 等其他欄位擷取值。 |
feconn | ||
frontend_name | ||
http_request | target.url | 從記錄檔中的 http_request 欄位擷取。 |
http_status_code | network.http.response_code | 從記錄中的 http_status_code 欄位擷取,並轉換為整數。 |
http_verb | network.http.method | 從記錄檔中的 http_verb 欄位擷取。 |
http_version | metadata.product_version | 從記錄檔中的 http_version 欄位擷取,並以 HTTP/{version} 格式呈現。 |
發起者 | target.application | 從記錄檔中的 initiator 欄位擷取。 |
module | ||
msg | security_result.summary | 從記錄檔中的 msg 欄位擷取。 |
pid | target.process.pid | 從記錄檔中的 pid 欄位擷取。 |
反向擴散程序 | ||
process_name | target.application | 從記錄檔中的 process_name 欄位擷取。 |
retries | ||
server_name | target.hostname | 從記錄檔中的 server_name 欄位擷取。如果為空白,則預設為 syslog_server 的值。 |
嚴重性 | security_result.severity | 從記錄中的 severity 欄位對應而來。WARNING 會對應至 MEDIUM 、ALERT 會對應至 CRITICAL ,而 NOTICE 會對應至 INFORMATIONAL 。 |
殼層 | ||
srv_queue | ||
srvconn | ||
狀態 | ||
syslog_server | target.hostname、intermediary.hostname | 從記錄檔中的 syslog_server 欄位擷取。可用於目標主機名稱 (如果 server_name 為空白) 和中介主機名稱。 |
syslog_timestamp | ||
syslog_timestamp_1 | ||
syslog_timestamp_2 | ||
syslog_timestamp_4 | ||
target_ip | ||
time_backend_connect | ||
time_backend_response | ||
time_duration | ||
time_queue | ||
time_request | ||
時間戳記 | metadata.event_timestamp.seconds | 從記錄中的 timestamp 欄位擷取,並剖析日期和時間資訊。用於做為事件時間戳記。 |
unknown_parameters1 | ||
unknown_parameters2 | ||
user_name | target.user.userid | 從記錄檔中的 user_name 欄位擷取。 |
metadata.event_type | 預設為 NETWORK_HTTP 。根據記錄訊息和剖析欄位,變更為特定事件類型,例如 PROCESS_UNCATEGORIZED 、STATUS_UPDATE 或 USER_UNCATEGORIZED 。 |
|
metadata.vendor_name | 設為 HAProxy Enterprise 。 |
|
metadata.product_name | 設為 HAProxy 。 |
|
network.application_protocol | 如果 message 欄位包含 HTTP ,請將其設為 HTTP 。 |
|
metadata.log_type | 設為 HAPROXY 。 |
還有其他問題嗎?向社群成員和 Google SecOps 專家尋求解答。