運用資產洞察資料強化安全防護機制

Cloud Asset Inventory 洞察資料可協助您偵測資產設定中的潛在風險,並改善安全防護機制。這項功能是 Recommender 服務的一部分,以 google.cloudasset.asset.Insight 洞察類型提供。

洞察是特定的異常狀況,需要進一步分析才能判斷適當的行動。系統每天會根據 Cloud Asset Inventory 中儲存的資料快照產生這些報表。

Cloud Asset Inventory 提供的洞察資訊,是以與貴機構資源相關聯的 IAM 政策為依據。

事前準備

如要開始使用素材資源洞察,請先完成下列步驟。

  1. 啟用 Recommender API。

  2. 請確認您的帳戶具備下列權限:

    • recommender.cloudAssetInsights.get

    • recommender.cloudAssetInsights.list

    • recommender.cloudAssetInsights.update

    您可以個別授予這些權限,也可以授予下列任一角色。

    • Cloud Asset Insights 檢視者 (roles/recommender.cloudAssetInsightsViewer) 角色

    • Cloud Asset 深入分析管理員 (roles/recommender.cloudAssetInsightsAdmin) 角色

限制

  • 這些深入分析不會將群組成員或服務帳戶納入調查結果,也不應視為相符安全漏洞的完整清單。

  • 個別深入分析結果會包含相符 IAM 政策的樣本,最多 100 項不同的政策。如要擷取所有相符政策,請搜尋資源的身分與存取權管理允許政策。

要求素材資源洞察

如要要求取得素材資源洞察資料,最簡單的方法就是列出素材資源,如下列步驟所示。如要瞭解其他類型的洞察互動,請參閱「使用 API - 洞察」。

gcloud

gcloud recommender insights list \
    --SCOPE \
    --location=global \
    --insight-type=google.cloudasset.asset.Insight \
    --filter="insightSubtype:SUBTYPE" \

提供以下這些值:

  • SCOPE:請使用下列其中一個值:

    • project=PROJECT_ID,其中 PROJECT_ID 是您要取得洞察資料的專案 ID。
    • folder=FOLDER_ID,其中 FOLDER_ID 是要取得洞察資料的資料夾 ID。

      如何找出 Cloud de Confiance by S3NS 資料夾的 ID

      Cloud de Confiance 控制台

      如要找出 Cloud de Confiance by S3NS 資料夾的 ID,請完成下列步驟:

      1. 前往 Cloud de Confiance 控制台。

        前往 Cloud de Confiance 控制台

      2. 按一下選單列中的「切換器」清單方塊。
      3. 從清單方塊中選取機構。
      4. 搜尋資料夾名稱。資料夾 ID 會顯示在資料夾名稱旁邊。

      gcloud CLI

      如要擷取機構層級資料夾的 ID,請執行下列指令: Cloud de Confiance by S3NS

      gcloud resource-manager folders list \
          --organization=$(gcloud organizations describe ORGANIZATION_NAME \
            --format="value(name.segment(1))") \
          --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \
          --format="value(ID)"

      其中 TOP_LEVEL_FOLDER_NAME 是資料夾名稱的部分或完整字串比對。移除 --format 標記,即可查看找到的資料夾詳細資訊。

      先前的指令不會傳回資料夾中子資料夾的 ID。如要執行這項操作,請使用頂層資料夾的 ID 執行下列指令:

      gcloud resource-manager folders list --folder=FOLDER_ID
    • organization=ORGANIZATION_ID,其中 ORGANIZATION_ID 是您要取得洞察資料的機構 ID。

      如何查看機構的 ID Cloud de Confiance by S3NS

      Cloud de Confiance 控制台

      如要找出 Cloud de Confiance by S3NS 機構的 ID,請完成下列步驟:

      1. 前往 Cloud de Confiance 控制台。

        前往 Cloud de Confiance 控制台

      2. 按一下選單列中的「切換器」清單方塊。
      3. 從清單方塊中選取機構。
      4. 按一下「全部」分頁標籤。機構 ID 會顯示在機構名稱旁邊。

      gcloud CLI

      您可以使用下列指令擷取機構的 ID: Cloud de Confiance by S3NS

      gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
  • BILLING_PROJECT_ID:選用。預設 Cloud Asset Inventory 服務代理所在的專案 ID,該專案具有管理帳單和配額的權限。 進一步瞭解如何設定帳單專案。

  • SUBTYPE:素材資源洞察子類型。值為下列其中之一:

    • EXTERNAL_MEMBER:偵測含有使用者或群組的 IAM 政策,這些使用者或群組屬於貴機構網域以外的網域。
    • EXTERNAL_POLICY_EDITOR:偵測 IAM 政策是否包含機構網域以外的使用者或群組,並授予修改 IAM 政策的權限。
    • EXTERNAL_CLOUD_STORAGE_OBJECT_VIEWER:偵測 IAM 政策,其中包含獲准取得或列出儲存空間物件 (storage.objects.list 或 storage.objects.get 權限) 的機構外使用者或群組。
    • EXTERNAL_SERVICE_ACCOUNT_IMPERSONATOR:偵測 IAM 政策,其中包含獲准模擬服務帳戶權限的機構網域外部使用者或群組。
    • TERMINATED_MEMBER:偵測含有已停用、刪除或清除帳戶的使用者或群組的 IAM 政策。
    • PUBLIC_IAM_POLICY:偵測包含所有使用者或所有已驗證使用者的 IAM 政策。
    • OWNER_TERMINATED_PROJECT:偵測專案的 IAM 政策中是否沒有任何有效使用者或群組。
  • 如未指定,系統會傳回所有子類型。

如要瞭解所有選項,請參閱 gcloud CLI 參考資料。

範例

執行下列指令,列出 my-project 專案的洞察資料。

gcloud recommender insights list \
    --project=my-project \
    --location=global \
    --insight-type=google.cloudasset.asset.Insight

回覆範例

INSIGHT_ID: 00000000-0000-0000-0000-000000000000
CATEGORY: SECURITY
INSIGHT_STATE: ACTIVE
LAST_REFRESH_TIME: 2024-01-30T00:00:00Z
SEVERITY: LOW
INSIGHT_SUBTYPE: EXTERNAL_MEMBER
DESCRIPTION: Domain example.com detected in 1 IAM policies

REST

HTTP 方法和網址:

GET https://recommender.googleapis.com/v1/SCOPE_PATH/locations/global/insightTypes/google.cloudasset.asset.Insight/insights

標頭:

X-Goog-User-Project: BILLING_PROJECT_ID

提供以下這些值:

  • SCOPE_PATH:請使用下列其中一個值:

    允許的值如下:

    • projects/PROJECT_ID,其中 PROJECT_ID 是您要取得洞察資料的專案 ID。
    • projects/PROJECT_NUMBER,其中 PROJECT_NUMBER 是您要取得洞察資料的專案編號。

      如何找出 Cloud de Confiance by S3NS 專案編號

      Cloud de Confiance 控制台

      如要找出專案編號,請完成下列步驟: Cloud de Confiance by S3NS

      1. 前往 Cloud de Confiance 控制台的「Welcome」(歡迎) 頁面。

        前往「歡迎」頁面

      2. 按一下選單列中的「切換器」清單方塊。
      3. 從清單方塊中選取機構,然後搜尋專案名稱。 專案名稱、專案編號和專案 ID 會顯示在「歡迎」標題附近。

        最多會顯示 4,000 個資源。如果找不到所需專案,請前往「管理資源」頁面,然後使用該專案的名稱篩選清單。

      gcloud CLI

      您可以使用下列指令擷取 Cloud de Confiance by S3NS 專案編號:

      gcloud projects describe PROJECT_ID --format="value(projectNumber)"
    • folders/FOLDER_ID,其中 FOLDER_ID 是您要取得洞察資料的資料夾 ID。

      如何找出 Cloud de Confiance by S3NS 資料夾的 ID

      Cloud de Confiance 控制台

      如要找出 Cloud de Confiance by S3NS 資料夾的 ID,請完成下列步驟:

      1. 前往 Cloud de Confiance 控制台。

        前往 Cloud de Confiance 控制台

      2. 按一下選單列中的「切換器」清單方塊。
      3. 從清單方塊中選取機構。
      4. 搜尋資料夾名稱。資料夾 ID 會顯示在資料夾名稱旁邊。

      gcloud CLI

      如要擷取機構層級資料夾的 ID,請執行下列指令: Cloud de Confiance by S3NS

      gcloud resource-manager folders list \
          --organization=$(gcloud organizations describe ORGANIZATION_NAME \
            --format="value(name.segment(1))") \
          --filter='"DISPLAY_NAME":"TOP_LEVEL_FOLDER_NAME"' \
          --format="value(ID)"

      其中 TOP_LEVEL_FOLDER_NAME 是資料夾名稱的部分或完整字串比對。移除 --format 標記,即可查看找到的資料夾詳細資訊。

      先前的指令不會傳回資料夾中子資料夾的 ID。如要執行這項操作,請使用頂層資料夾的 ID 執行下列指令:

      gcloud resource-manager folders list --folder=FOLDER_ID
    • organizations/ORGANIZATION_ID,其中 ORGANIZATION_ID 是您要取得洞察資料的機構 ID。

      如何查看機構的 ID Cloud de Confiance by S3NS

      Cloud de Confiance 控制台

      如要找出 Cloud de Confiance by S3NS 機構的 ID,請完成下列步驟:

      1. 前往 Cloud de Confiance 控制台。

        前往 Cloud de Confiance 控制台

      2. 按一下選單列中的「切換器」清單方塊。
      3. 從清單方塊中選取機構。
      4. 按一下「全部」分頁標籤。機構 ID 會顯示在機構名稱旁邊。

      gcloud CLI

      您可以使用下列指令擷取機構的 ID: Cloud de Confiance by S3NS

      gcloud organizations describe ORGANIZATION_NAME --format="value(name.segment(1))"
  • BILLING_PROJECT_ID:預設 Cloud Asset Inventory 服務代理所在的專案 ID,該專案具有管理帳單和配額的權限。 進一步瞭解如何設定帳單專案。

指令範例

執行下列其中一個指令,列出 my-project 專案的洞察資料。

curl (Linux、macOS 或 Cloud Shell)

curl -X GET \
     -H "X-Goog-User-Project: BILLING_PROJECT_ID" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     https://recommender.googleapis.com/v1/projects/my-project/locations/global/insightTypes/google.cloudasset.asset.Insight/insights

PowerShell (Windows)

$cred = gcloud auth print-access-token

$headers = @{ 
  "X-Goog-User-Project" = "BILLING_PROJECT_ID";
  "Authorization" = "Bearer $cred"
}


Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://recommender.googleapis.com/v1/projects/my-project/locations/global/insightTypes/google.cloudasset.asset.Insight/insights" | Select-Object -Expand Content

回覆範例

{
   "name": "organizations/000000000000/locations/global/insightTypes/google.cloudasset.asset.Insight/insights/00000000-0000-0000-0000-000000000000",
   "description": "Domain example.com detected in 1 IAM policies",
   "content": {
      "domain": "example.com",
      "policyCount": 1,
      "policySearchQuery": "policy: example.com",
      "matchedPolicies" :[
         {
            "resource" :"//cloudresourcemanager.googleapis.com/projects/000000000000",
            "project" :"projects/000000000000",
            "matchedBindings" :[
               {
                  "role" :"roles/viewer",
                  "matchedMembers" :[
                     "user:example@example.com"
                  ]
               }
            ]
         }
      ]
   },
   "lastRefreshTime": "2024-01-30T00:00:00Z",
   "observationPeriod": "0s",
   "stateInfo": {
      "state": "ACTIVE"
   },
   "category": "SECURITY",
   "targetResources": [
      "//cloudresourcemanager.googleapis.com/organizations/000000000000"
   ],
   "insightSubtype": "EXTERNAL_MEMBER",
   "etag": "\"00000000000\"",
   "initialRefreshTime": "2024-01-30T00:00:00Z"
}

解讀洞察資料的回覆

除了標準洞察屬性,資產洞察還提供多種專屬子類型和欄位。

洞察子類型

素材資源洞察子類型如下:

  • EXTERNAL_MEMBER:偵測 IAM 政策是否包含不屬於貴機構網域的使用者或群組。

  • EXTERNAL_POLICY_EDITOR:偵測包含使用者或群組的 IAM 政策,這些使用者或群組不屬於貴機構網域,但已獲准修改 IAM 政策。

  • EXTERNAL_CLOUD_STORAGE_OBJECT_VIEWER:偵測 IAM 政策,其中包含貴機構網域外的使用者或群組,且這些使用者或群組已獲授權可取得或列出儲存空間物件 (storage.objects.list 或 storage.objects.get permission)。

  • EXTERNAL_SERVICE_ACCOUNT_IMPERSONATOR:偵測 IAM 政策,找出授予權限可模擬服務帳戶的貴機構網域外部使用者或群組。

  • TERMINATED_MEMBER:偵測含有已停用、刪除或清除帳戶的使用者或群組的 IAM 政策。

  • PUBLIC_IAM_POLICY:偵測包含所有使用者或所有已驗證使用者的 IAM 政策。

  • OWNER_TERMINATED_PROJECT:偵測專案的 IAM 政策中是否沒有任何有效使用者或群組。

其他內容欄位

除了回應中的標準欄位,資產洞察資料還會在 content 欄位中提供多個專用欄位。

  • user:系統在這個洞察的政策繫結成員中偵測到的使用者電子郵件地址。這個欄位包含在 TERMINATED_MEMBER 子類型中。

  • domain:在該洞察資料的政策繫結成員中偵測到的網域。這個欄位包含在 EXTERNAL_MEMBER、EXTERNAL_POLICY_EDITOR、EXTERNAL_CLOUD_STORAGE_OBJECT_VIEWER 和 EXTERNAL_SERVICE_ACCOUNT_IMPERSONATOR 子類型中。

  • assetName:這項洞察資料中偵測到存取權的資產名稱。 這個欄位包含在 OWNER_TERMINATED_PROJECT 和 PUBLIC_IAM_POLICY 子類型中。

  • policyCount:這項深入分析中偵測到相符成員的不重複 IAM 政策總數。所有素材資源洞察子類型都會包含這個欄位。

  • matchedPolicies:與偵測到的洞察結果相符的 IAM 政策樣本。相符政策只會包含與偵測到的洞察資料相符的繫結和繫結成員子集。所有素材資源洞察子類型都會納入這個欄位。

  • policySearchQuery:可搭配 Cloud Asset Inventory IAM 政策搜尋 API 使用的查詢,即時擷取相關政策。