收集 CyberArk Privileged Threat Analytics 記錄

剖析器版本：18.0

本文說明如何使用 Bindplane，將 CyberArk Privileged Threat Analytics 記錄檔擷取至 Google Security Operations。CyberArk Privileged Threat Analytics (PTA) 是一項安全性解決方案，可偵測及應對涉及特殊權限帳戶的惡意活動。這項解決方案運用進階分析和機器學習技術，監控、分析及標記異常行為，找出潛在的內部威脅或遭入侵的憑證。

事前準備

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

• Google SecOps 執行個體。
• Windows 2016 以上版本或 Linux 主機 (含 systemd)。
• 如果透過 Proxy 執行，請確保防火牆通訊埠已根據 Bindplane 代理程式需求開啟。
• CyberArk Privileged Threat Analytics 伺服器的特殊權限存取權。

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

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

• 新部署作業：使用 Chronicle API (選項 1)。
• 舊版部署作業：繼續使用擷取驗證檔案 (選項 2)，直到 Ingestion API 於 2027 年 7 月 20 日停用。

方法 1：為 Chronicle API 建立服務帳戶 (建議)

1. 登入 Google Cloud 控制台，選取連結至 Google SecOps 執行個體的 Google Cloud 專案。
2. 依序前往「IAM & Admin」(IAM 與管理) >「Service Accounts」(服務帳戶)。
3. 按一下「建立服務帳戶」。
4. 提供下列設定詳細資料：
   • 「Service account name」(服務帳戶名稱)：輸入帳戶名稱 (例如 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 Settings」 > 「Collection Agents」。
3. 下載擷取驗證檔案。
4. 將檔案安全地儲存在要安裝 Bindplane 代理程式的系統上。

取得 Google SecOps 客戶 ID

1. 登入 Google SecOps 控制台。
2. 依序前往「SIEM Settings」(SIEM 設定) >「Profile」(設定檔)。
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:
     tcplog:
       listen_address: "0.0.0.0:514"
   
   exporters:
     chronicle/cyberark_pta:
       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
       creds_file_path: '/path/to/ingestion-authentication-file.json'
       customer_id: '<CUSTOMER_ID>'
       endpoint: chronicle.googleapis.com
       log_type: 'CYBERARK_PTA'
       raw_log_field: body
       ingestion_labels:
   
   service:
     pipelines:
       logs/cyberark_pta_to_chronicle:
         receivers:
           - tcplog
         exporters:
           - chronicle/cyberark_pta
   

• 請根據基礎架構需求，替換通訊埠和 IP 位址。
• 將 <CUSTOMER_ID> 替換為實際的客戶 ID。
• 將 <LOCATION> 替換為 Google SecOps 執行個體的區域 (例如 us、europe 或 asia-southeast1)。匯出工具會以這個值做為 chronicle.googleapis.com 的前置字元。如需完整清單，請參閱「區域性端點」。

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

• 將 /path/to/ingestion-authentication-file.json 更新為服務帳戶金鑰檔案 (選項 1) 的儲存路徑。

舊版 Ingestion API 匯出工具

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

  exporters:
    chronicle/cyberark_pta:
      compression: gzip
      creds_file_path: '/path/to/ingestion-authentication-file.json'
      customer_id: '<CUSTOMER_ID>'
      endpoint: malachiteingestion-pa.googleapis.com
      log_type: 'CYBERARK_PTA'
      raw_log_field: body
      ingestion_labels:
  

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

1. 如要在 Linux 中重新啟動 Bindplane 代理程式，請執行下列指令：

   sudo systemctl restart observiq-otel-collector
   

2. 如要在 Windows 中重新啟動 Bindplane 代理程式，可以使用「服務」控制台，也可以輸入下列指令：

   net stop observiq-otel-collector && net start observiq-otel-collector
   

設定 CyberArk Privileged Threat Analytics 系統記錄檔轉送功能

1. 登入 Privileged Threat Analytics 伺服器。
2. 執行 DEFAULTPARM 指令，開啟預設 systemparm.properties 檔案。
3. 複製含有 syslog_outbound 屬性的行，然後退出 systemparm.properties 檔案。
4. 執行 LOCALPARM 指令，開啟本機 systemparm.properties 檔案。
5. 按下鍵盤上的 i 鍵，即可編輯檔案。
6. 在 systemparm.properties 檔案中，取消註解 syslog_outbound 屬性。

7. 貼上複製的程式碼行，並根據下列範例編輯參數：

   syslog_outbound=[{"siem": "Chronicle", "format": "CEF", "host": "BINDPLANE_IP", "port": BINDPLANE_PORT, "protocol": "TCP"}]
   

   • 將 BINDPLANE_IP 替換為 Bindplane 代理程式主機的 IP 位址。
   • 將 BINDPLANE_PORT 替換為 Bindplane 代理程式中設定的通訊埠號碼 (例如 514)。

8. 儲存並關閉設定檔。

9. 重新啟動 Privileged Threat Analytics 伺服器，即可套用變更。

詳情請參閱 CyberArk Privileged Threat Analytics 說明文件。

UDM 對應表

記錄欄位	UDM 對應	邏輯
src	principal.ip	直接對應「src」欄位。
dst	target.ip	直接從 dst 欄位對應。
suser	principal.user.userid	直接對應「suser」欄位。
duser	target.user.userid	直接對應「duser」欄位。
cs1	security_result.description	直接對應「cs1」欄位 (原因)。
cs2	additional.fields	直接從「cs2」欄位 (電台) 對應。
act	security_result.action_details	直接對應「act」欄位 (採取的動作)。
cat	metadata.product_event_type	直接對應 cat 欄位 (事件類別)。
severity	security_result.severity	從 CEF 嚴重程度值對應。
deviceCustomDate1	metadata.event_timestamp	從「deviceCustomDate1」欄位剖析。
	metadata.vendor_name	設為 CyberArk。
	metadata.product_name	設為 Privileged Threat Analytics。
	metadata.log_type	設為 CYBERARK_PTA。

變更記錄

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

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