排解 IAM 相關政策問題

本頁面說明如何排解 Identity and Access Management (IAM) 允許政策、拒絕政策、主體存取邊界政策和統一存取政策 (UAP) 的問題。

使用政策疑難排解工具

如要排解特定主體的存取權問題,請使用 IAM 政策疑難排解工具。

政策疑難排解工具可協助您瞭解主體是否能存取資源。只要提供主體、資源和權限,政策疑難排解工具就會檢查影響主體存取權的允許政策、拒絕政策和主體存取邊界 (PAB) 政策。接著,系統會根據這些政策,判斷主體是否能使用指定權限存取資源。此外,這項工具也會列出相關政策,並說明這些政策對主體存取權的影響。

政策疑難排解工具不支援排解 UAP 問題。如要瞭解如何排解 UAP 問題,請參閱本頁的「手動疑難排解」一節。

如要瞭解如何使用政策疑難排解工具,排解允許政策、拒絕政策和主體存取邊界政策的問題,請參閱「排解 IAM 權限問題」。

如要在允許政策中尋找特定角色繫結,可以搜尋允許政策。

Cloud Asset Inventory 可讓您搜尋符合指定參數的角色繫結允許政策。您可以使用多種搜尋參數,包括:

  • 資源類型
  • 主體類型
  • 角色
  • 專案
  • 資料夾
  • 組織

詳情請參閱「搜尋 IAM 允許政策」。

手動疑難排解

如要手動排解主體對資源的存取權問題,請查看所有可能影響主體存取權的政策。

必要的角色

如要查看影響主體存取權的所有政策,您必須具備查看允許政策、拒絕政策、UAP 繫結和 UAP 的權限。

如要取得查看所有允許和拒絕政策所需的權限,請要求管理員針對包含資源的組織,授予您安全性審查者 (roles/iam.securityReviewer) IAM 角色。

如要取得查看影響目標資源的所有 UAP 繫結所需的權限,請要求管理員在包含資源的組織中,授予您下列 IAM 角色:

  • 組織管理員 (roles/resourcemanager.organizationAdmin)
  • 列出服務專屬資源的繫結:具備 SERVICE.RESOURCE.searchPolicyBindings 權限的角色,其中 RESOURCE 是資源類型,SERVICE 則是擁有資源的服務。

如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這些預先定義的角色具備查看所有影響目標資源的 UAP 繫結所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:

所需權限

必須具備下列權限,才能查看影響目標資源的所有 UAP 繫結:

  • 列出組織的繫結:resourcemanager.organizations.searchPolicyBindings
  • 列出資料夾的繫結:resourcemanager.folders.searchPolicyBindings
  • 列出專案繫結: resourcemanager.projects.searchPolicyBindings
  • 列出特定服務資源的繫結: SERVICE.RESOURCE.searchPolicyBindings

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

如要取得所需權限,查看影響目標資源的所有 UAP 繫結,請要求管理員授予角色,讓您列出該資源及其祖系資源的繫結。這些角色必須包含 SERVICE.RESOURCE.searchPolicyBindings 權限,其中 RESOURCE 是目標資源類型,SERVICE 則是擁有資源的服務。

如要取得查看所有 UAP 的權限,請要求管理員在包含資源的組織中,授予您存取權政策檢視者 (roles/iam.accessPolicyViewer) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備查看所有 UAP 的必要權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:

所需權限

必須具備下列權限,才能查看所有 UAP:

  • 列出組織的繫結:resourcemanager.organizations.searchPolicyBindings
  • 列出資料夾的繫結:resourcemanager.folders.searchPolicyBindings
  • 列出專案繫結: resourcemanager.projects.searchPolicyBindings
  • 列出特定服務資源的繫結: SERVICE.RESOURCE.searchPolicyBindings

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

查看適用於資源的所有允許和拒絕政策

在 Google Cloud中,下列允許和拒絕政策會影響資源的存取權:

  • 資源的允許政策
  • 資源的拒絕政策 (如有)
  • 資源上層專案、資料夾和組織的允許政策 (如有)
  • 資源上層專案、資料夾和組織的拒絕政策 (如有)

由於政策繼承,上層專案、資料夾和組織的允許和拒絕政策會影響資源的存取權。將允許或拒絕政策附加至專案、資料夾或組織時,該政策也會套用至該專案、資料夾或組織內的所有資源。

舉例來說,如果組織的拒絕政策規定主體不得使用特定權限,則主體無法對組織內的任何資源使用該權限。即使該組織中的資料夾和專案具有較寬鬆的拒絕政策,或允許政策授予主體權限,這項規則仍適用。

同樣地,如果專案的允許政策授予主體特定權限,則主體對專案中的任何資源都擁有該權限,前提是該權限未遭拒絕。

所有這些政策的聯集稱為資源的「適用政策」或「有效政策」。

在 Google Cloud中,您可以使用 gcloud beta projects get-ancestors-iam-policy 指令搭配 --include-deny 旗標,取得影響專案存取權的所有允許和拒絕政策清單。這些政策共同構成專案的適用政策。您可以調查各項政策,瞭解政策對主體存取權的影響。

gcloud

使用下列任何指令資料前,請先替換以下項目:

  • PROJECT_ID:您的 Google Cloud 專案 ID。專案 ID 是英數字串,例如 my-project。

執行 gcloud beta projects get-ancestors-iam-policy 指令:

Linux、macOS 或 Cloud Shell

gcloud beta projects get-ancestors-iam-policy PROJECT_ID --include-deny --format=json

Windows (PowerShell)

gcloud beta projects get-ancestors-iam-policy PROJECT_ID --include-deny --format=json

Windows (cmd.exe)

gcloud beta projects get-ancestors-iam-policy PROJECT_ID --include-deny --format=json

回應包含專案、專案上層資料夾和組織的允許和拒絕政策。以下範例顯示組織 1234567890123 和專案 my-project 的允許政策,以及專案 my-project 的拒絕政策:

[
  {
    "id": "1234567890123",
    "policy": {
      "bindings": [
        {
          "members": [
            "group:cloud-admins@example.com"
          ],
          "role": "roles/iam.denyAdmin"
        },
        {
          "members": [
            "user:raha@example.com"
          ],
          "role": "roles/iam.serviceAccountAdmin"
        }
      ],
      "etag": "BwXW6Eab7TI=",
      "version": 1
    },
    "type": "organization"
  },
  {
    "id": "my-project",
    "policy": {
      "bindings": [
        {
          "members": [
            "group:cloud-admins@example.com"
          ],
          "role": "roles/owner"
        }
      ],
      "etag": "BwXXjOM7L6M=",
      "type": "project"
    }
  },
  {
    "id": "my-project",
    "policy": {
      "createTime": "2022-02-14T21:46:35.865279Z",
      "displayName": "My deny policy",
      "etag": "MTgyMzg2ODcwNTEyMjMxMTM3Mjg=",
      "kind": "DenyPolicy",
      "name": "policies/cloudresourcemanager.googleapis.com%2Fprojects%2F123456789012/denypolicies/my-deny-policy",
      "rules": [
        {
          "denyRule": {
            "deniedPermissions": [
              "iam.googleapis.com/serviceAccounts.create"
            ],
            "deniedPrincipals": [
              "user:raha@example.com"
            ]
          },
          "description": "Prevent service account creation"
        }
      ],
      "uid": "c83e3dc3-d8a6-6f51-4018-814e9f200b05",
      "updateTime": "2022-02-14T21:46:35.865279Z"
    },
    "type": "project"
  }
]

在本範例中,Raha 獲派組織的服務帳戶管理員角色 (roles/iam.serviceAccountAdmin),但專案設有拒絕政策,禁止 Raha 使用 iam.googleapis.com/serviceAccounts.create 權限。因此,如果 Raha 嘗試在專案 my-project 中建立服務帳戶,要求會遭到拒絕。

在某些情況下,您可能只需要查看資源的有效允許政策,例如貴組織不使用拒絕政策時。在這種情況下,您可以使用下列方法查看有效的允許政策:

  • 在Google Cloud 控制台中查看資源的 IAM 允許政策。 Google Cloud 控制台會自動顯示每項資源的生效政策。

    如要瞭解如何在Google Cloud 控制台查看資源的 IAM 允許政策,請參閱「查看目前的存取權」。

  • 使用 Cloud Asset API 取得資源的有效允許政策。詳情請參閱「查看有效的 IAM 政策」。

查看適用於資源的所有統一存取政策

如要查看適用於目標資源的所有 UAP,請按照下列步驟操作:

控制台

  1. 找出目標資源的所有父項資源。上層資源是指資源階層中位於該資源上方的任何專案、資料夾和組織。
  2. 查看繫結至各項上層資源的 UAP。如果 UAP 提及主體,則可能會影響主體對目標資源的存取權。

gcloud

  1. 找出目標資源的所有父項資源。上層資源是指資源階層中位於該資源上方的任何專案、資料夾和組織。
  2. 列出目標資源和每個目標資源祖系的 UAP 繫結。記錄每個繫結中的政策 ID。
  3. 查看您擷取的每個繫結中的每個 UAP。如果 UAP 提及主體,則可能會影響主體對目標資源的存取權。

REST

  1. 找出目標資源的所有父項資源。上層資源是指資源階層中位於該資源上方的任何專案、資料夾和組織。
  2. 列出目標資源和每個目標資源祖系的 UAP 繫結。記錄每個繫結中的政策 ID。
  3. 查看您擷取的每個繫結中的每個 UAP。如果 UAP 提及主體,則可能會影響主體對目標資源的存取權。