我們重新調整了說明文件的導覽結構，直接對應您的作業工作流程。詳情請參閱版本資訊和逐步解說影片。

Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

收集 LogonBox 記錄

支援的國家/地區：

Google SecOps SIEM

本文說明如何使用 Bindplane，將 LogonBox 記錄檔擷取至 Google Security Operations。

LogonBox 是自助式密碼管理和身分驗證平台，可產生密碼重設、身分驗證事件和管理員動作的稽核記錄。剖析器會將 LogonBox 稽核資料對應至統一資料模型 (UDM)，擷取使用者身分、驗證事件、資源修改和群組管理作業。

事前準備

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

Google SecOps 執行個體
Windows Server 2016 以上版本，或搭載 systemd 的 Linux 主機
Bindplane 代理程式與 LogonBox 伺服器之間的網路連線
如果透過 Proxy 執行，請確保防火牆通訊埠已根據 Bindplane 代理程式需求開啟
LogonBox 管理控制台的特殊存取權

取得 Google SecOps 擷取驗證檔案

登入 Google SecOps 控制台。
依序前往「SIEM 設定」>「收集代理程式」。
下載擷取驗證檔案，並將檔案安全地儲存在要安裝 Bindplane 的系統中。

注意： 這個 JSON 檔案包含驗證 Bindplane 代理程式與 Google SecOps 的憑證。

取得 Google SecOps 客戶 ID

登入 Google SecOps 控制台。
依序前往「SIEM 設定」>「設定檔」。
複製並儲存「機構詳細資料」部分中的客戶 ID。

注意： 設定 Bindplane 代理程式匯出工具時，必須提供客戶 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-collector

Windows：

notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"

編輯設定檔

將 config.yaml 的所有內容替換為下列設定：

receivers:
    udplog:
        listen_address: "0.0.0.0:514"

exporters:
    chronicle/logonbox:
        compression: gzip
        creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: LOGONBOX
        raw_log_field: body

service:
    pipelines:
        logs/logonbox:
            receivers:
                - udplog
            exporters:
                - chronicle/logonbox

設定參數

替換下列預留位置：

接收器設定：
- udplog：根據通訊協定的接收器類型：
  - udplog (適用於 UDP 系統記錄檔)
  - tcplog 適用於 TCP Syslog
  - syslog 適用於 RFC 3164/5424 syslog
- 0.0.0.0：要接聽的 IP 位址：
  - 0.0.0.0，監聽所有介面 (建議)
  - 在一個介面上接聽的特定 IP 位址
- 514：要接聽的通訊埠號碼 (例如 514、1514、6514)
匯出工具設定：
- <customer_id>：先前步驟中的客戶 ID
- malachiteingestion-pa.googleapis.com：區域端點網址：
  - 美國：malachiteingestion-pa.googleapis.com
  - 歐洲：europe-malachiteingestion-pa.googleapis.com
  - 亞洲：asia-southeast1-malachiteingestion-pa.googleapis.com
  - 如需完整清單，請參閱「區域端點」
- 根據平台調整 creds_file_path：
  - Linux：/etc/bindplane-agent/ingestion-auth.json
  - Windows：C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json

儲存設定檔

編輯完成後，請儲存檔案：
- Linux：依序按下 Ctrl+O、Enter 和 Ctrl+X
- Windows：依序點選「檔案」>「儲存」

重新啟動 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
```
- 服務控制台：
  1. 按下 Win+R，輸入 services.msc，然後按下 Enter 鍵。
  2. 找出 observIQ OpenTelemetry Collector。
  3. 按一下滑鼠右鍵，然後選取「重新啟動」。
確認服務正在執行：
```
sc query observiq-otel-collector
```

檢查記錄中是否有錯誤：

type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"

設定 LogonBox 系統記錄轉送

以管理員身分登入 LogonBox 管理控制台。
依序前往「報表」>「稽核記錄」。
設定 Syslog 匯出設定：
- 系統記錄檔伺服器：輸入 Bindplane 代理程式主機的 IP 位址 (例如 192.168.1.100)。
- 「Port」(通訊埠)：輸入 514 (必須與 Bindplane 接收器通訊埠相符)。
- 「通訊協定」：選取「UDP」 (必須與 Bindplane 接收器類型相符)。
選取要轉送的事件類別 (例如密碼重設、身分驗證、使用者和群組管理)。
按一下 [儲存]。

UDM 對應表

記錄欄位	UDM 對應	邏輯
	additional.fields	根據條件，從 attr_associatedPrincipals_label、sAMAccountName_label、attr_local_label、msDS-PrincipalName_label、attr_realmType_label、attr_selfCreated_label、attr_administrative_label 合併
attr_principalDesc、desc	metadata.description	如果 product_event_type 符合 changePassword\|SessionService，則為 attr_principalDesc 的值；否則，如果 attr_principalDesc 不為空，則為該值；否則為 desc 的值
event_type	metadata.event_type	條件邏輯根據 product_event_type 和存在性旗標設定 event_type 後，直接複製的值
product_event_type	metadata.product_event_type	直接複製值
	metadata.product_name	設為「LogonBox」
	metadata.vendor_name	設為「LOGONBOX」
	network.application_protocol	如果 product_event_type 符合 AnswerService 且符合條件，則設為「DNS」
dns_answer	network.dns.answers	從 dns_answer 合併
dns_question	network.dns.questions	從 dns_question 合併
attr_userAgent、attr_userAgentVersion	network.http.parsed_user_agent	如果 attr_userAgent 和 attr_userAgentVersion 都存在，則會從這兩者串連，否則會從 attr_userAgent 串連，然後轉換為 parseduseragent 並重新命名
attr_userAgent、attr_userAgentVersion	network.http.user_agent	如果 attr_userAgent 和 attr_userAgentVersion 都存在，則從這兩者串連，否則從 attr_userAgent 串連
主機名稱	principal.asset.hostname	直接複製值
attr_ipAddress	principal.asset.ip	直接複製值
主機名稱	principal.hostname	直接複製值
attr_ipAddress	principal.ip	直接複製值
attr_os	principal.platform	如果符合 (?i)LINUX\|MAC\|WINDOWS，則會設為大寫
attr_osVersion	principal.platform_version	如果不符合 (?i)unknown，則直接複製值
attr_principalRealm_label、attr_unassignedRoles_label、attr_assignedRoles_label、attr_oldResourceName_label、attr_roles_label、attr_resumedPrincipalName_label、attr_resumedPrincipalRealm_label、attr_resumedPrincipal_label、attr_module_label、reconcile_map_label、users_map_label、groups_map_label、createUser_map_label、user_map_label、mobile_map_label	principal.resource.attribute.labels	根據條件，從 attr_principalRealm、attr_unassignedRoles、attr_assignedRoles、attr_oldResourceName、attr_roles、attr_resumedPrincipalName、attr_resumedPrincipalRealm、attr_resumedPrincipal、attr_module 合併，以及從 reconcile、users、groups、createUser、user、mobile 合併對應項
attr_resourceName	principal.resource.name	直接複製值
attr_resourceId	principal.resource.product_object_id	直接複製值
郵件	principal.user.email_addresses	如果郵件是有效的電子郵件，則會合併
ImmutableID、attr_uuid	principal.user.product_object_id	如果 product_event_type 符合 changePassword\|userUpdated\|userCreated\|setPassword\|answer\|accountUnlockNoSuspension，則為 ImmutableID 的值，否則為 attr_uuid 的值
attr_scheme	principal.user.role_name	直接複製值
attr_principalDesc	principal.user.user_display_name	如果 product_event_type 符合 changePassword\|SessionService，則直接複製值
attr_principalName	principal.user.userid	直接複製值
authy_code_length_label、authy_window_length_label、authy_step_size_label、msauthenticator_code_length_label、msauthenticator_window_length_label、msauthenticator_step_size_label、googleUser_code_length_label、googleUser_window_length_label、googleUser_step_size_label	security_result.detection_fields	如果存在，則從 authy.code.length、authy.window.length、authy.step.size、msauthenticator.code.length、msauthenticator.window.length、msauthenticator.step.size、googleUser.code.length、googleUser.window.length、googleUser.step.size 建立的標籤會合併
cn	target.resource.attribute.labels	從 cn 建立的 full_name_label，以及從 attr_disabledRealm 建立的 attr_disabledRealm_label 合併而來
attr_lastModified	target.resource.attribute.last_update_time	使用 ISO8601 或 d MMM yyyy HH:mm:ss 從 attr_lastModified 剖析的日期
attr_created	target.resource.attribute.creation_time	使用 ISO8601 或 d MMM yyyy HH:mm:ss 從 attr_created 剖析的日期
givenName	target.user.first_name	直接複製值
ou	target.user.group_identifiers	如果 product_event_type 符合 userUpdated\|userCreated\|changePassword\|setPassword\|answer\|accountUnlockNoSuspension，則從 OU 合併
sn	target.user.last_name	直接複製值
attr_uuid、attr_disabledPrincipal	target.user.product_object_id	如果 product_event_type 符合 userUpdated\|userCreated\|changePassword\|setPassword\|answer\|accountUnlockNoSuspension 或 groupCreated\|groupUpdated 或 attr_group 或 group，則為 attr_uuid 的值；如果 accountDisabled，則為 attr_disabledPrincipal 的值
displayName、description	target.user.user_display_name	如果 displayName 不為空，則為 displayName 的值；如果 product_event_type 符合 userUpdated\|userCreated\|changePassword\|setPassword\|answer\|accountUnlockNoSuspension，則為 description 的值
userPrincipalName、attr_user、attr_associatedPrincipals、attr_disabledPrincipalName	target.user.userid	如果 product_event_type 符合 userUpdated\|userCreated\|changePassword\|setPassword\|answer\|accountUnlockNoSuspension，則為 userPrincipalName 的值；如果未設定，則為 attr_user；如果為 groupCreated\|groupUpdated 或 attr_group，則為 attr_associatedPrincipals；如果為群組，則為 attr_user；如果為 accountDisabled，則為 attr_disabledPrincipalName
attr_group	target.group.group_display_name	如果 product_event_type 與 groupCreated\|groupUpdated 相符，或存在 attr_group，則直接複製值
attr_uuid	target.group.product_object_id	如果 product_event_type 與 groupCreated\|groupUpdated 相符，或存在 attr_group，則直接複製值

變更記錄

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

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