收集 F5 VPN 記錄

剖析器版本:2.0

支援的國家/地區:

本文說明如何使用 Bindplane 代理程式,將 F5 VPN 記錄檔擷取至 Google Security Operations。

F5 BIG-IP Access Policy Manager (APM) 是一種 VPN 和存取權管理解決方案,可為使用者驗證、工作階段管理、政策評估、通道建立和網路存取事件產生系統記錄訊息。剖析器會從 Syslog 格式的記錄檔中擷取欄位,並對應至統合式資料模型 (UDM)。

事前準備

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

  • Google SecOps 執行個體
  • Windows Server 2016 以上版本,或搭載 systemd 的 Linux 主機
  • Bindplane 代理程式與 F5 BIG-IP 設備之間的網路連線
  • 如果透過 Proxy 執行,請確保防火牆通訊埠已根據 Bindplane 代理程式需求開啟
  • F5 BIG-IP tmsh (11.x 以上版本) 的特殊權限存取權

取得 Google SecOps 擷取驗證檔案

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

取得 Google SecOps 客戶 ID

  1. 登入 Google SecOps 控制台。
  2. 依序前往「SIEM 設定」>「設定檔」
  3. 複製並儲存「機構詳細資料」部分中的客戶 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 安裝

  1. 開啟具有根層級或 sudo 權限的終端機。
  2. 執行下列指令:

    sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
    
  3. 等待安裝完成。

  4. 執行下列指令,確認安裝成功:

    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/f5_vpn:
            compression: gzip
            creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
            customer_id: '<customer_id>'
            endpoint: malachiteingestion-pa.googleapis.com
            log_type: F5_VPN
            raw_log_field: body
    
    service:
        pipelines:
            logs/f5_vpn_to_chronicle:
                receivers:
                    - udplog
                exporters:
                    - chronicle/f5_vpn
    

設定參數

替換下列預留位置:

  • 接收器設定:

    • listen_address:要接聽的 IP 位址和通訊埠:
      • 0.0.0.0,監聽所有介面 (建議)
      • 通訊埠 514 是標準的系統記錄通訊埠 (在 Linux 上需要根層級權限;非根層級權限請使用 1514)
  • 匯出工具設定:

    • creds_file_path:擷取驗證檔案的完整路徑:
      • Linux/etc/bindplane-agent/ingestion-auth.json
      • WindowsC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • customer_id:從 Google SecOps 控制台複製的客戶 ID
    • endpoint:區域端點網址:
      • 美國malachiteingestion-pa.googleapis.com
      • 歐洲europe-malachiteingestion-pa.googleapis.com
      • 亞洲asia-southeast1-malachiteingestion-pa.googleapis.com
      • 如需完整清單,請參閱「區域端點

儲存設定檔

  • 編輯完成後,請儲存檔案:
    • Linux:依序按下 Ctrl+OEnterCtrl+X
    • Windows:依序點選「檔案」>「儲存」

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

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

    sudo systemctl restart observiq-otel-collector
    
    1. 確認服務正在執行:

      sudo systemctl status observiq-otel-collector
      
    2. 檢查記錄中是否有錯誤:

      sudo journalctl -u observiq-otel-collector -f
      
  • 如要在 Windows 中重新啟動 Bindplane 代理程式,請選擇下列其中一個選項:

    • 以管理員身分開啟命令提示字元或 PowerShell:

      net stop observiq-otel-collector && net start observiq-otel-collector
      
    • 服務控制台:

      1. 按下 Win+R,輸入 services.msc,然後按下 Enter 鍵。
      2. 找出 observIQ OpenTelemetry Collector
      3. 按一下滑鼠右鍵,然後選取「重新啟動」
      4. 確認服務正在執行:

        sc query observiq-otel-collector
        
      5. 檢查記錄中是否有錯誤:

        type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
        

在 F5 BIG-IP APM 上設定系統記錄轉送

  1. 連線至 F5 BIG-IP 指令列。
  2. 開啟 tmsh 殼層:

    tmsh
    
  3. 執行下列指令,設定遠端系統記錄檔伺服器:

    modify sys syslog remote-servers add { <Name> { host <bindplane-ip> remote-port <bindplane-port> } }
    

    更改下列內容:

    • <Name>:這個系統記錄目的地的不重複名稱 (例如 bindplane_server)。
    • <bindplane-ip>:Bindplane 代理程式主機的 IP 位址。
    • <bindplane-port>:在 Bindplane 代理程式接收器中設定的通訊埠 (預設為 514)。
  4. 儲存設定:

    save sys config partitions all
    

UDM 對應表

記錄欄位 UDM 對應 邏輯
cmd_data principal.process.command_line 從 msg 欄位擷取的值
errdefs_msgno additional.fields.errdefs_msgno.string_value 從 msg 欄位擷取的值
event_time metadata.event_timestamp 系統會剖析該值並轉換為時間戳記
hostname principal.hostname,observer.hostname,principal.asset.hostname,observer.asset.hostname, 系統會從郵件欄位擷取值,並用於填入 UDM 中的主機名稱欄位。也用於填入 hostip 欄位
msg security_result.description 這個值會從訊息欄位擷取,並用於填入 security_result 物件中的說明欄位
prin_ip principal.ip,principal.asset.ip 系統會從郵件欄位擷取值,並用於填入 UDM 中的 IP 位址欄位
additional.fields.Canonical_Info.string_value 這個值是從記錄訊息衍生而來
additional.fields.IDP.string_value 這個值是從記錄訊息衍生而來
additional.fields.Plugin_Support.string_value 這個值是從記錄訊息衍生而來
additional.fields.SMBStage.string_value 這個值是從記錄訊息衍生而來
additional.fields.SP.string_value 這個值是從記錄訊息衍生而來
additional.fields.Timezone.string_value 這個值是從記錄訊息衍生而來
additional.fields.TunnelType.string_value 這個值是從記錄訊息衍生而來
additional.fields.UI_Mode.string_value 這個值是從記錄訊息衍生而來
additional.fields.Version.string_value 這個值是從記錄訊息衍生而來
additional.fields.from_rule_item.string_value 這個值是從記錄訊息衍生而來
additional.fields.policy_result.string_value 這個值是從記錄訊息衍生而來
additional.fields.ppp_id.string_value 這個值是從記錄訊息衍生而來
additional.fields.resource.string_value 這個值是從記錄訊息衍生而來
additional.fields.rule.string_value 這個值是從記錄訊息衍生而來
additional.fields.server_vip_ip.string_value 這個值是從記錄訊息衍生而來
additional.fields.server_vip_name.string_value 這個值是從記錄訊息衍生而來
additional.fields.to_rule_item.string_value 這個值是從記錄訊息衍生而來
additional.fields.tunnel_resource.string_value 這個值是從記錄訊息衍生而來
metadata.description 這個值是從記錄訊息衍生而來
metadata.event_type 部分事件的值會以硬式編碼方式加到剖析器程式碼中,其他事件的值則會從記錄訊息衍生而來
metadata.log_type 這個值會設為批次類型
metadata.product_event_type 這個值是從記錄訊息衍生而來
metadata.product_name 值是以硬式編碼方式寫死在剖析器程式碼中
metadata.vendor_name 值是以硬式編碼方式寫死在剖析器程式碼中
network.application_protocol 這個值是從記錄訊息衍生而來
network.direction 這個值是從記錄訊息衍生而來
network.http.method 這個值是從記錄訊息衍生而來
network.http.parsed_user_agent 這個值衍生自 network.http.user_agent 欄位
network.http.referral_url 這個值是從記錄訊息衍生而來
network.http.response_code 這個值是從記錄訊息衍生而來
network.http.user_agent 這個值是從記錄訊息衍生而來
network.ip_protocol 這個值是從記錄訊息衍生而來
network.received_bytes 這個值是從記錄訊息衍生而來
network.sent_bytes 這個值是從記錄訊息衍生而來
network.session_id 這個值是從記錄訊息衍生而來
network.tls.cipher 這個值是從記錄訊息衍生而來
network.tls.version 這個值是從記錄訊息衍生而來
observer.asset.hostname 這個值會設為主機名稱欄位
observer.asset.ip 這個值會設為 hostip 欄位
observer.hostname 這個值會設為主機名稱欄位
observer.ip 這個值會設為 hostip 欄位
principal.application 這個值是從記錄訊息衍生而來
principal.asset.hostname 這個值會設為主機名稱欄位
principal.asset.ip 如果存在 hostip 欄位或 prin_ip 欄位,則值會設為這些欄位
principal.asset.product_object_id 這個值是從記錄訊息衍生而來
principal.hostname 這個值會設為主機名稱欄位
principal.ip 如果存在 hostip 欄位或 prin_ip 欄位,則值會設為這些欄位
principal.location.country_or_region 這個值是從記錄訊息衍生而來
principal.platform 這個值是從記錄訊息衍生而來
principal.port 這個值是從記錄訊息衍生而來
principal.process.command_line 這個值是從記錄訊息衍生而來
principal.process.pid 這個值是從記錄訊息衍生而來
principal.resource.name 這個值是從記錄訊息衍生而來
principal.resource.type 部分事件的值會以硬式編碼方式加到剖析器程式碼中,其他事件的值則會從記錄訊息衍生而來
principal.user.email_addresses 這個值是從記錄訊息衍生而來
principal.user.userid 這個值是從記錄訊息衍生而來
security_result.action 這個值是從記錄訊息衍生而來
security_result.description 這個值是從記錄訊息衍生而來
security_result.rule_name 這個值是從記錄訊息衍生而來
security_result.severity 這個值是從記錄訊息衍生而來
security_result.severity_details 這個值是從記錄訊息衍生而來
security_result.summary 這個值是從記錄訊息衍生而來
src.ip 這個值是從記錄訊息衍生而來
src.location.country_or_region 這個值是從記錄訊息衍生而來
src.port 這個值是從記錄訊息衍生而來
target.asset.hostname 這個值是從記錄訊息衍生而來
target.asset.ip 這個值是從記錄訊息衍生而來
target.hostname 這個值是從記錄訊息衍生而來
target.ip 這個值是從記錄訊息衍生而來
target.port 這個值是從記錄訊息衍生而來
target.process.command_line 這個值是從記錄訊息衍生而來
target.process.pid 這個值是從記錄訊息衍生而來
target.resource.id 這個值是從記錄訊息衍生而來
target.url 這個值是從記錄訊息衍生而來
target.user.userid 這個值是從記錄訊息衍生而來
Hostname target.hostname 從變更記錄對應
sess_id network.session_id 從變更記錄對應
internal_ip target.ip 從變更記錄對應
file_path principal.resource.name 從變更記錄對應
useragent network.http.user_agent 從變更記錄對應
User-Agent" and "useragent network.http.parsed_user_agent 從變更記錄對應
username target.user.userid 從變更記錄對應
sid target.user.windows_sid 從變更記錄對應
bytes_out network.sent_bytes 從變更記錄對應
bytes_in network.received_bytes 從變更記錄對應
Platform principal.platform 從變更記錄對應
Platform_Version principal.platform_version 從變更記錄對應
Javascript_Support", "ActiveX_Support", "Plugin_Support", "Version", "Model", "CPU", "UI_Mode", "SP", "IDP", "to_rule_item", "from_rule_item", "policy_result", "rule", "resource", "ppp_id", "tunnel_resource", "server_vip_ip", "server_vip_name", and "Canonical_Info additional.fields 從變更記錄對應
uri_path target.url 從變更記錄對應
User-Agent network.http.user_agent 從變更記錄對應
s_ip src.ip 從變更記錄對應
t_ip target.ip 從變更記錄對應
t_port target.port 從變更記錄對應
s_nat_ip target.nat_ip 從變更記錄對應
cipher_name network.tls.cipher 從變更記錄對應
tls_version network.tls.version 從變更記錄對應
resource_id target.resource.id 從變更記錄對應
src_ip principal.ip 從變更記錄對應
status network.http.response_code 從變更記錄對應

變更記錄

查看這個剖析器的變更記錄

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