收集 ForgeRock OpenAM 記錄

本文說明如何使用 Bindplane，將 ForgeRock OpenAM 記錄檔擷取至 Google Security Operations。剖析器會從 CSV、Syslog + KV 或 JSON 格式的記錄檔中擷取欄位、將欄位正規化，然後對應至統合式資料模型 (UDM)。這項服務會處理各種 OpenAM 事件類型，包括登入/登出、存取結果和一般記錄，並在豐富資料的同時，針對不同記錄格式和事件類型執行特定轉換。剖析器會優先剖析 JSON，然後依序剖析 Syslog+KV 和 CSV，並捨棄不支援格式的記錄。

事前準備

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

• Google SecOps 執行個體
• Windows 2016 以上版本，或搭載 systemd 的 Linux 主機
• 如果透過 Proxy 執行，防火牆通訊埠已開啟
• ForgeRock OpenAM 的特殊權限 (例如 amAdmin)

取得 Google SecOps 擷取驗證檔案

1. 登入 Google SecOps 控制台。
2. 依序前往「SIEM 設定」>「收集代理程式」。
3. 下載擷取驗證檔案。將檔案安全地儲存在要安裝 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. 開啟具有根層級或 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 的 /etc/bindplane-agent/ 目錄，或 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:
           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: 'OPENAM'
               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. 將 /path/to/ingestion-authentication-file.json 更新為「取得 Google SecOps 擷取驗證檔案」一節中驗證檔案的儲存路徑。

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

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

  sudo systemctl restart bindplane-agent
  

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

  net stop BindPlaneAgent && net start BindPlaneAgent
  

在 Forgerock OpenAM 中設定稽核記錄

1. 登入 AM 控制台。
2. 依序前往「設定」>「全域服務」>「稽核記錄」。
3. 啟用稽核記錄，即可開始使用稽核記錄功能。
4. 在「欄位許可清單篩選器」和「欄位封鎖清單篩選器」清單中，輸入要納入 (許可清單) 或排除 (封鎖清單) 稽核事件記錄的值。
5. 按一下 [儲存]。

設定 Forgerock OpenAM 的系統記錄處理常式

1. 以管理員身分登入 AM 控制台，例如 amAdmin。
2. 如要在全域設定中建立事件處理常式，請依序前往「設定」>「全域服務」>「稽核記錄」。
3. 如要在領域中建立事件處理常式，請依序前往「領域」>「領域名稱」>「服務」>「稽核記錄」。
4. 按一下「Add a Secondary Configuration」>「Syslog」。
5. 提供下列設定詳細資料：
   • 名稱：輸入事件處理常式的名稱 (例如 Google SecOps Syslog Event Handler)。
   • 伺服器主機名稱：輸入 Bindplane 代理程式 IP 位址。
   • 伺服器通訊埠：輸入 Bindplane 代理程式通訊埠編號 (例如 UDP 的 514)。
   • 傳輸通訊協定：選取 UDP。
   • 連線逾時：輸入連線秒數 (例如 120)。
   • 選用：啟用「緩衝」選項。
6. 點選「建立」。
7. 建立系統記錄稽核事件處理常式後，會顯示多個設定分頁。
8. 在「General Handler Configuration」(一般處理常式設定) 分頁中，選取「Enabled」(已啟用) 啟用事件處理常式 (如果已停用)。
9. 選取稽核記錄的主題：
   • 存取
   • 活動
   • 驗證
   • 設定
10. 按一下 [儲存]。
11. 在「Syslog Configuration」(系統記錄設定) 分頁中，提供下列設定詳細資料：
    • 伺服器主機名稱：輸入 Bindplane 代理程式 IP 位址。
    • 伺服器通訊埠：輸入 Bindplane 代理程式通訊埠號碼。
    • 連線逾時：輸入連線秒數 (例如 120)。
    • 傳輸通訊協定：選取「UDP」。
    • 設施：選取「Local0」Local0。
    • 所有主題的嚴重程度都設為「資訊」。
12. 按一下 [儲存]。

13. 在「緩衝」分頁中，選取「已啟用緩衝」即可啟用。

14. 按一下 [儲存]。

UDM 對應表

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