收集 HAProxy 記錄

支援以下發布途徑:

本文說明如何使用 Bindplane 將 HAProxy 記錄匯入 Google Security Operations。Logstash 剖析器會使用一系列 Grok 模式比對規則,從 HAProxy 系統記錄訊息中擷取欄位,這些規則專門用於處理各種 HAProxy 記錄格式。接著,系統會將擷取的欄位對應至統一資料模型 (UDM),藉由額外脈絡豐富資料,並將表示方式標準化以利進一步分析。

事前準備

請確認您已具備下列必要條件:

  • Google SecOps 執行個體
  • Windows 2016 以上版本,或支援 systemd 的 Linux 主機
  • 如果是在 Proxy 後方執行,防火牆通訊埠會開啟
  • 對 HAProxy 的特殊存取權

取得 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. 開啟具有 root 或 sudo 權限的終端機。
  2. 執行下列指令:

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

其他安裝資源

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

設定 Bindplane 代理程式,以便擷取 syslog 並傳送至 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: <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
    
  3. 視基礎架構需求替換通訊埠和 IP 位址。

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

  5. 在「取得 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

  1. 使用 CLI 登入 HAproxy
  2. 將「全域」部分中的「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 欄位 (如有)。否則,系統會根據記錄訊息,從 actionstatus 等其他欄位擷取值。
日期時間 metadata.event_timestamp.seconds 擷取自記錄檔中的 datetime 欄位 (如有)。否則,系統會從記錄項目中的 timestamp 欄位擷取。
說明 metadata.description 擷取自記錄檔中的 description 欄位 (如有)。否則,系統會根據記錄訊息,從 command_descriptionaction 等其他欄位擷取值。
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 會對應至 MEDIUMALERT 會對應至 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_UNCATEGORIZEDSTATUS_UPDATEUSER_UNCATEGORIZED
metadata.vendor_name 設為 HAProxy Enterprise
metadata.product_name 設為 HAProxy
network.application_protocol 如果 message 欄位包含 HTTP,請將其設為 HTTP
metadata.log_type 設為 HAPROXY

還有其他問題嗎?向社群成員和 Google SecOps 專家尋求解答。