收集 Cloud Identity 裝置使用者記錄
剖析器版本:1.0
本文說明如何使用第三方 API 方法 (建議做法),將 Cloud Identity 裝置使用者記錄收集到 Google Security Operations。剖析器會先從 JSON 格式的 Cloud Identity Device Users 記錄中擷取資料,並將時間戳記轉換為標準化格式。接著,剖析器會將原始記錄資料中的特定欄位,對應至使用者實體、其與資產的關係,以及其他使用者屬性 (例如管理和密碼狀態) 的統合式資料模型 (UDM) 對應欄位。
事前準備
請確認您符合下列必要條件:
- Google SecOps 執行個體
- 服務帳戶的全網域委派設定。服務帳戶必須具備下列範圍的授權:
https://www.googleapis.com/auth/cloud-identity.devices.readonly
- 您的 Google Cloud 專案已啟用下列 API:
- Cloud Identity API
- Google Workspace Admin SDK
- Alert Center API
建議:設定第三方 API 動態饋給
在 Google SecOps 平台中,有兩個不同的進入點可以設定動態饋給:
- 「設定」>「資料管理」>「動態饋給」>「新增動態饋給」 (在僅限 SIEM 的平台上,依序點選「設定」>「動態饋給」>「新增動態饋給」)
- Content Hub > Content Packs > Get Started
如何設定 Google Cloud 「識別裝置使用者」動態饋給
- 按一下「Google Cloud Compute platform」套件。
- 找出「Identity Device Users」Google Cloud 記錄類型,然後按一下「Add new feed」。
- 為下列欄位指定值:
- 來源類型:選取「第三方 API」。
- OAuth JWT 端點:輸入 OAuth 權杖端點:
https://oauth2.googleapis.com/token - JWT 宣告核發者:輸入服務帳戶的電子郵件地址 (位於服務帳戶的 JSON 金鑰檔案中)。
- JWT 宣告主體:輸入在 Workspace 控制台中,獲派服務管理員或超級管理員角色的使用者電子郵件地址 (即透過全網域委派功能模擬的使用者)。
- JWT 宣告目標對象:再次輸入端點:
https://oauth2.googleapis.com/token - RSA 私密金鑰:貼上服務帳戶 JSON 金鑰檔案中私密金鑰的完整內容 (包括
-----BEGIN PRIVATE KEY-----和-----END PRIVATE KEY-----行)。
進階選項
- 動態饋給名稱:系統預先填入的值,用於識別動態饋給。
- 資產命名空間:與動態饋給相關聯的命名空間。
- 擷取標籤:套用至這個動態饋給所有事件的標籤。
- 點選「建立動態饋給」。
如要進一步瞭解如何為這個產品系列中的不同記錄類型設定多個動態饋給,請參閱「依產品設定動態饋給」。
替代方法:透過 Cloud Storage 擷取
- 登入 Google Cloud 控制台。
前往「Cloud Storage Buckets」頁面。
點選「建立」。
在「Create a bucket」(建立 bucket) 頁面中,輸入 bucket 資訊。完成下列各步驟後,請點選「繼續」前往下一步:
在「Get started」(開始使用) 部分,執行下列操作:
- 輸入符合 bucket 名稱規定且不重複的名稱,例如 gcp-cloudidentity-users-logs。
如要啟用階層命名空間,請按一下展開箭頭,展開「Optimize for file oriented and data-intensive workloads」(針對檔案導向和資料密集型工作負載進行最佳化) 專區,然後選取「Enable Hierarchical namespace on this bucket」(為這個 bucket 啟用階層命名空間)。
如要新增值區標籤,請按一下展開箭頭,展開「Labels」(標籤) 專區。
按一下「Add label」(新增標籤),然後指定標籤的鍵和值。
在「Choose where to store your data」(選擇資料的儲存位置) 部分,執行下列操作:
- 選取「位置類型」。
使用位置類型選單,選取要永久儲存 bucket 內物件資料的位置。
如要設定跨 bucket 複製作業,請展開「Set up cross-bucket replication」(設定跨 bucket 複製作業) 專區。
在「Choose a storage class for your data」(為資料選擇儲存空間級別) 部分,選取值區的「default storage class」(預設儲存空間級別),或選取「Autoclass」,讓系統自動管理值區資料的儲存空間級別。
在「Choose how to control access to objects」(選取如何控制物件的存取權) 區段中,取消勾選「Enforce public access prevention」(強制禁止公開存取),然後選取 bucket 物件的「Access control」(存取控管) 模型。
在「Choose how to protect object data」(選擇保護物件資料的方式) 部分,執行下列操作:
- 在「資料保護」下方,選取要為 bucket 設定的選項。
- 如要選擇物件資料的加密方式,請按一下標示為「資料加密」的展開箭頭,然後選取資料加密方法。
點選「建立」。
設定 Cloud Identity 裝置使用者記錄匯出作業
- 登入 Google Cloud 控制台。
- 依序前往「Logging」>「Log Router」。
- 按一下「建立接收器」。
提供下列設定參數:
- 「Sink Name」(接收器名稱):輸入有意義的名稱,例如
Cloudidentity-Users-Sink。 - 「Sink Destination」(接收器目的地):選取「Cloud Storage Storage」,然後輸入 bucket 的 URI,例如
gs://gcp-cloudidentity-users-logs/。 記錄篩選器:
logName="projects/<your-project-id>/logs/cloudaudit.googleapis.com%2Factivity" resource.type="cloud_identity_user"設定匯出選項:納入所有記錄項目。
- 「Sink Name」(接收器名稱):輸入有意義的名稱,例如
點選「建立」。
設定 Cloud Storage 權限
- 依序前往「IAM & Admin」(IAM 與管理) >「IAM」(身分與存取權管理)。
- 找出 Cloud Logging 服務帳戶。
- 授予 bucket 的 roles/storage.admin 角色。
UDM 對應表
| 記錄欄位 | UDM 對應 | 邏輯 |
|---|---|---|
| collection_time.nanos | timestamp.nanos | 直接從記錄欄位對應。代表事件時間戳記 (以奈秒為單位)。 |
| collection_time.seconds | timestamp.seconds | 直接從記錄欄位對應。代表事件時間戳記 (以秒為單位)。 |
| createTime | entity.metadata.creation_timestamp | 經 date 篩選器剖析後,直接從記錄欄位對應。代表使用者的建立時間戳記。 |
| managementState | entity.additional.fields.value.string_value | 直接從記錄欄位對應。代表使用者的管理狀態。 |
| 名稱 | entity.entity.resource.name | 直接從記錄欄位對應。代表裝置使用者的完整資源名稱。 |
| passwordState | entity.additional.fields.value.string_value | 直接從記錄欄位對應。代表使用者的密碼狀態。只有在原始記錄中存在 passwordState 欄位時,系統才會對應這個欄位。 |
| userEmail | entity.entity.user.email_addresses | 直接從記錄欄位對應。代表使用者的電子郵件地址。 |
| entity.additional.fields.key | 在剖析器中設為常數值 Management State。這個欄位用於提供 managementState 值的背景資訊。 |
|
| entity.additional.fields.key | 在剖析器中設為常數值 Password State。這個欄位用於提供 passwordState 值的背景資訊,只有在原始記錄中存在 passwordState 時才會顯示。 |
|
| entity.entity.user.product_object_id | 使用 grok 篩選器從 name 欄位擷取,擷取 deviceuser_id 部分。代表裝置使用者的專屬 ID。 |
|
| entity.metadata.collected_timestamp.nanos | 複製來源:collection_time.nanos。代表收集記錄的時間戳記。 |
|
| entity.metadata.collected_timestamp.seconds | 複製來源:collection_time.seconds。代表收集記錄的時間戳記。 |
|
| entity.metadata.entity_type | 在剖析器中設為常數值 USER。 |
|
| entity.metadata.product_name | 在剖析器中設為常數值 GCP Cloud Identity Device Users。 |
|
| entity.metadata.vendor_name | 在剖析器中設為常數值 Google Cloud Platform。 |
|
| relations.entity.asset.product_object_id | 使用 grok 篩選器從 name 欄位擷取,擷取 device_id 部分。代表裝置的專屬 ID。 |
|
| relations.entity_type | 在剖析器中設為常數值 ASSET。 |
|
| relations.relationship | 在剖析器中設為常數值 MEMBER。 |
變更記錄
還有其他問題嗎?向社群成員和 Google SecOps 專家尋求解答。