收集 Microsoft Graph 活動記錄

支援的國家/地區:

總覽

這個剖析器會從 Microsoft Graph 活動記錄中擷取欄位,並轉換為 Unified Data Model (UDM)。這個函式會初始化 UDM 欄位、剖析酬載、擷取時間戳記、將各種屬性對應至 UDM 欄位、處理 IP 位址和通訊埠,以及根據主體和網路資訊是否存在,將事件類型分類。

事前準備

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

  • Google SecOps 執行個體。
  • Microsoft Entra ID 和 Azure 儲存體帳戶的特殊存取權。

設定 Azure 儲存體帳戶

  1. 在 Azure 控制台中搜尋儲存體帳戶。
  2. 點選「建立」
  3. 指定下列輸入參數的值:
    • 「訂閱」:選取訂閱方案。
    • 資源群組:選取資源群組。
    • Region (區域):選取區域。
    • 效能:選取所需效能等級 (建議使用標準等級)。
    • 備援:選取所需的備援層級 (建議使用 GRS 或 LRS)。
    • 「儲存體帳戶名稱」:輸入新儲存體帳戶的名稱。
  4. 按一下「Review + create」
  5. 查看帳戶總覽,然後按一下「建立」
  6. 在「儲存空間帳戶總覽」頁面中,選取「安全性 + 網路」中的「存取金鑰」子選單。
  7. 按一下「key1」或「key2」旁邊的「顯示」
  8. 按一下「複製到剪貼簿」即可複製金鑰。
  9. 將金鑰儲存於安全的位置,以供日後參考。
  10. 在「儲存空間帳戶總覽」頁面中,選取「設定」中的「端點」子選單。
  11. 按一下「複製到剪貼簿」,複製 Blob 服務端點網址 (例如 https://.blob.core.windows.net)。
  12. 將端點網址儲存在安全的位置,以供日後參考。

設定 Microsoft Graph 活動記錄匯出至儲存體帳戶

  1. 在 Azure 控制台中,搜尋 Entra ID
  2. 依序選取「監控」>「診斷設定」
  3. 按一下「+ 新增診斷設定」
  4. 為設定指定專屬名稱 (例如 ms-graph-activity)。
  5. 選取要匯出至 Google SecOps 的 MicrosoftGraphActivityLog 類別。
  6. 在「目的地詳細資料」下方,選取「封存至儲存空間帳戶」
  7. 選取訂閱項目和您在上一個步驟中建立的儲存空間帳戶。
  8. 按一下 [儲存]

設定動態饋給

在 Google SecOps 平台中,有兩種不同的進入點可設定動態饋給:

  • 「SIEM 設定」>「動態消息」
  • 內容中心 > 內容包

依序前往「SIEM 設定」>「動態饋給」,設定動態饋給

如要設定動態消息,請按照下列步驟操作:

  1. 依序前往「SIEM 設定」>「動態消息」
  2. 按一下「新增動態消息」
  3. 在下一個頁面中,按一下「設定單一動態饋給」
  4. 在「動態饋給名稱」欄位中,輸入動態饋給的名稱,例如「Microsoft Graph Activity Logs」
  5. 選取「Microsoft Azure Blob Storage」做為「來源類型」
  6. 選取「Microsoft Graph Activity Logs」做為「Log type」
  7. 點選「下一步」
  8. 指定下列輸入參數的值:

    • Azure URI:Blob 端點網址。

      ENDPOINT_URL/BLOB_NAME

      更改下列內容:

      • ENDPOINT_URL:Blob 端點網址 (https://<storageaccountname>.blob.core.windows.net)
      • BLOB_NAME:Blob 的名稱 (例如 insights-logs-)
    • URI 為:根據記錄串流設定選取 URI 類型 (單一檔案 | 目錄 | 包含子目錄的目錄)。

    • 來源刪除選項:根據偏好設定選取刪除選項。

    • 共用金鑰:Azure Blob 儲存體的存取金鑰。
  9. 點選「下一步」

  10. 在「Finalize」畫面上檢查新的動態饋給設定,然後按一下「Submit」

從內容中心設定動態饋給

為下列欄位指定值:

  • Azure URI:Blob 端點網址。 ENDPOINT_URL/BLOB_NAME 取代下列項目:
    • ENDPOINT_URL:Blob 端點網址 (https://<storageaccountname>.blob.core.windows.net)
    • BLOB_NAME:Blob 的名稱 (例如 insights-logs-)
  • URI 為:根據記錄串流設定選取 URI 類型 (單一檔案 | 目錄 | 包含子目錄的目錄)。
  • 來源刪除選項:根據偏好設定選取刪除選項。
  • 共用金鑰:Azure Blob 儲存體的存取金鑰。

進階選項

  • 動態饋給名稱:系統預先填入的值,用於識別動態饋給。
  • 來源類型:將記錄收集到 Google SecOps 的方法。
  • 資產命名空間:與動態饋給相關聯的命名空間。
  • 擷取標籤:套用至這個動態饋給所有事件的標籤。

UDM 對應表

記錄欄位 UDM 對應 邏輯
callerIpAddress principal.asset.ip 原始記錄欄位 callerIpAddress 會複製到 UDM 欄位。
callerIpAddress principal.ip 原始記錄欄位 callerIpAddress 會複製到 UDM 欄位。
category security_result.category_details 原始記錄欄位 category 會複製到 UDM 欄位。
correlationId security_result.detection_fields.value 原始記錄欄位 correlationId 會複製到 UDM 欄位,其中鍵是 correlationId
Level security_result.detection_fields.value 原始記錄欄位 Level 會轉換為字串,並複製到 UDM 欄位,其中鍵為 Level
operationName metadata.product_event_type 原始記錄欄位 operationName 會複製到 UDM 欄位。
operationVersion additional.fields.value.string_value 原始記錄欄位 operationVersion 會複製到 UDM 欄位,其中鍵是 operationVersion
properties.apiVersion metadata.product_version 原始記錄欄位 properties.apiVersion 會複製到 UDM 欄位。
properties.appId target.resource.product_object_id 原始記錄欄位 properties.appId 會複製到 UDM 欄位。
properties.atContent additional.fields.value.string_value 原始記錄欄位 properties.atContent 會複製到 UDM 欄位,其中鍵為 atContent
properties.clientAuthMethod extensions.auth.auth_details 根據 properties.clientAuthMethod 的值,UDM 欄位會設為「公開用戶端」(0)、「用戶端 ID/用戶端密碼」(1) 或「用戶端憑證」(2)。
properties.clientRequestId additional.fields.value.string_value 原始記錄欄位 properties.clientRequestId 會複製到 UDM 欄位,其中鍵為 clientRequestId
properties.durationMs network.session_duration.seconds 原始記錄欄位 properties.durationMs 會從毫秒轉換為秒,並複製到 UDM 欄位。
properties.identityProvider security_result.detection_fields.value 原始記錄欄位 properties.identityProvider 會複製到 UDM 欄位,其中鍵為 identityProvider
properties.ipAddress principal.asset.ip 系統會從原始記錄欄位 properties.ipAddress 擷取 IP 位址,並複製到 UDM 欄位。
properties.ipAddress principal.ip 系統會從原始記錄欄位 properties.ipAddress 擷取 IP 位址,並複製到 UDM 欄位。
properties.location principal.location.name 原始記錄欄位 properties.location 會複製到 UDM 欄位。
properties.operationId security_result.detection_fields.value 原始記錄欄位 properties.operationId 會複製到 UDM 欄位,其中鍵為 operationId
properties.requestMethod network.http.method 原始記錄欄位 properties.requestMethod 會複製到 UDM 欄位。
properties.requestId metadata.product_log_id 原始記錄欄位 properties.requestId 會複製到 UDM 欄位。
properties.responseSizeBytes network.received_bytes 原始記錄欄位 properties.responseSizeBytes 會轉換為不帶正負號的整數,並複製到 UDM 欄位。
properties.responseStatusCode network.http.response_code 原始記錄欄位 properties.responseStatusCode 會轉換為整數,並複製到 UDM 欄位。
properties.roles additional.fields.value.string_value 原始記錄欄位 properties.roles 會複製到 UDM 欄位,其中鍵為 roles
properties.scopes additional.fields.value.string_value 原始記錄欄位 properties.scopes 會複製到 UDM 欄位,其中鍵為 Scopes
properties.servicePrincipalId principal.user.userid 如果 properties.userId 為空,原始記錄欄位 properties.servicePrincipalId 會複製到 UDM 欄位。
properties.signInActivityId network.session_id 原始記錄欄位 properties.signInActivityId 會複製到 UDM 欄位。
properties.tenantId metadata.product_deployment_id 原始記錄欄位 properties.tenantId 會複製到 UDM 欄位。
properties.tokenIssuedAt additional.fields.value.string_value 原始記錄欄位 properties.tokenIssuedAt 會複製到 UDM 欄位,其中鍵為 tokenIssuedAt
properties.userAgent network.http.user_agent 原始記錄欄位 properties.userAgent 會複製到 UDM 欄位。
properties.userId principal.user.userid 原始記錄欄位 properties.userId 會複製到 UDM 欄位。
properties.wids security_result.detection_fields.value 原始記錄欄位 properties.wids 會複製到 UDM 欄位,其中鍵為 wids
resourceId target.resource.attribute.labels.value 原始記錄欄位 resourceId 會複製到 UDM 欄位,其中鍵為 Resource ID
resultSignature additional.fields.value.string_value 原始記錄欄位 resultSignature 會複製到 UDM 欄位,其中鍵是 resultSignature
time metadata.event_timestamp 系統會剖析原始記錄欄位 time,並轉換為時間戳記,然後複製到 UDM 欄位。如果 has_principal 為 true 且 network.http 不為空白,UDM 欄位 event.idm.read_only_udm.metadata.event_type 會設為「NETWORK_HTTP」;如果 has_principal 為 true 且 network.http 為空白,則會設為「STATUS_UPDATE」;否則會設為「GENERIC_EVENT」。UDM 欄位設為「Microsoft Graph」。UDM 欄位設為「Microsoft」。

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