收集 SecureAuth Identity Platform 記錄
支援的國家/地區:
Google SecOps
SIEM
本文說明如何使用 Bindplane,將 SecureAuth Identity Platform 記錄擷取至 Google Security Operations。剖析器會使用 grok 和 XML 篩選器,從各種記錄格式 (SYSLOG、XML、鍵/值組合) 擷取欄位。接著,系統會將擷取的欄位對應至相應的 UDM (整合式資料模型) 屬性,並以安全事件內容擴充資料,以及將輸出內容標準化,以供進一步分析。
事前準備
- 確認您有 Google Security Operations 執行個體。
- 確認您使用的是 Windows 2016 以上版本,或是搭載
systemd
的 Linux 主機。 - 如果透過 Proxy 執行,請確認防火牆通訊埠已開啟。
- 確認您擁有 SecureAuth 的特殊權限。
取得 Google SecOps 擷取驗證檔案
- 登入 Google SecOps 控制台。
- 依序前往「SIEM 設定」>「收集代理程式」。
- 下載擷取驗證檔案。將檔案安全地儲存在要安裝 Bindplane 的系統上。
取得 Google SecOps 客戶 ID
- 登入 Google SecOps 控制台。
- 依序前往「SIEM 設定」>「設定檔」。
- 複製並儲存「機構詳細資料」專區中的客戶 ID。
安裝 Bindplane 代理程式
Windows 安裝
- 以系統管理員身分開啟「命令提示字元」或「PowerShell」。
執行下列指令:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
Linux 安裝
- 開啟具有根層級或 sudo 權限的終端機。
執行下列指令:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
其他安裝資源
- 如需其他安裝選項,請參閱這份安裝指南。
設定 Bindplane 代理程式,擷取系統記錄檔並傳送至 Google SecOps
存取設定檔:
- 找出
config.yaml
檔案。通常位於 Linux 的/etc/bindplane-agent/
目錄,或 Windows 的安裝目錄。 - 使用文字編輯器 (例如
nano
、vi
或記事本) 開啟檔案。
- 找出
按照下列方式編輯
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: '/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: SECUREAUTH_SSO raw_log_field: body service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labels
視基礎架構需求,替換通訊埠和 IP 位址。
將
<customer_id>
替換為實際的客戶 ID。將
/path/to/ingestion-authentication-file.json
更新為「取得 Google SecOps 擷取驗證檔案」一節中儲存驗證檔案的路徑。
重新啟動 Bindplane 代理程式,以套用變更
如要在 Linux 中重新啟動 Bindplane 代理程式,請執行下列指令:
sudo systemctl restart bindplane-agent
如要在 Windows 中重新啟動 Bindplane 代理程式,可以使用「服務」控制台,或輸入下列指令:
net stop BindPlaneAgent && net start BindPlaneAgent
設定 SecureAuth Identity Platform
- 登入 SecureAuth Identity 控制台。
- 選取「記錄」。
- 在「記錄選項」部分中,提供下列設定詳細資料:
- 記錄執行個體 ID:輸入記錄執行個體 ID、應用程式名稱或領域名稱,例如
SecureAuth1
。 - 稽核記錄:勾選「系統記錄」核取方塊。
- 錯誤記錄:勾選「Syslog」核取方塊。
- 系統記錄伺服器:輸入 Bindplane 代理程式的 IP 位址。
- 「系統記錄檔通訊埠」:輸入 Bindplane 代理程式通訊埠號碼,例如
514
。 - Syslog RFC 規格:選取 RFC 5424。
- 記錄執行個體 ID:輸入記錄執行個體 ID、應用程式名稱或領域名稱,例如
- 按一下 [儲存]。
UDM 對應表
記錄欄位 | UDM 對應 | 邏輯 |
---|---|---|
action_msg | read_only_udm.target.process.command_line | action_msg 欄位的值 |
設備 | read_only_udm.principal.domain.name | Appliance 欄位的值 |
設備 | read_only_udm.target.administrative_domain | Appliance 欄位的值 |
BrowserSession | read_only_udm.network.session_id | BrowserSession 欄位的值 |
cat | read_only_udm.metadata.product_event_type | cat 欄位的值 |
類別 | read_only_udm.metadata.product_event_type | Category 欄位的值 |
cn1 | security_result.severity | 根據 cn1Label 的值對應,當 cn1Label 為「Priority」時:1 - HIGH、2 - MEDIUM、3 或 4 - LOWcn1 |
公司 | read_only_udm.additional.fields.value.string_value | Company 欄位的值 |
cs1 | read_only_udm.network.session_id | cs1Label 為「BrowserSession」時的 cs1 欄位值 |
cs3 | read_only_udm.additional.fields.value.string_value | cs3Label 為「CompanyName」時的 cs3 欄位值 |
dst | read_only_udm.target.ip | dst 欄位的值 |
網域 | read_only_udm.principal.domain.name | domain 欄位的值 |
dvc | read_only_udm.intermediary.ip | dvc 欄位的值 |
EventID | read_only_udm.metadata.product_log_id | EventID 欄位的值 |
HostName | read_only_udm.principal.hostname | grok 無法比對 IP 位址時,「HostName 」欄位的值 |
HostName | read_only_udm.principal.ip | grok 符號比對 IP 位址時的 HostName 欄位值 |
ip | read_only_udm.principal.ip | ip 欄位的值 |
訊息 | read_only_udm.metadata.description | Message 欄位的值 |
訊息 | security_result.description | Message 欄位的值 |
nat_ip | read_only_udm.principal.nat_ip | nat_ip 欄位的值 |
優先順序 | security_result.severity | 根據 Priority 的值對應:1 - HIGH、2 - MEDIUM、3 或 4 - LOW |
SAMLConsumerURL | read_only_udm.target.url | SAMLConsumerURL 欄位的值 |
sec_msg | security_result.description | sec_msg 欄位的值 |
SecureAuthIdPAppliance | read_only_udm.target.administrative_domain | SecureAuthIdPAppliance 欄位的值 |
SecureAuthIdPApplianceMachineName | read_only_udm.target.hostname | SecureAuthIdPApplianceMachineName 欄位的值 |
SecureAuthIdPDestinationSiteUrl | read_only_udm.target.url | SecureAuthIdPDestinationSiteUrl 欄位的值 |
SecureAuthIdPProductType | read_only_udm.additional.fields.value.string_value | SecureAuthIdPProductType 欄位的值 |
session | read_only_udm.network.session_id | session 欄位的值 |
spid | read_only_udm.target.process.pid | spid 欄位的值 |
src | read_only_udm.principal.ip | src 欄位的值 |
suser | read_only_udm.target.user.userid | suser 欄位的值 |
UserAgent | read_only_udm.network.http.user_agent | UserAgent 欄位的值 |
UserHostAddress | read_only_udm.principal.nat_ip | UserHostAddress 欄位的值 |
UserHostAddress | read_only_udm.target.ip | UserHostAddress 欄位的值 |
UserID | read_only_udm.principal.user.userid | UserID 欄位的值 |
版本 | read_only_udm.metadata.product_version | Version 欄位的值 |
read_only_udm.additional.fields.key | 硬式編碼值 -「CompanyName」 | |
read_only_udm.additional.fields.key | 硬式編碼值 -「Company」 | |
read_only_udm.additional.fields.key | 硬式編碼值 -「SecureAuthIdPProductType」 | |
read_only_udm.extensions.auth.type | 硬式編碼值 -「SSO」 | |
read_only_udm.metadata.event_type | 如果 SecureAuthIdPAuthGuiMode == 0 且 auth_result == Success ,則為「USER_LOGIN」;如果 SecureAuthIdPAuthGuiMode == 0 且 auth_result ==WS-Trust success. ,則為「USER_CHANGE_PERMISSIONS」;如果 SecureAuthIdPAuthGuiMode == 0 且 auth_result == Session Aborted ,則為「USER_LOGOUT」;如果 UserHostAddress != and `HostName` != ,則為「NETWORK_CONNECTION」;如果 ip != or `HostName` != ,則為「STATUS_UPDATE」;如果 UserHostAddress != and `HostName` == 且 UserID != ``,則為「USER_UNCATEGORIZED」;否則為「GENERIC_EVENT」 |
|
read_only_udm.metadata.log_type | 硬式編碼值 -「SECUREAUTH_SSO」 | |
read_only_udm.metadata.product_name | 硬式編碼值 -「SECUREAUTH_SSO」 | |
read_only_udm.metadata.vendor_name | 硬式編碼值 -「SECUREAUTH_SSO」 | |
read_only_udm.target.user.email_addresses | not_email 為 false 時的 user_email 欄位值 |
|
security_result.severity | 如果 cn1Label == Priority 且 cn1 == 1 ,則為「高」;如果 cn1Label == Priority 且 cn1 == 2 ,則為「中」;如果 cn1Label == Priority 且 cn1 位於 [3 , 4 ] 之間,則為「低」;如果 Priority == 1 ,則為「高」;如果 Priority == 2 ,則為「中」;如果 Priority 位於 [3 , 4 ] 之間,則為「低」 |
還有其他問題嗎?向社群成員和 Google SecOps 專業人員尋求答案。