收集 One Identity Identity Manager 記錄
本文說明如何使用 Bindplane,將 One Identity Identity Manager 記錄擷取至 Google Security Operations。
One Identity Identity Manager 是一種身分管理與控管 (IGA) 平台,可管理混合式環境中的使用者身分、存取權和法規遵循情形。這項服務提供自動佈建、存取要求、驗證和政策強制執行功能,並內建通用 SIEM 轉送站,可匯出事件。
事前準備
請確認您已完成下列事前準備事項:
- Google SecOps 執行個體
- Windows Server 2016 以上版本,或搭載
systemd的 Linux 主機 - Bindplane 代理程式與 One Identity Identity Manager 伺服器之間的網路連線
- 如果透過 Proxy 執行,請確保防火牆通訊埠已根據 Bindplane 代理程式需求開啟
- 具備管理員權限,可存取 One Identity Identity Manager 管理控制台
- 已安裝 Universal SIEM Forwarder 模組的 One Identity Identity Manager 8.x 以上版本
取得 Google SecOps 擷取驗證檔案
- 登入 Google SecOps 控制台。
- 依序前往「SIEM 設定」>「收集代理程式」。
下載擷取驗證檔案,並將檔案安全地儲存在要安裝 Bindplane 的系統中。
取得 Google SecOps 客戶 ID
- 登入 Google SecOps 控制台。
- 依序前往「SIEM 設定」>「設定檔」。
複製並儲存「機構詳細資料」部分中的客戶 ID。
安裝 Bindplane 代理程式
請按照下列操作說明,在 Windows 或 Linux 作業系統上安裝 Bindplane 代理程式。
Windows 安裝
- 以管理員身分開啟「命令提示字元」或「PowerShell」。
執行下列指令:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet等待安裝完成。
執行下列指令,確認安裝成功:
sc query observiq-otel-collector
服務應顯示為「RUNNING」。
Linux 安裝
- 開啟具有根層級或 sudo 權限的終端機。
執行下列指令:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh等待安裝完成。
執行下列指令,確認安裝成功:
sudo systemctl status observiq-otel-collector
服務應顯示為有效 (執行中)。
其他安裝資源
如需其他安裝選項和疑難排解資訊,請參閱 Bindplane 代理程式安裝指南。
設定 Bindplane 代理程式,擷取系統記錄檔並傳送至 Google SecOps
找出設定檔
Linux:
sudo systemctl status observiq-otel-collectorWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
編輯設定檔
將
config.yaml的所有內容替換為下列設定:receivers: tcplog: listen_address: "0.0.0.0:514" exporters: chronicle/one_identity_idm: compression: gzip creds_file_path: '<CREDS_FILE_PATH>' customer_id: '<CUSTOMER_ID>' endpoint: <REGION_ENDPOINT> log_type: ONE_IDENTITY_IDENTITY_MANAGER raw_log_field: body ingestion_labels: env: production service: pipelines: logs/one_identity_idm_to_chronicle: receivers: - tcplog exporters: - chronicle/one_identity_idm
設定參數
替換下列預留位置:
接收器設定:
tcplog:透過 TCP 接收系統記錄。通用 SIEM 轉送器支援 TCP,可確保傳送可靠性。0.0.0.0:514:在通訊埠 514 上監聽所有介面。視需要變更通訊埠 (例如,非根 Linux 的通訊埠為1514)。
匯出工具設定:
<CREDS_FILE_PATH>:擷取驗證檔案的完整路徑:- Linux:
/etc/bindplane-agent/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
<CUSTOMER_ID>:從「取得 Google Security Operations 客戶 ID」步驟取得的客戶 ID。<REGION_ENDPOINT>:區域端點網址:- 美國:
malachiteingestion-pa.googleapis.com - 歐洲:
europe-malachiteingestion-pa.googleapis.com - 亞洲:
asia-southeast1-malachiteingestion-pa.googleapis.com - 如需完整清單,請參閱「區域端點」。
- 美國:
儲存設定檔
- 編輯完成後,請儲存檔案:
- Linux:依序按下
Ctrl+O、Enter和Ctrl+X - Windows:依序點選「檔案」>「儲存」
- Linux:依序按下
重新啟動 Bindplane 代理程式,以套用變更
如要在 Linux 中重新啟動 Bindplane 代理程式,請執行下列步驟:
執行下列指令:
sudo systemctl restart observiq-otel-collector確認服務正在執行:
sudo systemctl status observiq-otel-collector檢查記錄中是否有錯誤:
sudo journalctl -u observiq-otel-collector -f
如要在 Windows 中重新啟動 Bindplane 代理程式,請按照下列步驟操作:
您可以選擇下列其中一個選項:
- 以管理員身分開啟命令提示字元或 PowerShell:
net stop observiq-otel-collector && net start observiq-otel-collector- 服務控制台:
- 按下
Win+R,輸入services.msc,然後按下 Enter 鍵。 - 找出 observIQ OpenTelemetry Collector。
- 按一下滑鼠右鍵,然後選取「重新啟動」。
- 按下
確認服務正在執行:
sc query observiq-otel-collector檢查記錄中是否有錯誤:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
設定 One Identity Identity Manager 系統記錄檔轉送
One Identity Identity Manager 包含 Universal SIEM Forwarder,可透過 syslog 以 JSON、CEF 或 JSON-CIM 格式匯出稽核和身分識別生命週期事件。
- 登入 One Identity Manager Administration Console (管理員或設計工具)。
- 依序前往「基礎資料」>「一般」>「設定參數」。
- 找出「QER\Person\Siem」設定部分。
- 將「Enabled」參數設為
True,即可啟用通用 SIEM 轉送器。 - 設定系統記錄目的地:
- SyslogHost:輸入 Bindplane 代理程式主機的 IP 位址 (例如
192.168.1.100)。 - SyslogPort:輸入
514(必須與 Bindplane 代理程式接收器通訊埠相符)。 - SyslogProtocol:選取「TCP」。
- SyslogFormat:選取「JSON」 (建議使用,可確保最高剖析準確度)。
- SyslogHost:輸入 Bindplane 代理程式主機的 IP 位址 (例如
- 設定要轉送的事件類型:
- PersonEvents:設為
True,轉送身分生命週期事件 (建立、修改、刪除)。 - EntitlementEvents:設為
True,轉送存取權指派和移除事件。 - PolicyEvents:設為
True,轉送政策違規和驗證事件。 - SystemEvents:設為
True可轉送佈建和同步事件。
- PersonEvents:設為
- 按一下「儲存」,儲存設定。
- 重新啟動 One Identity Manager Service,變更才會生效。
檢查 Bindplane 代理程式記錄,確認記錄是否已傳送。
UDM 對應表
| 記錄欄位 | UDM 對應 | 邏輯 |
|---|---|---|
| ImportCompleted、MembersCount、SchedulerTriggerId、JobThreadCount、JobMessage、JobExitCode、TriggerVetoed、TriggerMisfired、JobException、ErrorCount、IdentityProviderName、AuditLogUri、ApplianceId、AssetName、AssetPartitionName、TaskId、SystemId、SystemName、AssetPartitionId、DurationInMinutes、OfflineWorkflowMode、RequiredDate、WasCheckedOut、ApproverAccessRequestUri、ReviewerAccessRequestUri、_DB_HOST、Enabled、UID_ConfigParm、XOrigin、Ident_AERole、UID_Person | additional.fields | 從各個欄位合併為鍵/值組合 |
| RequesterAccessRequestUri | extensions.auth.auth_details | 直接複製值 |
| user_login、user_logout | extensions.auth.type | 如果 user_login 或 user_logout 為 true,請設為 AUTHTYPE_UNSPECIFIED |
| 主機名稱 | intermediary.hostname | 設定主機名稱是否為 IP |
| 主機名稱 | intermediary.ip | 設定主機名稱是否為 IP |
| 時間 | metadata.collected_timestamp | 從 ISO8601 時間戳記轉換 |
| EventDescription | metadata.description | 直接複製值 |
| EventTimestamp、MessageDate、XDateUpdated、XDateInserted | metadata.event_timestamp | 從 UNIX_MS 轉換,優先順序為 XDateInserted > XDateUpdated > MessageDate > EventTimestamp |
| has_principal、has_target_resource、has_user、user_login、user_logout、has_target_user | metadata.event_type | 如果具有主體、目標資源、使用者和使用者登入,則設為 USER_LOGIN;如果具有主體、目標資源、使用者和使用者登出,則設為 USER_LOGOUT;如果具有目標使用者或使用者,則設為 USER_UNCATEGORIZED;如果具有主體,則設為 STATUS_UPDATE;否則設為 GENERIC_EVENT |
| EventDisplayName、XUserInserted、UID_ConfigParm、XDateInserted、XOrigin | metadata.product_event_type | EventDisplayName 中的值,如果 XUserInserted 和 UID_ConfigParm 不為空白,則會由「Configuration Changed」覆寫;如果 XDateInserted 和 XOrigin 不為空白,則會由「User added to group」覆寫 |
| IdentityProviderId | metadata.product_log_id | 直接複製值 |
| 版本 | metadata.product_version | 直接複製值 |
| EventUserDomainName | principal.administrative_domain | 直接複製值 |
| app_name、ApplicationName | principal.application | 如果 ApplicationName 不是空白,則為該值,否則為 app_name |
| HostName | principal.asset.hostname | 直接複製值 |
| AuthClientMachine | principal.asset.ip | 從 AuthClientMachine 擷取的 IP |
| AssetId | principal.asset_id | 串連為「AssetId:%{AssetId}」 |
| HostName | principal.hostname | 直接複製值 |
| AuthClientMachine | principal.ip | 從 AuthClientMachine 擷取的 IP |
| process_id | principal.process.pid | 直接複製值 |
| AccountDistinguishedName | principal.user.attribute.roles | 設為名稱為 AccountDistinguishedName 的物件 |
| 電子郵件 | principal.user.email_addresses | 如果符合 ^.+@.+$,則合併 |
| RequestId、UserGroupName | principal.user.product_object_id | 如果 UserGroupName 不是空白,則為 UserGroupName 的值,否則為 RequestId |
| EventUserDisplayName | principal.user.user_display_name | 直接複製值 |
| EventUserName、UserGroupId、User、XUserInserted、Assignor | principal.user.userid | 如果「指派者」的值不為空,則為該值;否則如果「XUserInserted」的值不為空,則為該值;否則如果「使用者」的值不為空,則為該值;否則如果「UserGroupId」的值不為空,則為該值;否則為「EventUserName」 |
| SuccessInfo | security_result.category_details | 直接複製值 |
| MessageString | security_result.description | 直接複製值 |
| UID_DialogJournal、ApplicationIntent、IsLogOff、AuthIdentity、AuthModule | security_result.detection_fields | 與各個領域的標籤合併 |
| AccountDomainName | target.administrative_domain | 直接複製值 |
| AccessRequestType | target.application | 直接複製值 |
| AssetNetworkAddress | target.asset.hostname | 直接複製值 |
| AssetPlatformType | target.asset.platform_software.platform | 如果符合「(?i)Windows」,請設為 WINDOWS |
| AssetNetworkAddress、AssetId | target.asset_id | 串連為「AssetNetworkAddress:%{AssetId}」 |
| 完整路徑 | target.file.full_path | 直接複製值 |
| AssetNetworkAddress | target.hostname | 直接複製值 |
| _DB_NAME、databasename、_DB_DRIVER、_DB_PORT | target.resource.attribute.labels | 與 _DB_NAME 或 databasename 中的 db_name、_DB_DRIVER 中的 db_driver、_DB_PORT 中的 db_port 合併 |
| EventUserId | target.user.product_object_id | 直接複製值 |
| AccountName、Receiver | target.user.user_display_name | 如果接收者值不為空,則為該值,否則為帳戶名稱 |
| AccountId、XUserUpdated、CentralAccount | target.user.userid | 如果值不為空,則為 CentralAccount;如果值為空,則為 XUserUpdated;如果值為空,則為 AccountId |
| metadata.product_name | 設為「ONE_IDENTITY_IDENTITY_MANAGER」 | |
| metadata.vendor_name | 設為「ONE_IDENTITY」 |
變更記錄
還有其他問題嗎?向社群成員和 Google SecOps 專業人員尋求答案。