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

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

收集 Veridium ID 記錄

支援的國家/地區：

Google SecOps SIEM

本文說明如何使用 Bindplane 代理程式，將 Veridium ID 記錄擷取至 Google Security Operations。

Veridium ID 是一種生物特徵辨識驗證平台，會針對驗證事件、帳戶管理、裝置註冊和管理動作產生系統記錄訊息。剖析器會使用 grok 模式和鍵/值剖析功能，從系統記錄訊息中擷取欄位，並將這些欄位對應至整合式資料模型 (UDM)。

事前準備

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

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

取得 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 nano /opt/observiq-otel-collector/config.yaml

Windows：

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

編輯設定檔

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

receivers:
    tcplog:
        listen_address: "0.0.0.0:514"

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

service:
    pipelines:
        logs/veridium_id_to_chronicle:
            receivers:
                - tcplog
            exporters:
                - chronicle/veridium_id

設定參數

替換下列預留位置：

接收器設定：
- listen_address：要接聽的 IP 位址和通訊埠：
  - 0.0.0.0，監聽所有介面 (建議)
  - 通訊埠 514 是標準的系統記錄通訊埠 (在 Linux 上需要根層級權限；非根層級權限請使用 1514)
  - Veridium ID 使用 TCP (rsyslog 中的 @@)，因此必須有 tcplog 接收器
匯出工具設定：
- creds_file_path：擷取驗證檔案的完整路徑：
  - Linux：/etc/bindplane-agent/ingestion-auth.json
  - Windows：C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- customer_id：從 Google SecOps 控制台複製的客戶 ID
- endpoint：區域端點網址：
  - 美國：malachiteingestion-pa.googleapis.com
  - 歐洲：europe-malachiteingestion-pa.googleapis.com
  - 亞洲：asia-southeast1-malachiteingestion-pa.googleapis.com
  - 如需完整清單，請參閱「區域端點」

儲存設定檔

編輯完成後，請儲存檔案：
- 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. 按一下滑鼠右鍵，然後選取「重新啟動」。
  4. 確認服務正在執行：
```
sc query observiq-otel-collector
```
  5. 檢查記錄中是否有錯誤：
```
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
```

設定 Veridium ID 的系統記錄檔

使用 SSH 或 CLI 登入 Veridium ID 主機。
編輯 /etc/rsyslog.conf 或 /etc/rsyslog.d/events.conf 檔案：
```
vi /etc/rsyslog.conf
```

新增下列設定，並將 <bindplane-ip> 和 <bindplane-port> 替換為實際的 Bindplane 代理程式詳細資料：

module(load="imfile" PollingInterval="10")

input(type="imfile"
  File="/var/log/veridiumid/websecadmin/events.log"
  Tag="ver-adminevents"
  reopenOnTruncate="on")

input(type="imfile"
  File="/var/log/veridiumid/tomcat/events.log"
  Tag="ver-events"
  reopenOnTruncate="on")

if $programname == 'ver-events' then @@<bindplane-ip>:<bindplane-port>
if $programname == 'ver-adminevents' then @@<bindplane-ip>:<bindplane-port>

儲存檔案並結束。

UDM 對應表

記錄欄位	UDM 對應	邏輯
`_caller.accountId`	`principal.user.userid`	直接從「`_caller.accountId`」欄位對應。
`_caller.accountEmailAddressInfo`	`principal.user.email_addresses`	直接從「`_caller.accountEmailAddressInfo`」欄位對應。
`_caller.accountExternalId`	`principal.user.email_addresses`	直接從「`_caller.accountExternalId`」欄位對應。
`_caller.accountStatus`	`principal.user.attribute.labels[account_status].value`	直接從「`_caller.accountStatus`」欄位對應。
`_caller.deviceId`	`principal.asset.asset_id`	前置字串為「VERIDIUM_ID:」，且對應至 `_caller.deviceId` 欄位。
`_caller.deviceDescription`	`principal.asset.attribute.labels[device_description].value`	直接從「`_caller.deviceDescription`」欄位對應。
`_caller.deviceManufacturer`	`principal.asset.attribute.labels[device_manufacturer].value`	直接從「`_caller.deviceManufacturer`」欄位對應。
`_caller.deviceName`	`principal.asset.attribute.labels[device_name].value`	直接從「`_caller.deviceName`」欄位對應。
`_caller.deviceOs`	`principal.asset.platform_software.platform`	從 `_caller.deviceOs` 欄位對應。如果值為「iOS」，則會對應至「IOS」。如果值為「Android」，則會對應至「ANDROID」。如果值為「WIN」或「Windows」，則會對應至「WINDOWS」。
`_caller.deviceStatus`	`principal.asset.attribute.labels[device_status].value`	直接從「`_caller.deviceStatus`」欄位對應。
`_caller.deviceType`	`principal.asset.attribute.labels[device_type].value`	直接從「`_caller.deviceType`」欄位對應。
`actionDate`	`additional.fields[action_date].value.string_value`	直接從「`actionDate`」欄位對應。
`actionName`	`metadata.product_event_type`	直接從「`actionName`」欄位對應。
`accountEmail`	`principal.user.email_addresses`	直接從「`accountEmail`」欄位對應。
`accountExternalId`	`principal.user.email_addresses`	直接從「`accountExternalId`」欄位對應。
`accountId`	`principal.user.userid`	直接從「`accountId`」欄位對應。
`authenticatorDeviceContext.deviceMake`	`intermediary.asset.hardware.manufacturer`	直接從「`authenticatorDeviceContext.deviceMake`」欄位對應。
`authenticatorDeviceContext.ip`	`intermediary.ip`	直接從「`authenticatorDeviceContext.ip`」欄位對應。
`authenticatorDeviceContext.location.city`	`intermediary.asset.location.city`	直接從「`authenticatorDeviceContext.location.coordinates.latitude`」欄位對應。
`authenticatorDeviceContext.location.coordinates.latitude`	`intermediary.asset.location.region_latitude`	直接從「`authenticatorDeviceContext.location.coordinates.latitude`」欄位對應。
`authenticatorDeviceContext.location.coordinates.longitude`	`intermediary.asset.location.region_longitude`	直接從「`authenticatorDeviceContext.location.coordinates.longitude`」欄位對應。
`authenticatorDeviceContext.location.countryName`	`intermediary.asset.location.country_or_region`	直接從「`authenticatorDeviceContext.location.countryName`」欄位對應。
`authenticatorDeviceContext.location.ip`	`intermediary.ip`	直接從「`authenticatorDeviceContext.location.ip`」欄位對應。
`authenticationDeviceDescription`	`intermediary.asset.attribute.labels[authentication_device_description].value`	直接從「`authenticationDeviceDescription`」欄位對應。
`authenticationDeviceName`	`intermediary.asset.asset_id`	前置字串為「VERIDIUM_ID:」，且對應至 `authenticationDeviceName` 欄位。
`authenticationDeviceOs`	`intermediary.asset.platform_software.platform`	從 `authenticationDeviceOs` 欄位對應。如果值為「iOS」，則會對應至「IOS」。如果值為「Android」，則會對應至「ANDROID」。如果值為「WIN」或「Windows」，則會對應至「WINDOWS」。
`authenticationDeviceOsVersion`	`intermediary.asset.platform_software.platform_version`	直接從「`authenticationDeviceOsVersion`」欄位對應。
`authenticationDevicePhone`	`intermediary.asset.attribute.labels[authentication_device_phone].value`	直接從「`authenticationDevicePhone`」欄位對應。
`authenticationDevicePhoneModel`	`intermediary.asset.attribute.labels[authentication_device_phone_model].value`	直接從「`authenticationDevicePhoneModel`」欄位對應。
`authenticationDeviceRegistrationTime`	`intermediary.asset.attribute.labels[authentication_device_registeration_time].value`	直接從「`authenticationDeviceRegistrationTime`」欄位對應。
`authenticationDeviceType`	`intermediary.asset.attribute.labels[authentication_device_type].value`	直接從「`authenticationDeviceType`」欄位對應。
`authenticationResult`	`extensions.auth.auth_details`	直接從「`authenticationResult`」欄位對應。
`context.deviceMake`	`principal.asset.hardware.manufacturer`	直接從「`context.deviceMake`」欄位對應。
`context.ip`	`principal.ip`	直接從「`context.ip`」欄位對應。
`context.location.countryName`	`principal.location.country_or_region`	直接從「`context.location.countryName`」欄位對應。
`context.location.ip`	`principal.ip`	直接從「`context.location.ip`」欄位對應。
`context.osVersion`	`principal.asset.platform_software.platform_version`	直接從「`context.osVersion`」欄位對應。
`context.userAgentRaw`	`network.http.user_agent`	直接從「`context.userAgentRaw`」欄位對應。
`exploiterDeviceContext.deviceMake`	`src.asset.hardware.manufacturer`	直接從「`exploiterDeviceContext.deviceMake`」欄位對應。
`exploiterDeviceContext.ip`	`src.ip`	直接從「`exploiterDeviceContext.ip`」欄位對應。
`exploiterDeviceContext.location.city`	`src.asset.location.city`	直接從「`exploiterDeviceContext.location.city`」欄位對應。
`exploiterDeviceContext.location.coordinates.latitude`	`src.asset.location.region_latitude`	直接從「`exploiterDeviceContext.location.coordinates.latitude`」欄位對應。
`exploiterDeviceContext.location.coordinates.longitude`	`src.asset.location.region_longitude`	直接從「`exploiterDeviceContext.location.coordinates.longitude`」欄位對應。
`exploiterDeviceContext.location.countryName`	`src.asset.location.country_or_region`	直接從「`exploiterDeviceContext.location.countryName`」欄位對應。
`exploiterDeviceContext.location.ip`	`src.ip`	直接從「`exploiterDeviceContext.location.ip`」欄位對應。
`exploiterDeviceContext.osName`	`src.asset.platform_software.platform`	從 `exploiterDeviceContext.osName` 欄位對應。如果值為「WIN」或「Windows」，則會對應至「WINDOWS」。如果值為「iOS」，則會對應至「IOS」。如果值為「Android」，則會對應至「ANDROID」。
`exploiterDeviceContext.osVersion`	`src.asset.platform_software.platform_version`	直接從「`exploiterDeviceContext.osVersion`」欄位對應。
`exploiterDeviceName`	`src.asset.attribute.labels[exploiter_device_name].value`	直接從「`exploiterDeviceName`」欄位對應。
`hostname`	`principal.hostname`	直接從「`hostname`」欄位對應。
`ipAddress`	`principal.ip`	直接從「`ipAddress`」欄位對應。
`location`	`principal.location.city`	直接從「`location`」欄位對應。
`location.city`	`about.location.city`	直接從「`location.city`」欄位對應。
`location.coordinates.latitude`	`about.location.region_latitude`	直接從「`location.coordinates.latitude`」欄位對應。
`location.coordinates.longitude`	`about.location.region_longitude`	直接從「`location.coordinates.longitude`」欄位對應。
`location.countryName`	`about.location.country_or_region`	直接從「`location.countryName`」欄位對應。
`location.ip`	`about.ip`	直接從「`location.ip`」欄位對應。
`metadata.collected_timestamp`	`metadata.collected_timestamp`	直接從「`collected_time`」欄位對應。
`metadata.event_timestamp`	`metadata.event_timestamp`	直接從「`event_time`」欄位對應。
`metadata.event_type`	`metadata.event_type`	設為「USER_UNCATEGORIZED」。
`metadata.product_event_type`	`metadata.product_event_type`	直接從「`actionName`」欄位對應。
`metadata.product_name`	`metadata.product_name`	設為「VERIDIUM_ID」。
`namespace`	`principal.namespace`	直接從「`namespace`」欄位對應。
`pid`	`principal.process.pid`	直接從「`pid`」欄位對應。
`request.context.userAgentRaw`	`network.http.user_agent`	直接從「`request.context.userAgentRaw`」欄位對應。
`request.sessionId`	`network.session_id`	直接從「`request.sessionId`」欄位對應。
`requestMethod`	`network.http.method`	直接從「`requestMethod`」欄位對應。
`requestURI`	`network.http.referral_url`	直接從「`requestURI`」欄位對應。
`security_result.severity`	`security_result.severity`	從 `severity` 欄位對應。如果值為「INFO」，則會對應至「INFORMATIONAL」。
	`principal.application`	直接從「`application`」欄位對應。
	`principal.asset.hostname`	直接從「`hostname`」欄位對應。

變更記錄

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

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