收集 ForgeRock OpenAM 記錄

本文說明如何使用 Bindplane，將 ForgeRock OpenAM 記錄匯入 Google 安全作業。剖析器會從 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. 開啟具有 root 或 sudo 權限的終端機。

2. 執行下列指令：

   sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
   

其他安裝資源

如需其他安裝選項，請參閱安裝指南。

設定 Bindplane 代理程式，以便擷取 syslog 並傳送至 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. 在「取得 Google SecOps 攝入驗證檔案」部分，將 /path/to/ingestion-authentication-file.json 更新為驗證檔案的儲存路徑。

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

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

  sudo systemctl restart bindplane-agent
  

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

  net stop BindPlaneAgent && net start BindPlaneAgent
  

在 ForgeRock OpenAM 中設定稽核記錄

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

設定 Forgerock OpenAM 的 Syslog 處理常式

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

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

14. 按一下 [儲存]。

UDM 對應表

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