收集 Dell EMC Data Domain 記錄

剖析器版本:2.0

支援的服務:

本文說明如何使用 Bindplane,將 Dell EMC Data Domain 記錄檔擷取至 Google Security Operations。Logstash 剖析器程式碼會先使用以記錄訊息格式為依據的 grok 模式,從原始 DELL_EMC_DATA_DOMAIN 記錄檔中擷取重要欄位。接著,系統會將擷取的欄位對應至 Unified Data Model (UDM) 結構定義中的相應欄位,並使用事件類型和安全性結果等額外內容來擴充資料。

事前準備

請確認您符合下列必要條件:

  • Google SecOps 執行個體
  • Windows 2016 以上版本,或搭載 systemd 的 Linux 主機
  • 如果是在 Proxy 後方執行,防火牆通訊埠已開啟
  • Dell EMC Data Domain 的特殊存取權

取得 Bindplane 代理程式的 Google SecOps 憑證

如要向 Google SecOps 驗證 Bindplane 代理程式,請選擇下列其中一種方法:

  • 新部署作業:使用 Chronicle API (選項 1)。
  • 舊版部署作業:繼續使用擷取驗證檔案 (選項 2),直到 Ingestion API 於 2027 年 7 月 20 日停用。
  1. 登入 Google Cloud 控制台,選取連結至 Google SecOps 執行個體的 Google Cloud 專案。
  2. 依序前往 「IAM & Admin」(IAM 與管理) >「Service Accounts」(服務帳戶)。
  3. 按一下「建立服務帳戶」。
  4. 請提供下列設定詳細資料:
    • 服務帳戶名稱:輸入帳戶名稱 (例如 bindplane-ingest)。
    • 「服務帳戶說明」:輸入說明 (例如 Bindplane agent log ingestion)。
  5. 點按「Create and continue」(建立並繼續)。
  6. 在「將專案存取權授予這個服務帳戶」部分,按一下「選取角色」,然後選取「Chronicle 編輯者」。
  7. 依序點選「繼續」和「完成」。
  8. 按一下您建立的服務帳戶,然後前往「金鑰」分頁標籤。
  9. 依序點選「新增金鑰」>「建立新的金鑰」。
  10. 選取「JSON」,然後點選「建立」。金鑰檔案會下載到電腦。
  11. 將金鑰檔案儲存為 Bindplane 收集器目錄中的 ingestion-auth.json (Linux 上的 /opt/observiq-otel-collector/ingestion-auth.json 或 Windows 上的 C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json),或更新 config.yaml 中的 creds_file_path,使其與儲存路徑相符。
  12. 依序前往「IAM & Admin」(IAM 與管理) >「Settings」(設定),然後複製「Project number」(專案編號)。設定匯出工具時會用到。

方法 2:下載擷取驗證檔案 (舊版)

  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
    

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 代理程式,擷取系統記錄並傳送至 Google SecOps

  1. 存取設定檔:
    • 找出 config.yaml 檔案。通常位於 Linux 的 /opt/observiq-otel-collector/ 目錄,或 Windows 的安裝目錄。
    • 使用文字編輯器 (例如 nano、vi 或記事本) 開啟檔案。
  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:
            protocol: https
            # Region of your instance, for example us, europe, asia-southeast1
            location: <LOCATION>
            # Project number of the Google Cloud project linked to the instance
            project: '<PROJECT_NUMBER>'
            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: chronicle.googleapis.com
            # Add optional ingestion labels for better organization
            ingestion_labels:
                log_type: 'DELL_EMC_DATA_DOMAIN'
                raw_log_field: body
    
    service:
        pipelines:
            logs/source0__chronicle_w_labels-0:
                receivers:
                    - udplog
                exporters:
                    - chronicle/chronicle_w_labels
    
  3. 視基礎架構需求更換連接埠和 IP 位址。

  4. 將 <LOCATION> 替換為 Google SecOps 執行個體的區域 (例如 us、europe 或 asia-southeast1)。匯出工具會以這個值做為 chronicle.googleapis.com 的前置字元。

  5. 將 <PROJECT_NUMBER> 替換為「IAM 與管理」>「設定」中的專案編號。

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

  7. 將 /path/to/ingestion-authentication-file.json 更新為服務帳戶金鑰檔案 (選項 1) 在「取得 Bindplane 代理程式的 Google SecOps 憑證」一節中儲存的路徑。

舊版擷取 API 匯出工具

  • 如果您使用選項 2 的擷取驗證檔案,請將 exporters 區塊替換為下列內容。將 creds_file_path 設為擷取驗證檔案的路徑。如果執行個體位於美國境外,請將 malachiteingestion-pa.googleapis.com 替換為區域端點 (例如 europe-malachiteingestion-pa.googleapis.com)。

    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: 'DELL_EMC_DATA_DOMAIN'
                raw_log_field: body
    

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

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

    sudo systemctl restart bindplane-agent
    
  • 如要在 Windows 中重新啟動 Bindplane 代理程式,可以使用「Services」(服務) 控制台,或輸入下列指令:

    net stop BindPlaneAgent && net start BindPlaneAgent
    

設定 Dell EMC Data Domain 的 Syslog

  1. 使用 CLI 登入 Dell EMC Data Domain。
  2. 顯示目前的設定:

    log host show
    
  3. 啟用將記錄訊息傳送至其他系統的功能:

    log host enable
    
  4. 使用下列指令,將 Bindplane 代理程式 IP 新增至 syslog,並將 <bindplane-ip> 替換為實際的 Bindplane 代理程式 IP 位址。

    log host add <bindplane-ip>
    
  5. 使用下列指令將 Bindplane 代理程式連接埠新增至 syslog,並將 <bindplane-port> 替換為實際的 Bindplane 代理程式連接埠號碼。

    log server-port set <bindplane-port>
    

支援的 Dell EMC Data Domain 記錄範例

  • SYSLOG + KV

    <174>ddsh: {epoch=1649171401;id='AUDIT-DDSH-00001';desc='DDSH CLI command';level=3;user='dummy_user';role='se';app='ddsh';host='dd-host-1';detail='cmd=cifs show detailed-stats';}
    
  • SYSLOG

    <38>sshd[13244]: Accepted publickey for dd-admin from 192.0.2.1 port 57656 ssh2: RSA SHA256:+BWDxlMYuJgfC0LhzacEAUpFHlAZlNOYXAKKJ4SAipQ
    
    • JSON
    {
    "Timestamp": "2024-09-05T13:25:14Z",
    "EventName": "Participant left session",
    "EventType": "Session",
    "Username": "user_9999",
    "EventDetails": [
      {
        "OldValue": "",
        "NewValue": "1352719861",
        "PolicyEnforcementNewValue": null,
        "PolicyEnforcementOldValue": null,
        "PropertyName": "ID of affected participant",
        "PropertyCategory": "AffectedParticipant"
      },
      {
        "OldValue": "",
        "NewValue": "User Name 1",
        "PolicyEnforcementNewValue": null,
        "PolicyEnforcementOldValue": null,
        "PropertyName": "Name of affected participant",
        "PropertyCategory": "AffectedParticipant"
      }
    ],
    "Computer": "HOST-PC-400",
    "EventId": 35139395
    }
    
  • SYSLOG + XML

    <21>1 2024-08-01T12:31:40.791267+02:00 VEEM-HOST-01 Veeam_ONE_Server 7172 - [origin enterpriseId="31023"] Operation:"SendEmail" Email has been sent Data:<data><recipient>recipient@example.com</recipient><subject>VM resetting Information for Virtual Machine &quot;VM_RESTORED_2024&quot;</subject></data>
    

UDM 對應表

記錄欄位 UDM 對應 邏輯
應用程式 read_only_udm.target.application 值取自第一個 grok 剖析器擷取的「app」欄位。
cmd read_only_udm.target.process.command_line 值取自第一個 grok 剖析器擷取的「cmd」欄位,如果「cmd」欄位為空白,則取自「detail」欄位。
遞減 read_only_udm.metadata.description 值取自第一個 grok 剖析器擷取的「desc」欄位。
epoch read_only_udm.metadata.event_timestamp.seconds 值取自「epoch」欄位,並使用「date」篩選器轉換為時間戳記。
主機 read_only_udm.principal.hostname 值取自第一個 Grok 剖析器擷取的「主機」欄位。
id read_only_udm.metadata.product_event_type 值取自第一個 grok 剖析器擷取的「id」欄位。
pid read_only_udm.target.process.pid 值取自第一個 grok 剖析器擷取的「pid」欄位。
reason read_only_udm.security_result.description 值取自第一個 Grok 剖析器擷取的「原因」欄位。
角色 read_only_udm.principal.user.attribute.roles.name 值取自第一個 grok 剖析器擷取的「role」欄位。
session_id read_only_udm.network.session_id 值取自第一個 grok 剖析器擷取的「session_id」欄位。
src_ip read_only_udm.principal.ip 值取自第二個 grok 剖析器擷取的「src_ip」欄位。
src_port read_only_udm.principal.port 值取自第二個 grok 剖析器擷取的「src_port」欄位,並轉換為整數。
timestamp.nanos read_only_udm.metadata.event_timestamp.nanos 值取自原始記錄的「timestamp.nanos」欄位。
timestamp.seconds read_only_udm.metadata.event_timestamp.seconds 值取自原始記錄的「timestamp.seconds」欄位。
使用者 read_only_udm.target.user.userid 值取自第一個或第二個 grok 剖析器擷取的「user」欄位。
read_only_udm.extensions.auth.mechanism 如果「desc」欄位與使用者登入或登出事件相關的特定模式相符,這個值會設為「USERNAME_PASSWORD」。
read_only_udm.metadata.event_type 這個值是由一系列條件陳述式決定,這些陳述式會根據其他欄位的值 (主要是「desc」、「src_ip」和「host」) 進行評估。
read_only_udm.metadata.log_type 硬式編碼為「DELL_EMC_DATA_DOMAIN」。
read_only_udm.metadata.product_name 硬式編碼為「DELL_EMC_DATA_DOMAIN」。
read_only_udm.metadata.vendor_name 硬式編碼為「DELL」。
read_only_udm.network.http.method 值取自 KV 篩選器擷取的「method」欄位。
read_only_udm.network.http.response_code 值取自 KV 篩選器擷取的「response_code」欄位,並轉換為整數。
read_only_udm.network.ip_protocol 值是使用對照表和「parse_ip_protocol.include」設定,從「protocol_number_src」欄位衍生而來。
read_only_udm.security_result.severity 如果「message」欄位包含「NOTICE」字串,值會設為「MEDIUM」。
read_only_udm.target.file.sha256 值取自第二個 grok 剖析器擷取的「sha256」欄位,轉換為小寫,並驗證為十六進位字串。
read_only_udm.target.process.file.full_path 系統會根據「path」或「file」欄位是否為空值,從中擷取值。
read_only_udm.target.url 值取自 KV 篩選器擷取的「uri」欄位。
host event.idm.read_only_udm.principal.ip 從變更記錄對應
host event.idm.read_only_udm.principal.asset.ip 從變更記錄對應
inter_host event.idm.read_only_udm.intermediary.hostname 從變更記錄對應
msg event.idm.read_only_udm.security_result.description 從變更記錄對應

變更記錄

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

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