收集 ExtraHop Reveal(x) 記錄

剖析器版本:12.0

支援的國家/地區:

本文說明如何使用 Bindplane,將 ExtraHop Reveal(x) 記錄擷取至 Google Security Operations。ExtraHop Reveal(x) 是網路偵測與回應 (NDR) 平台,可即時掌握網路流量,協助機構在雲端和地端環境中偵測威脅、調查事件及回應安全事件。

事前準備

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

  • Google SecOps 執行個體
  • Windows Server 2016 以上版本,或具備 systemdLinux 主機
  • 如果透過 Proxy 執行,請確保防火牆通訊埠已根據 Bindplane 代理程式需求開啟。
  • 特殊存取權,可存取 ExtraHop Reveal(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](https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi)" /quiet
    
  3. 執行下列指令,確認安裝成功:

    sc query observiq-otel-collector
    

服務應顯示為「RUNNING」

Linux 安裝

  1. 開啟具有 rootsudo 權限的終端機。
  2. 執行下列指令:

    sudo sh -c "$(curl -fsSlL [https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh](https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh))" install_unix.sh
    
  3. 執行下列指令,確認安裝成功:

    sudo systemctl status observiq-otel-collector
    

服務應顯示為有效 (執行中)

其他安裝資源

如需其他安裝選項,請參閱 Bindplane 代理程式安裝指南

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

找出設定檔

  • Linux: sudo systemctl status observiq-otel-collector
  • Windows: C:\Program Files\observIQ OpenTelemetry Collector\config.yaml

編輯設定檔

  • config.yaml 的所有內容替換為下列設定:

    receivers:
      tcplog:
        listen_address: "0.0.0.0:514"
    
    exporters:
      chronicle/extrahop:
        compression: gzip
        creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
        customer_id: '<CUSTOMER_ID>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: EXTRAHOP
        raw_log_field: body
        ingestion_labels:
    
    service:
      pipelines:
        logs/extrahop_to_chronicle:
          receivers:
            - tcplog
          exporters:
            - chronicle/extrahop
    

設定參數

替換下列預留位置:

  • <CUSTOMER_ID>:您的 Google SecOps 客戶 ID。
  • creds_file_path 更新為擷取驗證檔案的儲存路徑:
    • Linux/etc/bindplane-agent/ingestion-auth.json
    • WindowsC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
  • 使用區域端點更新 endpoint 值:
    • 美國malachiteingestion-pa.googleapis.com
    • 歐洲europe-malachiteingestion-pa.googleapis.com
    • 亞洲asia-southeast1-malachiteingestion-pa.googleapis.com

重新啟動 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"
    

設定 ExtraHop Reveal(x) 系統記錄檔轉送

設定系統通知 Syslog

  1. 登入 ExtraHop「管理」設定 (https://<extrahop-hostname-or-IP-address>/admin)。
  2. 在「網路設定」部分,按一下「通知」
  3. 按一下「Syslog」Syslog
  4. 請提供下列設定詳細資料:
    • 目的地:輸入 Bindplane 代理程式主機的 IP 位址。
    • 「通訊協定」:選取「TCP」
    • 「Port」(通訊埠):輸入在 Bindplane 代理程式中設定的通訊埠編號 (例如 514)。
  5. 按一下「測試設定」,然後按一下「儲存」

設定稽核記錄 Syslog 轉送

  1. 在 ExtraHop「Administration」(管理) 設定中,前往「Status and Diagnostics」(狀態與診斷) 部分。
  2. 依序點選「稽核記錄」>「設定系統記錄設定」
  3. 請提供下列設定詳細資料:
    • 目的地:輸入 Bindplane 代理程式主機的 IP 位址。
    • 「通訊協定」:選取「TCP」
    • 「Port」(通訊埠):輸入 514
  4. 按一下「測試設定」,然後按一下「儲存」

選用:設定符合 RFC 規範的系統記錄格式

  1. 在 ExtraHop「Administration」(管理) 設定中,依序點選「Running Config」(執行設定)「Edit Config」(編輯設定)
  2. syslog_notification 區段下方新增下列項目:

    "rfc_compliant_format": "rfc5424"
    
  3. 依序按一下「儲存」和「套用變更」

UDM 對應表

記錄欄位 UDM 對應 邏輯
act security_result.action_details 原始記錄值對應。
cat metadata.product_event_type 原始記錄值對應。
deviceExternalId metadata.product_log_id 原始記錄值對應。
dhost target.hostname 原始記錄值對應。
dpt target.port 原始記錄值對應。
dst target.ip 原始記錄值對應。
duser target.user.userid 原始記錄值對應。
msg metadata.description 原始記錄值對應。
proto network.ip_protocol 原始記錄值對應。
severity security_result.severity 根據 CEF 嚴重程度值對應。
shost principal.hostname 原始記錄值對應。
spt principal.port 原始記錄值對應。
src principal.ip 原始記錄值對應。
suser principal.user.userid 原始記錄值對應。
不適用 metadata.log_type 設為 EXTRAHOP
不適用 metadata.product_name 設為 Reveal(x)
不適用 metadata.vendor_name 設為 ExtraHop
tar_ip event.idm.read_only_udm.target.ipevent.idm.read_only_udm.target.asset.ip 從變更記錄對應
tar_port event.idm.read_only_udm.target.port 從變更記錄對應
extrahop_detail event.idm.read_only_udm.additional.fields 從變更記錄對應
alert_value event.idm.read_only_udm.security_result.detection_fields 從變更記錄對應
jsonPayload.target.ip event.idm.read_only_udm.target.ipevent.idm.read_only_udm.target.asset.ip 從變更記錄對應
jsonPayload.principal.mac event.idm.read_only_udm.principal.macevent.idm.read_only_udm.principal.asset.mac 從變更記錄對應
jsonPayload.target.mac event.idm.read_only_udm.target.macevent.idm.read_only_udm.target.asset.mac 從變更記錄對應
jsonPayload.principal.hostname event.idm.read_only_udm.principal.hostnameevent.idm.read_only_udm.principal.asset.hostname 從變更記錄對應
jsonPayload.target.hostname event.idm.read_only_udm.target.hostnameevent.idm.read_only_udm.target.asset.hostname 從變更記錄對應
jsonPayload.vulnerability.cvss_vector event.idm.read_only_udm.security_result.about.asset.vulnerabilities.cvss_vector 從變更記錄對應
suspicious_domain event.idm.read_only_udm.target.hostnameevent.idm.read_only_udm.target.asset.hostname 從變更記錄對應
reference event.idm.read_only_udm.security_result.about.url 從變更記錄對應
sid event.idm.read_only_udm.security_result.rule_id 從變更記錄對應
id event.idm.read_only_udm.metadata.product_log_id 從變更記錄對應
description event.idm.read_only_udm.metadata.description 從變更記錄對應
type event.idm.read_only_udm.metadata.product_event_type 從變更記錄對應
start_time event.idm.read_only_udm.metadata.event_timestampevent.idm.read_only_udm.security_result.first_discovered_time 從變更記錄對應
update_time event.idm.read_only_udm.security_result.last_updated_time 從變更記錄對應
end_time event.idm.read_only_udm.security_result.last_discovered_time 從變更記錄對應
title event.idm.read_only_udm.security_result.summary 從變更記錄對應
risk_score event.idm.read_only_udm.security_result.risk_score 從變更記錄對應
categories event.idm.read_only_udm.security_result.category_details 從變更記錄對應
participant.endpoint event.idm.read_only_udm.principal.asset.category 從變更記錄對應
participant.object_id event.idm.read_only_udm.principal.asset.product_object_id 從變更記錄對應
participant.object_value event.idm.read_only_udm.principal.ipevent.idm.read_only_udm.principal.asset.ip 從變更記錄對應
participant.hostname event.idm.read_only_udm.principal.hostnameevent.idm.read_only_udm.principal.asset.hostname 從變更記錄對應
participant.username event.idm.read_only_udm.principal.user.userid 從變更記錄對應
participant.endpoint event.idm.read_only_udm.target.asset.category 從變更記錄對應
participant.object_id event.idm.read_only_udm.target.asset.product_object_id 從變更記錄對應
participant.object_value event.idm.read_only_udm.target.ipevent.idm.read_only_udm.target.asset.ip 從變更記錄對應
participant.hostname event.idm.read_only_udm.target.hostnameevent.idm.read_only_udm.target.asset.hostname 從變更記錄對應
participant.username event.idm.read_only_udm.target.user.userid 從變更記錄對應
mitre_tactics.id event.idm.read_only_udm.security_result.attack_details.tactics.id 從變更記錄對應
mitre_tactics.name event.idm.read_only_udm.security_result.attack_details.tactics.name 從變更記錄對應
mitre_techniques.id event.idm.read_only_udm.security_result.attack_details.techniques.id 從變更記錄對應
mitre_techniques.name event.idm.read_only_udm.security_result.attack_details.techniques.name 從變更記錄對應
create_time event.idm.read_only_udm.additional.fields 從變更記錄對應
url event.idm.read_only_udm.url_back_to_product 從變更記錄對應
time event.idm.read_only_udm.metadata.event_timestamp 從變更記錄對應
security_result.severity CRITICAL 從變更記錄對應
security_result.severity ERROR 從變更記錄對應
security_result.severity HIGH 從變更記錄對應
security_result.severity MEDIUM 從變更記錄對應
security_result.severity LOW 從變更記錄對應
security_result.severity INFORMATIONAL 從變更記錄對應
jsonPayload.msg metadata.description 從變更記錄對應
jsonPayload.srcdata principal.ip 從變更記錄對應
jsonPayload.dstdata target.ip 從變更記錄對應
jsonPayload.dhost target.hostname 從變更記錄對應
jsonPayload.shost principal.hostname 從變更記錄對應
insertId additional.fields 從變更記錄對應
jsonPayload.cn2 security_result.risk_score 從變更記錄對應
jsonPayload.name security_result.summary 從變更記錄對應
jsonPayload.rt metadata.event_timestamp 從變更記錄對應
jsonPayload.start", "jsonPayload.end" and "logName additional.fields 從變更記錄對應
resource.labels.method" and "resource.labels.service target.resource.attribute.labels 從變更記錄對應
jsonPayload.cat" and "jsonPayload.cs5 security_result.detection_fields 從變更記錄對應
dst target.asset.ip 從變更記錄對應
url principal.url 從變更記錄對應
title", "id", "description_format", "victims.name", "victims.external", "offenders.name", "offenders.externaal", "victim_primary.name", victim_primary.external", "offender_primary.name", and "offender_primary.external additional.fields 從變更記錄對應
dst.type target.resource_type 從變更記錄對應
dst.hostname target.hostname 從變更記錄對應
dst.ipaddr target.ip 從變更記錄對應
dst.role target_resource.attribute.roles 從變更記錄對應
dst.device.macaddr target.mac 從變更記錄對應
src.type principal.resource_type 從變更記錄對應
src.hostname principal.hostname 從變更記錄對應
src.ipaddr principal.ip 從變更記錄對應
src.role principal_resource.attribute.roles 從變更記錄對應
src.device.macaddr principal.mac 從變更記錄對應
api.ip", "api.status", "api.id", "api.start_time", "api.mod_time", "api.categories", "api.update_time", and "api.ticket_id security_result.detection_fields 從變更記錄對應
victims.ipaddr principal.ip 從變更記錄對應
offenders.ipaddr target.ip 從變更記錄對應
victim_primary.ipaddr principal.ip 從變更記錄對應
offender_primary.ipaddr target.ip 從變更記錄對應
api.participants.role", "api.participants.object_id", "api.participants.object_type", and "api.participants.external section_details.fields 從變更記錄對應
risk_score" and "api.risk_score security_result.risk_score 從變更記錄對應
src.endpoint" and "src.device.oid principal.resource.attribute.labels 從變更記錄對應
dst.endpoint" and "dst.device.oid target.resource.attribute.labels 從變更記錄對應
dst.device.ipaddr target.ip 從變更記錄對應
src.device.ipaddr principal.ip 從變更記錄對應
categories_array" and "categories_id additional.fields 從變更記錄對應
src principal.asset.ip 從變更記錄對應
device_version metadata.product_version 從變更記錄對應
signature security_result.summary 從變更記錄對應
events.vulnerability.description metadata.description 從變更記錄對應
detectionID security_result.rule_labels 從變更記錄對應
event_type STATUS_UPDATE 從變更記錄對應
prin_url principal.url 從變更記錄對應

變更記錄

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

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