排解 IAM 權限問題

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

您可以使用Google Cloud 控制台、Google Cloud CLI 或 REST API 存取政策疑難排解工具。如果是基本查詢,使用 Google Cloud 控制台通常最快。如需處理更複雜的情況,建議使用 gcloud CLI 或 REST API。

事前準備

  • 啟用 Policy Troubleshooter API (如果尚未啟用)。

    啟用 API 所需的角色

    如要啟用 API,您必須具備 serviceusage.services.enable 權限。如果您建立了專案,可能已透過擁有者角色 (roles/owner) 取得這項權限。否則,您可以透過 Service Usage 管理員角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

    啟用 API

所需權限

如要完整排解主體的存取權問題,您需要下列權限。

排解個別主體存取權問題的權限

政策疑難排解工具會根據您有權查看的允許政策、拒絕政策、主體存取邊界政策和角色,分析主體對資源的存取權。如果您沒有權限查看套用至資源的政策,或沒有權限查看自訂角色,可能就無法判斷主體是否具有存取權。

排解允許和拒絕政策問題的權限

如要排解允許和拒絕政策的問題,您必須具備組織權限,且該組織包含要排解問題的資源。這些權限可讓您查看控管資源存取權的允許和拒絕政策。

如要取得排解主體存取權問題所需的權限,請要求管理員在包含要排解存取權問題的資源的組織中,授予您下列 IAM 角色:

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

您或許也能透過自訂角色或其他預先定義的角色,取得必要權限。

如果您沒有查看資源允許和拒絕政策的權限,這些允許和拒絕政策的存取結果會是 Unknown。

具備排解主體存取邊界政策問題的權限

如要排解主體存取邊界政策的問題,您必須具備組織權限,且該組織的主體集包含該主體。識別這個組織的方式取決於主體類型:

  • Google 帳戶和 Google 群組:與 Google Workspace 網域 (包含主體) 相關聯的組織
  • 聯合身分 (員工身分集區或 workload identity pool 中的身分):包含主體所屬身分集區的組織
  • 服務帳戶:建立服務帳戶的專案所屬組織
  • 代理身分:建立代理的專案所屬組織

這些權限可讓您查看主體存取邊界政策,瞭解主體可以存取哪些內容。

如要取得排解主體存取權問題所需的權限,請要求管理員在適當的組織中,授予您下列 IAM 角色:

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

您或許也能透過自訂角色或其他預先定義的角色,取得必要權限。

如果您沒有權限查看套用至主體的主體存取邊界政策,主體存取邊界政策的存取結果會是 Unknown。

具備排解群組成員存取權問題的權限

如果允許和拒絕政策包含群組,您需要 Google Workspace Admin API 權限 groups.read,才能排解個別群組成員的存取權問題。超級管理員和群組管理員會自動取得這項權限。如要將這項權限授予非超級管理員或群組管理員的使用者,請建立自訂 Google Workspace 管理員角色,並在其中加入 groups.read 權限 (位於「Admin API 權限」下方),然後將該角色授予使用者。

如果您沒有這些權限,則包含群組或網域的角色繫結和拒絕規則,其存取權結果會是「不明」,除非角色繫結或拒絕規則也明確包含主體。

具備排解網域成員存取權問題的權限

如果允許和拒絕政策包含 Google Workspace 帳戶或 Cloud Identity 網域,您必須是網域管理員,才能排解個別網域成員的存取問題。

如果您沒有這些權限,則包含群組或網域的角色繫結和拒絕規則,其存取權結果會是「不明」,除非角色繫結或拒絕規則也明確包含主體。

疑難排解存取

如要排解存取權問題,您需要知道要檢查的主體、資源和權限。這項資訊可由錯誤 ID 提供:

  • 錯誤 ID:權限錯誤訊息的專屬 ID。錯誤 ID 會提供錯誤的背景資訊,包括主體、資源、權限和支援的 IAM 條件。與代理身分相關的錯誤 ID,可提供代理身分及其聲明的背景資訊,例如平台和容器。

    支援的 IAM 條件包括 principal.type 和 principal.subject。

如果沒有錯誤 ID,可以參考下列資訊排解存取問題:

  • 主體:要檢查的身分。您可以輸入下列其中一項:

    • 電子郵件地址:必須參照使用者、單一服務帳戶或服務帳戶主體集。

    • 代理身分 ID:必須採用下列格式:TRUST_DOMAIN/resources/SERVICE/RESOURCE_PATH。

      例如: agents.global.org-123456789012.system.id.goog/resources/aiplatform/projects/9876543210/locations/us-central1/reasoningEngines/my-test-agent

      政策疑難排解工具會使用標準模式 resources/{platform}/projects/{project_number}/...,從代理的主體字串中擷取平台和資源容器屬性。如果代理程式使用非標準主體格式,政策疑難排解工具就無法衍生其屬性,且以屬性為基礎的主體集繫結會評估為 Unknown。

      如果代理程式沒有授予允許繫結,政策疑難排解工具會傳回 UNKNOWN_INFO 的存取狀態,而非 NOT_GRANTED。

      ID 格式如下:

      • TRUST_DOMAIN:貴組織的信任網域 (例如 agents.global.org-123456789012.system.id.goog)

      • SERVICE: Google Cloud服務的簡稱 (例如 aiplatform 或 discoveryengine)

      • RESOURCE_PATH:託管代理的 資源完整路徑

    不支援其他類型的主體,包括群組、網域、員工身分和 Workload Identity。

  • 資源:要排解存取權問題的資源完整名稱。例如,如要排解專案 my-project 的存取權問題,請輸入 //cloudresourcemanager.googleapis.com/projects/my-project。如需其他類型的資源,請參閱完整資源名稱範例。

  • 權限:要檢查的權限。如果使用Google Cloud 控制台,系統會在您輸入時顯示建議清單。

    如要排解權限問題,該權限必須適用於要求中的資源。換句話說,必須能以某種方式使用該權限存取資源。如果權限不適用於該資源,要求就會失敗。舉例來說,如果您嘗試排解 Google Kubernetes Engine 叢集的 compute.instances.get 權限問題,要求會失敗,因為 compute.instance.get 權限無法用於存取 Google Kubernetes Engine 叢集。

    如需完整的權限清單,請參閱權限參考資料。

控制台

如要排解存取問題,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Policy Troubleshooter」(政策疑難排解工具) 頁面。

    前往政策疑難排解工具

  2. 如果您有錯誤 ID,請選取「Error ID」(錯誤 ID) 並輸入。

  3. 如果沒有錯誤 ID,請選取「手動」。

    1. 輸入要檢查存取權的主體電子郵件地址或代理身分 ID。

    2. 輸入要檢查的資源完整名稱。

      如果您不知道完整資源名稱,請執行下列任一操作:

      • 如要排解專案、資料夾或組織的存取權問題,請開始輸入內容,查看自動完成選項。
      • 如要排解其他資源類型的存取權問題,請按一下「Browse」(瀏覽) 開啟資源搜尋對話方塊,然後搜尋資源:

        1. 在「Select scope」(選取範圍) 方塊中,選取要搜尋的專案、資料夾或組織。
        2. 在「Resource type」(資源類型) 方塊中,選取要搜尋的資源類型。
        3. 在「Search for resources」(搜尋資源) 方塊中,輸入資源名稱的一部分。
        4. 在結果部分,選取要檢查的資源。
        5. 按一下「Select」(選取) 選擇資源,然後關閉對話方塊。
    3. 輸入要檢查的權限。

      如果您不知道完整的權限名稱,請開始輸入,查看自動完成選項。

    4. 選用:如要檢查多項資源和權限,請選取「Add Another Pair」(新增另一組),然後重複上一個步驟。

  4. 按一下「檢查存取權」。

gcloud

如要瞭解主體擁有或不具備 IAM 權限的原因,請使用 gcloud beta policy-troubleshoot iam 指令。

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

  • VERSION:選用。要使用的指令版本。如要根據允許和拒絕政策排解存取問題,請勿指定版本。如要根據允許、拒絕和主體存取邊界政策排解存取權問題,請使用 beta 版本。
  • EMAIL:您要疑難排解權限問題的主體電子郵件地址。如果是代理身分,則必須提供主體 ID。
  • RESOURCE:要授予權限的資源。
  • PERMISSION:要排解問題的權限。

執行 gcloud beta policy-troubleshoot iam 指令:

Linux、macOS 或 Cloud Shell

gcloud VERSION policy-intelligence troubleshoot-policy iam RESOURCE --principal-email=EMAIL \
    --permission=PERMISSION

Windows (PowerShell)

gcloud VERSION policy-intelligence troubleshoot-policy iam RESOURCE --principal-email=EMAIL `
    --permission=PERMISSION

Windows (cmd.exe)

gcloud VERSION policy-intelligence troubleshoot-policy iam RESOURCE --principal-email=EMAIL ^
    --permission=PERMISSION

您應該會收到類似以下的回應:

回應

{
  "accessTuple": {
    "conditionContext": {
      "destination": {},
      "effectiveTags": [
        {
          "namespacedTagKey": "project-1/tag-key-1",
          "namespacedTagValue": "project-1/tag-key-1/tag-value-1",
          "tagKey": "tagKeys/123456789012",
          "tagKeyParentName": "projects/123456789012",
          "tagValue": "tagValues/123456789012"
        },
      ],
      "request": {},
      "resource": {}
    },
    "fullResourceName": "//cloudresourcemanager.googleapis.com/projects/project-1",
    "permission": "bigtable.instances.create",
    "permissionFqdn": "bigtable.googleapis.com/instances.create",
    "principal": "service-account-3@project-1."
  },
  "allowPolicyExplanation": {
    "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
    "explainedPolicies": [
      {
        "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
        "bindingExplanations": [
          {
            "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
            "combinedMembership": {
              "membership": "MEMBERSHIP_NOT_MATCHED",
              "relevance": "HEURISTIC_RELEVANCE_NORMAL"
            },
            "condition": {
              "expression": "resource.type == \"cloudresourcemanager.googleapis.com/Project\"",
              "title": "Resource-based condition"
            },
            "conditionExplanation": {
              "evaluationStates": [
                {
                  "end": 62,
                  "value": false
                }
              ],
              "value": false
            },
            "memberships": {
              "serviceAccount:service-account-1@project-1.": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              }
            },
            "relevance": "HEURISTIC_RELEVANCE_NORMAL",
            "role": "roles/bigquery.admin",
            "rolePermission": "ROLE_PERMISSION_NOT_INCLUDED",
            "rolePermissionRelevance": "HEURISTIC_RELEVANCE_NORMAL"
          },
          {
            "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
            "combinedMembership": {
              "membership": "MEMBERSHIP_NOT_MATCHED",
              "relevance": "HEURISTIC_RELEVANCE_NORMAL"
            },
            "condition": {
              "expression": "resource.matchTag(\"project-1/tag-key-1\", \"tag-value-1\")",
              "title": "Tag-based condition"
            },
            "conditionExplanation": {
              "evaluationStates": [
                {
                  "end": 73,
                  "value": true
                }
              ],
              "value": true
            },
            "memberships": {
              "serviceAccount:service-account-2@project-1.": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              }
            },
            "relevance": "HEURISTIC_RELEVANCE_NORMAL",
            "role": "roles/bigquery.admin",
            "rolePermission": "ROLE_PERMISSION_NOT_INCLUDED",
            "rolePermissionRelevance": "HEURISTIC_RELEVANCE_NORMAL"
          },
          {
            "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
            "combinedMembership": {
              "membership": "MEMBERSHIP_NOT_MATCHED",
              "relevance": "HEURISTIC_RELEVANCE_NORMAL"
            },
            "memberships": {
              "user:user-2@example.com": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              }
            },
            "relevance": "HEURISTIC_RELEVANCE_NORMAL",
            "role": "roles/compute.admin",
            "rolePermission": "ROLE_PERMISSION_NOT_INCLUDED",
            "rolePermissionRelevance": "HEURISTIC_RELEVANCE_NORMAL"
          },
          {
            "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
            "combinedMembership": {
              "membership": "MEMBERSHIP_NOT_MATCHED",
              "relevance": "HEURISTIC_RELEVANCE_NORMAL"
            },
            "memberships": {
              "user:user-1@example.com": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              },
              "user:user-3@example.com": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              }
            },
            "relevance": "HEURISTIC_RELEVANCE_NORMAL",
            "role": "roles/iam.serviceAccountTokenCreator",
            "rolePermission": "ROLE_PERMISSION_NOT_INCLUDED",
            "rolePermissionRelevance": "HEURISTIC_RELEVANCE_NORMAL"
          },
          {
            "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
            "combinedMembership": {
              "membership": "MEMBERSHIP_NOT_MATCHED",
              "relevance": "HEURISTIC_RELEVANCE_NORMAL"
            },
            "memberships": {
              "user:user-2@example.com": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              },
              "user:user-1@example.com": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              }
            },
            "relevance": "HEURISTIC_RELEVANCE_HIGH",
            "role": "roles/owner",
            "rolePermission": "ROLE_PERMISSION_INCLUDED",
            "rolePermissionRelevance": "HEURISTIC_RELEVANCE_HIGH"
          },
          {
            "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
            "combinedMembership": {
              "membership": "MEMBERSHIP_MATCHED",
              "relevance": "HEURISTIC_RELEVANCE_NORMAL"
            },
            "memberships": {
              "serviceAccount:service-account-3@project-1.": {
                "membership": "MEMBERSHIP_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              },
              "serviceAccount:service-account-4@project-1.": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              }
            },
            "relevance": "HEURISTIC_RELEVANCE_NORMAL",
            "role": "roles/resourcemanager.projectIamAdmin",
            "rolePermission": "ROLE_PERMISSION_NOT_INCLUDED",
            "rolePermissionRelevance": "HEURISTIC_RELEVANCE_NORMAL"
          },
          {
            "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
            "combinedMembership": {
              "membership": "MEMBERSHIP_NOT_MATCHED",
              "relevance": "HEURISTIC_RELEVANCE_NORMAL"
            },
            "memberships": {
              "serviceAccount:service-account-4@project-1.": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              }
            },
            "relevance": "HEURISTIC_RELEVANCE_NORMAL",
            "role": "roles/resourcemanager.tagViewer",
            "rolePermission": "ROLE_PERMISSION_NOT_INCLUDED",
            "rolePermissionRelevance": "HEURISTIC_RELEVANCE_NORMAL"
          }
        ],
        "fullResourceName": "//cloudresourcemanager.googleapis.com/projects/project-1",
        "policy": {
          "bindings": [
            {
              "condition": {
                "expression": "resource.type == \"cloudresourcemanager.googleapis.com/Project\"",
                "title": "Resource-based condition"
              },
              "members": [
                "serviceAccount:service-account-1@project-1."
              ],
              "role": "roles/bigquery.admin"
            },
            {
              "condition": {
                "expression": "resource.matchTag(\"project-1/tag-key-1\", \"tag-value-1\")",
                "title": "Tag-based condition"
              },
              "members": [
                "serviceAccount:service-account-2@project-1."
              ],
              "role": "roles/bigquery.admin"
            },
            {
              "members": [
                "user:user-2@example.com"
              ],
              "role": "roles/compute.admin"
            },
            {
              "members": [
                "user:user-1@example.com",
                "user:user-3@example.com"
              ],
              "role": "roles/iam.serviceAccountTokenCreator"
            },
            {
              "members": [
                "user:user-2@example.com",
                "user:user-1@example.com"
              ],
              "role": "roles/owner"
            },
            {
              "members": [
                "serviceAccount:service-account-3@project-1.",
                "serviceAccount:service-account-4@project-1."
              ],
              "role": "roles/resourcemanager.projectIamAdmin"
            },
            {
              "members": [
                "serviceAccount:service-account-4@project-1."
              ],
              "role": "roles/resourcemanager.tagViewer"
            }
          ],
          "etag": "BwYY6ttEMEY=",
          "version": 3
        },
        "relevance": "HEURISTIC_RELEVANCE_HIGH"
      },
    ],
    "relevance": "HEURISTIC_RELEVANCE_HIGH"
  },
  "denyPolicyExplanation": {
    "denyAccessState": "DENY_ACCESS_STATE_NOT_DENIED",
    "explainedResources": [
      {
        "denyAccessState": "DENY_ACCESS_STATE_NOT_DENIED",
        "explainedPolicies": [
          {
            "denyAccessState": "DENY_ACCESS_STATE_NOT_DENIED",
            "policy": {
              "createTime": "2024-04-09T23:28:24.103203Z",
              "displayName": "Troubleshooter v3 prober non-tag deny policy",
              "etag": "MTgyMzk3MDY4OTY4MDE0ODg4OTY=",
              "kind": "DenyPolicy",
              "name": "policies/cloudresourcemanager.googleapis.com%2Fprojects%2F546942305807/denypolicies/deny-policy-1",
              "rules": [
                {
                  "denyRule": {
                    "deniedPermissions": [
                      "bigquery.googleapis.com/datasets.create"
                    ],
                    "deniedPrincipals": [
                      "principal://iam.googleapis.com/projects/-/serviceAccounts/service-account-1@project-1."
                    ]
                  }
                }
              ],
              "uid": "fab63b4d-ecfb-5f06-8a6d-602bf1be5062",
              "updateTime": "2024-05-20T23:29:38.428095Z"
            },
            "relevance": "HEURISTIC_RELEVANCE_HIGH",
            "ruleExplanations": [
              {
                "combinedDeniedPermission": {
                  "permissionMatchingState": "PERMISSION_PATTERN_NOT_MATCHED",
                  "relevance": "HEURISTIC_RELEVANCE_HIGH"
                },
                "combinedDeniedPrincipal": {
                  "membership": "MEMBERSHIP_NOT_MATCHED",
                  "relevance": "HEURISTIC_RELEVANCE_HIGH"
                },
                "combinedExceptionPermission": {
                  "permissionMatchingState": "PERMISSION_PATTERN_NOT_MATCHED",
                  "relevance": "HEURISTIC_RELEVANCE_NORMAL"
                },
                "combinedExceptionPrincipal": {
                  "membership": "MEMBERSHIP_NOT_MATCHED",
                  "relevance": "HEURISTIC_RELEVANCE_NORMAL"
                },
                "deniedPermissions": {
                  "bigquery.googleapis.com/datasets.create": {
                    "permissionMatchingState": "PERMISSION_PATTERN_NOT_MATCHED",
                    "relevance": "HEURISTIC_RELEVANCE_HIGH"
                  }
                },
                "deniedPrincipals": {
                  "principal://iam.googleapis.com/projects/-/serviceAccounts/service-account-1@project-1.": {
                    "membership": "MEMBERSHIP_NOT_MATCHED",
                    "relevance": "HEURISTIC_RELEVANCE_HIGH"
                  }
                },
                "denyAccessState": "DENY_ACCESS_STATE_NOT_DENIED",
                "relevance": "HEURISTIC_RELEVANCE_HIGH"
              }
            ]
          },
        ],
        "fullResourceName": "//cloudresourcemanager.googleapis.com/projects/123456789012",
        "relevance": "HEURISTIC_RELEVANCE_HIGH"
      }
    ],
    "permissionDeniable": true,
    "relevance": "HEURISTIC_RELEVANCE_NORMAL"
  },
  "overallAccessState": "CANNOT_ACCESS",
  "pabPolicyExplanation": {
    "explainedBindingsAndPolicies": [
      {
        "bindingAndPolicyAccessState": "PAB_ACCESS_STATE_NOT_ENFORCED",
        "explainedPolicy": {
          "explainedRules": [
            {
              "combinedResourceInclusionState": "RESOURCE_INCLUSION_STATE_NOT_INCLUDED",
              "effect": "ALLOW",
              "explainedResources": [
                {
                  "relevance": "HEURISTIC_RELEVANCE_NORMAL",
                  "resource": "//cloudresourcemanager.googleapis.com/projects/project-2",
                  "resourceInclusionState": "RESOURCE_INCLUSION_STATE_NOT_INCLUDED"
                }
              ],
              "relevance": "HEURISTIC_RELEVANCE_NORMAL",
              "ruleAccessState": "PAB_ACCESS_STATE_NOT_ALLOWED"
            }
          ],
          "policy": {
            "createTime": "2024-04-09T17:40:51.627668Z",
            "details": {
              "enforcementVersion": "1",
              "rules": [
                {
                  "effect": "ALLOW",
                  "resources": [
                    "//cloudresourcemanager.googleapis.com/projects/project-2"
                  ]
                }
              ]
            },
            "displayName": "Troubleshooter v3 PAB Policy",
            "etag": "m64s4IgR80eDJDywuVA2DA==",
            "name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy",
            "uid": "puid_11875429267422576641",
            "updateTime": "2024-04-09T17:40:51.627668Z"
          },
          "policyAccessState": "PAB_ACCESS_STATE_NOT_ENFORCED",
          "policyVersion": {
            "enforcementState": "PAB_POLICY_ENFORCEMENT_STATE_NOT_ENFORCED",
            "version": 1
          },
          "relevance": "HEURISTIC_RELEVANCE_NORMAL"
        },
        "explainedPolicyBinding": {
          "conditionExplanation": {
            "evaluationStates": [
              {
                "end": 53,
                "value": true
              },
              {
                "end": 153,
                "start": 58,
                "value": false
              },
              {
                "end": 248,
                "start": 157,
                "value": false
              }
            ],
            "value": false
          },
          "policyBinding": {
            "condition": {
              "expression": "principal.type == 'iam.googleapis.com/ServiceAccount' && (principal.subject=='service-account-1@project-1.' || principal.subject=='service-account-2@project-1.')"
            },
            "createTime": "2024-04-09T17:51:13.504418Z",
            "displayName": "PAB Policy Binding on project-1 project",
            "etag": "W/\"hz9IKzHsIqvopqDRcVYDxQ==\"",
            "name": "projects/123456789012/locations/global/policyBindings/example-policy-binding",
            "policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy",
            "policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
            "policyUid": "puid_11875429267422576641",
            "target": {
              "principalSet": "//cloudresourcemanager.googleapis.com/projects/project-1"
            },
            "uid": "buid_1012746966204940289", 
            "updateTime": "2024-05-09T23:08:56.846355Z"
          },
          "policyBindingState": "POLICY_BINDING_STATE_NOT_ENFORCED",
          "relevance": "HEURISTIC_RELEVANCE_NORMAL"
        },
        "relevance": "HEURISTIC_RELEVANCE_NORMAL"
      }
    ],
    "principalAccessBoundaryAccessState": "PAB_ACCESS_STATE_NOT_ENFORCED",
    "relevance": "HEURISTIC_RELEVANCE_NORMAL"
  }
}

REST

如要瞭解主體具備或不具備 IAM 權限的原因,請使用政策疑難排解工具 API 的 iam.troubleshoot 方法。

使用任何要求資料之前,請先修改下列項目的值:

  • VERSION:這項要求要使用的 API 版本。如要僅根據允許和拒絕政策排解存取權問題,請使用 v3。如要根據允許、拒絕和主體存取邊界政策排解存取權問題,請使用 v3beta。
  • EMAIL:您要疑難排解權限問題的主體電子郵件地址。如果是代理身分,則必須提供主體 ID。
  • RESOURCE:要授予權限的資源。
  • PERMISSION:要排解問題的權限。
  • PROJECT_ID:要用來提出要求的專案 ID。專案 ID 是英數字串,例如 my-project。

HTTP 方法和網址:

POST https://policytroubleshooter.googleapis.com/VERSION/iam:troubleshoot

JSON 要求主體:

{
  "accessTuple": {
    "principal": "EMAIL",
    "fullResourceName": "RESOURCE",
    "permission": "PERMISSION"
  }
}

請展開以下其中一個選項,以傳送要求:

您應該會收到如下的 JSON 回覆:

瞭解疑難排解工具結果

控制台

結果頁面包含下列資訊:

評估詳細資料

「Evaluation details」(評估詳細資料) 部分會提供您要排解問題的存取權摘要,包括指定的主體、資源和權限。如要排解多個資源權限組合的問題,可以使用「Access Evaluation」(存取權評估) 清單切換。

政策詳細資料

「Policy details」(政策詳細資料) 專區包含相關允許、拒絕和主體存取邊界政策如何影響主體存取權的詳細資料。

相關的主體存取邊界政策包括所有繫結至主體集 (包含主體) 的主體存取邊界政策。

相關的允許和拒絕政策包括:

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

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

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

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

「Policy details」(政策詳細資料) 區段包含下列部分:

存取狀態

「Access state」(存取權狀態) 專區會匯總各政策類型 (主體存取邊界政策、拒絕政策和允許政策) 的結果,並說明整體結果。結果會指出主體是否能根據相關政策,使用權限存取資源。

使用者必須獲得所有政策類型的存取權,才能使用權限存取資源。詳情請參閱「政策評估」。

主體存取邊界政策

在「Principal access boundary policy」(主體存取邊界政策) 區段中,您可以查看主體適用的所有主體存取邊界政策,以及將這些政策繫結至主體的政策繫結。

「Policies」(政策) 窗格會列出繫結至主體組合的所有政策,其中包含主體。每項政策旁邊都有一個圖示,指出該政策對主體存取權的影響。

主體存取邊界政策會以下列方式影響主體的存取權:

  • 「Principal is eligible to access the resource」(主體可以存取資源):主體存取邊界政策適用於主體,且其中一項規則含有查詢的資源。
  • 「Principal is ineligible to access the resource」(主體不可存取資源):主體存取邊界政策適用於主體,但查詢的資源不在該政策的規則中。
  • 未強制執行: 在下列情況下,系統不會強制執行主體存取邊界政策:

    • IAM 不會在主體存取邊界政策的強制執行版本強制執行指定權限。因此,主體存取邊界政策無法封鎖存取權。
    • 由於政策繫結中的條件,主體存取邊界政策或繫結不適用於主體。
    • 主體存取邊界政策沒有任何規則。

    如果未強制執行主體存取邊界政策,就不會影響主體是否能存取資源。

如要查看與主體存取邊界政策相關聯的規則和繫結,請按一下政策名稱。「Policies」(政策) 窗格旁的窗格會顯示政策詳細資料。

如要查看政策中的規則,請按一下「Boundary rules」(邊界規則) 分頁標籤。這個分頁會顯示相關主體存取邊界政策規則的表格。

如果主體存取邊界規則會影響政策疑難排解工具查詢的整體結果,則該規則即為相關規則。因此,相關規則會因政策疑難排解工具結果而異。例如,請考慮以下情況:

  • 政策疑難排解工具會指出主體可以存取資源。因此,相關規則是指讓主體有資格存取資源的規則。
  • 政策疑難排解工具會指出主體無法存取資源。不過,根據相關的主體存取邊界政策,主體可以存取資源。因此,沒有任何規則相關,因為主體無法存取資源的原因並非主體存取邊界政策。
  • 政策疑難排解工具會指出主體無法存取資源。此外,根據相關的主體存取邊界政策,主體無法存取資源。因此,相關規則是指不會讓主體有權存取資源的規則。

如要查看政策中的所有主體存取邊界規則,請取消勾選「Show only relevant rules and bindings」(只顯示相關的規則和繫結) 核取方塊。

邊界規則表格中的「Findings」(發現項目) 欄,會指出主體存取邊界規則是否含有查詢的資源。如要查看規則詳情,請按一下「See rule details」(查看規則詳情)。

如要查看政策的政策繫結,請按一下「Bindings」(繫結) 分頁標籤。這個分頁會顯示所選主體存取邊界政策的相關政策繫結表格。

如果政策繫結能有效將主體存取邊界政策套用至查詢的主體,則該繫結具有相關性。如要透過政策繫結將主體存取邊界政策套用至主體,必須符合下列條件:

  • 政策繫結中設定的主體必須包含查詢的主體
  • 政策繫結中的任何條件,都必須針對查詢的主體評估為 true。

如要查看所有政策繫結,且這些繫結的主體集包含查詢的主體,無論查詢的主體是否符合繫結中的條件,請取消勾選「Show only relevant rules and bindings」(僅顯示相關規則和繫結) 核取方塊。

如果是代理身分,政策疑難排解工具會評估與代理託管專案或容器資源階層相關聯的主體存取邊界政策,並評估符合代理身分類型 (principal.type == 'iam.googleapis.com/AgentPoolIdentity') 和主體模式 (principal.subject.startsWith(...)) 的條件。

繫結表格中的「Findings」(發現項目) 欄會指出是否對查詢的主體強制執行繫結。如要查看政策繫結的詳細資料,請按一下「See binding details」(查看繫結詳細資料)。

拒絕政策

在「Deny policy」(拒絕政策) 專區中,您可以查看所有相關拒絕政策、找出拒絕主體存取權的拒絕規則,並瞭解拒絕規則拒絕或不拒絕主體權限的原因。

「Resources with deny policies」(設有拒絕政策的資源) 窗格會列出所有相關的拒絕政策,並依附加的資源分類。每項拒絕政策旁都會顯示存取權評估結果。這項評估僅適用於該拒絕政策,不會反映沿用政策的任何存取權。如果您沒有查看資源拒絕政策的權限,資源清單就不會列出該資源或其拒絕政策。

如要查看這些拒絕政策中的相關拒絕規則,請按一下拒絕政策。如要查看資源拒絕政策中的所有拒絕規則,請按一下資源。拒絕規則會顯示在「Deny rules」(拒絕規則) 窗格中。這個窗格會顯示資料表,列出所有拒絕規則,其中包含所選資源或拒絕政策的查詢主體或權限。

「Access」(存取權) 欄會指出拒絕規則是否拒絕主體的權限。如要查看拒絕規則的詳細資料,請按一下該規則列中的「See deny rule」(查看拒絕規則)。

允許政策

在「Allow policy」(允許政策) 專區中,您可以瀏覽所有相關允許政策、找出授予主體存取權的角色繫結,並瞭解角色繫結授予或不授予主體權限的原因。

「Resources」(資源) 窗格會列出指定的資源及其祖系。每項資源旁邊都會顯示存取權評估結果。這項評估僅適用於該資源的允許政策,不會反映沿用政策授予的任何存取權。如果您沒有查看資源允許政策的權限,資源清單就不會列出該資源。

如要查看資源允許政策中的相關角色繫結,以及這些繫結是否授予主體權限,請按一下資源。允許政策的角色繫結會顯示在「Role bindings」(角色繫結) 窗格中。

「Role bindings」(角色繫結) 窗格會顯示所選資源許可政策中的角色繫結表格。根據預設,表格只會列出包含指定權限角色的繫結。如果主體沒有存取權,表格也會顯示可編輯的自訂角色繫結。如要查看所有角色繫結,請取消勾選「Show only relevant bindings」(僅顯示相關繫結) 核取方塊。

「Access」(存取權) 欄會指出角色繫結是否授予主體權限。如要查看角色繫結的詳細資料,請按一下該角色繫結資料列中的「See binding details」(查看繫結詳細資料)。

評估代理身分的允許政策時,政策疑難排解工具會檢查代理是否符合下列任一主體 ID:

主體 ID 範例
直接代理身分 principal://TRUST_DOMAIN/resources/SERVICE/RESOURCE_PATH
信任網域主體集 principalSet://TRUST_DOMAIN/*
平台主體集 principalSet://TRUST_DOMAIN/attribute.platform/SERVICE
資源容器主體集 principalSet://TRUST_DOMAIN/attribute.container/projects/PROJECT_NUMBER
平台容器主體集 principalSet://TRUST_DOMAIN/attribute.platformContainer/SERVICE/projects/PROJECT_NUMBER

排解非代理主體 (例如使用者或服務帳戶) 的存取權問題時,代理身分的任何角色繫結都會評估為 Not matched。

gcloud

回應包含四個主要部分:要求中的存取權元組說明、允許政策評估結果、拒絕政策評估結果,以及整體存取狀態。

  • accessTuple:要求中存取權元組的說明,包括您提供的任何條件背景資訊。這個部分也會提供適用於資源的標記摘要。
  • allowPolicyExplanation:摘要說明相關允許政策是否授予主體權限,後面接著允許政策及其角色繫結的清單。

    針對每項允許政策,回應會列出政策中的所有角色繫結,並根據下列條件進行評估:

    • 角色繫結是否包含權限。
    • 角色繫結是否包含主體。
    • 是否符合角色繫結中的條件 (如有)。

    接著,回應會輸出允許政策的完整 JSON 文字。

  • denyPolicyExplanation:相關拒絕政策是否拒絕主體權限的摘要,後面接著具有拒絕政策的資源清單。針對每項資源,回應會列出附加至資源的所有拒絕政策。

    針對每項拒絕政策,回應會列印政策的中繼資料、列出政策中的拒絕規則,然後根據下列條件評估每項規則:

    • 拒絕規則是否包含權限。
    • 權限是否在拒絕規則中列為例外狀況。
    • 拒絕規則是否包含主體。
    • 主體是否列為拒絕規則中的例外狀況。
    • 是否符合拒絕規則中的條件 (如有)。
  • overallAccessState:主體是否能根據相關的允許政策、拒絕政策和主體存取邊界政策,使用指定權限存取指定資源。

    相關的主體存取邊界政策包括所有繫結至主體集 (包含主體) 的主體存取邊界政策。

    相關的允許和拒絕政策包括:

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

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

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

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

    使用者必須獲得所有政策類型的存取權,才能使用權限存取資源。詳情請參閱「政策評估」。

  • pabPolicyExplanation:摘要說明相關的主體存取邊界政策是否允許主體存取資源,後面接著相關的主體存取邊界政策繫結和主體存取邊界政策。

    主體存取邊界政策可以允許存取、不允許存取,或不強制執行。在下列情況下,系統不會強制執行主體存取邊界政策:

    • IAM 不會在主體存取邊界政策的強制執行版本強制執行指定權限。因此,主體存取邊界政策無法封鎖存取權。
    • 由於政策繫結中的條件,主體存取邊界政策或繫結不適用於主體。
    • 主體存取邊界政策沒有任何規則。

    如果未強制執行主體存取邊界政策,就不會影響主體是否能存取資源。

    回應也會列出包含主體的所有政策繫結,以及各個政策繫結中的主體存取邊界政策詳細資料:

    • 針對每個主體存取邊界政策繫結,回應會列印是否對主體強制執行政策繫結,然後列印政策繫結的文字。如果繫結中設定的主體集包含查詢的主體,且政策繫結中的條件對查詢的主體評估為 true,系統就會強制執行政策繫結。如果未強制執行政策繫結,政策就不會影響主體是否能存取資源。
    • 針對每項主體存取邊界政策,回應會顯示下列內容:

      • 政策是否允許存取、不允許存取或未強制執行。
      • 政策的強制執行版本。這個版本編號會決定 IAM 是否針對查詢的權限,強制執行這項主體存取邊界政策。如果未強制執行權限,政策就不會影響主體是否能存取資源。
      • 主體存取邊界政策中的規則,以及各項規則是否允許存取。回應會指出查詢的資源是否包含在各項規則中。

        只要符合下列任一條件,規則就會納入資源:

        • 規則中列出該資源。只有 Resource Manager 資源 (專案、資料夾和組織) 可以直接列在主體存取邊界規則中。
        • 規則中列出資源的其中一個祖系 (即資源階層中位於資源上方的專案、資料夾或組織)。

回應中的許多物件也包含 relevance 欄位。這個欄位的值表示該物件對整體存取狀態的影響程度。relevance 欄位可能包含下列值:

  • HEURISTIC_RELEVANCE_HIGH:表示物件對結果有重大影響。換句話說,移除物件可能會變更整體存取狀態。舉例來說,如果角色繫結會授予主體指定權限,就會有這個關聯性值。

  • HEURISTIC_RELEVANCE_NORMAL:表示物件對結果的影響有限。換句話說,移除物件不太可能改變整體存取狀態。舉例來說,如果拒絕規則不含權限或主體,就會有這個關聯性值。

REST

回應包含四個主要部分:整體存取狀態、要求中的存取元組說明、允許政策評估結果,以及拒絕政策評估結果。

  • overallAccessState:主體是否能根據相關的允許政策、拒絕政策和主體存取邊界政策,使用指定權限存取指定資源。

    相關的主體存取邊界政策包括所有繫結至主體集 (包含主體) 的主體存取邊界政策。

    相關的允許和拒絕政策包括:

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

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

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

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

    使用者必須獲得所有政策類型的存取權,才能使用權限存取資源。詳情請參閱「政策評估」。

  • accessTuple:要求中存取權元組的說明,包括您提供的任何條件背景資訊。這個部分也會提供適用於資源的標記摘要。
  • allowPolicyExplanation:摘要說明相關允許政策是否授予主體權限,後面接著允許政策及其角色繫結的清單。

    針對每項允許政策,回應會列出政策中的所有角色繫結,並根據下列條件進行評估:

    • 角色繫結是否包含權限。
    • 角色繫結是否包含主體。
    • 是否符合角色繫結中的條件 (如有)。

    接著,回應會輸出允許政策的完整 JSON 文字。

  • denyPolicyExplanation:相關拒絕政策是否拒絕主體權限的摘要,後面接著具有拒絕政策的資源清單。針對每項資源,回應會列出附加至資源的所有拒絕政策。

    針對每項拒絕政策,回應會列印政策的中繼資料、列出政策中的拒絕規則,然後根據下列條件評估每項規則:

    • 拒絕規則是否包含權限。
    • 權限是否在拒絕規則中列為例外狀況。
    • 拒絕規則是否包含主體。
    • 主體是否列為拒絕規則中的例外狀況。
    • 是否符合拒絕規則中的條件 (如有)。
  • pabPolicyExplanation:摘要說明相關的主體存取邊界政策是否允許主體存取資源,後面接著相關的主體存取邊界政策繫結和主體存取邊界政策。

    主體存取邊界政策可以允許存取、不允許存取,或不強制執行。在下列情況下,系統不會強制執行主體存取邊界政策:

    • IAM 不會在主體存取邊界政策的強制執行版本強制執行指定權限。因此,主體存取邊界政策無法封鎖存取權。
    • 由於政策繫結中的條件,主體存取邊界政策或繫結不適用於主體。
    • 主體存取邊界政策沒有任何規則。

    如果未強制執行主體存取邊界政策,就不會影響主體是否能存取資源。

    回應也會列出包含主體的所有政策繫結,以及各個政策繫結中的主體存取邊界政策詳細資料:

    • 針對每個主體存取邊界政策繫結,回應會列印是否對主體強制執行政策繫結,然後列印政策繫結的文字。如果繫結中設定的主體集包含查詢的主體,且政策繫結中的條件對查詢的主體評估為 true,系統就會強制執行政策繫結。如果未強制執行政策繫結,政策就不會影響主體是否能存取資源。
    • 針對每項主體存取邊界政策,回應會顯示下列內容:

      • 政策是否允許存取、不允許存取或未強制執行。
      • 政策的強制執行版本。這個版本編號會決定 IAM 是否針對查詢的權限,強制執行這項主體存取邊界政策。如果未強制執行權限,政策就不會影響主體是否能存取資源。
      • 主體存取邊界政策中的規則,以及各項規則是否允許存取。回應會指出查詢的資源是否包含在各項規則中。

        只要符合下列任一條件,規則就會納入資源:

        • 規則中列出該資源。只有 Resource Manager 資源 (專案、資料夾和組織) 可以直接列在主體存取邊界規則中。
        • 規則中列出資源的其中一個祖系 (即資源階層中位於資源上方的專案、資料夾或組織)。

回應中的許多物件也包含 relevance 欄位。這個欄位的值表示該物件對整體存取狀態的影響程度。relevance 欄位可能包含下列值:

  • HEURISTIC_RELEVANCE_HIGH:表示物件對結果有重大影響。換句話說,移除物件可能會變更整體存取狀態。舉例來說,如果角色繫結會授予主體指定權限,就會有這個關聯性值。

  • HEURISTIC_RELEVANCE_NORMAL:表示物件對結果的影響有限。換句話說,移除物件不太可能改變整體存取狀態。舉例來說,如果拒絕規則不含權限或主體,就會有這個關聯性值。

排解條件式角色繫結問題

政策疑難排解工具會根據標記,自動排解條件式角色繫結和拒絕規則的問題。此外,這項工具也會自動排解主體存取邊界政策繫結的問題,並根據主體設定條件。

如要排解其他類型的條件式角色繫結或條件式拒絕規則,政策疑難排解工具需要更多要求相關背景資訊。舉例來說,如要排解日期/時間屬性條件的問題,政策疑難排解工具需要要求的時間。

在 gcloud CLI 和 REST API 中,您必須手動提供這項額外背景資訊。

在 Google Cloud 控制台中,您可以直接從任何管理員活動稽核記錄或資料存取稽核記錄進行疑難排解,提供這類額外背景資訊。每個稽核記錄項目都對應到Google Cloud API 的要求,或 Google Cloud 代表您執行的動作。從稽核記錄進行疑難排解時,政策疑難排解工具會自動取得要求的其他資訊,例如日期和時間,以便分析條件式角色繫結和拒絕規則。

控制台

如要排解條件式角色繫結和拒絕規則的問題,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Logs Explorer」頁面。

    前往「Logs Explorer」

  2. 如果網頁標題是「Legacy Logs Viewer」(舊版記錄檢視器),請按一下「Upgrade」(升級) 下拉式選單,然後選取「Upgrade to the new Logs Explorer」(升級至新的 Logs Explorer)。

  3. 如要僅查看管理員活動和資料存取稽核記錄,請在查詢建立工具中輸入下列查詢,然後按一下「Run query」(執行查詢):

    logName=("RESOURCE_TYPE/RESOURCE_ID/logs/cloudaudit.googleapis.com%2Factivity" OR "RESOURCE_TYPE/RESOURCE_ID/logs/cloudaudit.googleapis.com%2Fdata_access")
    

    替換下列值:

    • RESOURCE_TYPE:要列出稽核記錄的資源類型。請使用 projects、folders 或 organizations。
    • RESOURCE_ID:資源 ID。
  4. 找出與要疑難排解的要求相對應的稽核記錄項目。如要瞭解如何使用 Logs Explorer 尋找特定記錄項目,請參閱「使用 Logs Explorer」。

  5. 在記錄項目的「Summary」(摘要) 欄中,依序點選「IAM」和「Troubleshoot access issue」(排解存取權問題)。

    政策疑難排解工具會使用記錄項目中的資訊排解存取問題,然後顯示結果。額外背景資訊會列在評估詳細資料的「Condition context」(條件背景資訊) 下方。如要查看情境詳細資料,請按一下「View condition context」(查看條件情境)。如要進一步瞭解政策疑難排解工具結果頁面,請參閱本頁的「瞭解疑難排解工具結果」一節。

  6. 選用:如要排解涉及條件式角色繫結和拒絕規則的其他要求,請返回「Logs Explorer」頁面,並重複上述步驟。

gcloud

如要排解條件式角色繫結和拒絕規則的問題,請使用 gcloud policy-troubleshoot iam 指令。

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

  • EMAIL:您要排解權限問題的主體電子郵件地址。如果是代理身分,則必須提供主體 ID。
  • RESOURCE:授予權限的資源。
  • PERMISSION:要排解問題的權限。
  • DESTINATION_IP:選用。檢查條件式角色繫結時,要使用的要求目的地 IP 位址。例如:198.1.1.1。
  • DESTINATION_PORT:選用。檢查條件式角色繫結時要使用的要求目的地通訊埠。例如 `8080`。
  • REQUEST_TIME:選用。檢查條件式角色繫結時要使用的要求時間戳記。請使用 RFC 3339 格式的時間戳記,例如 2099-02-01T00:00:00Z。
  • RESOURCE_NAME:選用。檢查條件式角色繫結時要使用的資源名稱值。如需系統接受的資源名稱格式清單,請參閱「資源名稱格式」。
  • RESOURCE_SERVICE:選用。檢查條件式角色繫結時要使用的資源服務值。如需可接受的服務名稱清單,請參閱「資源服務值」。
  • RESOURCE_TYPE:選用。如需接受的資源類型清單,請參閱「資源類型值」。

執行 gcloud policy-troubleshoot iam 指令:

Linux、macOS 或 Cloud Shell

gcloud policy-intelligence troubleshoot-policy iam RESOURCE --principal-email=EMAIL \
    --permission=PERMISSION --destination-ip=DESTINATION_IP \
    --destination-port=DESTINATION_PORT --request-time=REQUEST_TIME \
    --resource-name=RESOURCE_NAME --resource-service=RESOURCE_SERVICE \
    --resource-type=RESOURCE_TYPE

Windows (PowerShell)

gcloud policy-intelligence troubleshoot-policy iam RESOURCE --principal-email=EMAIL `
    --permission=PERMISSION --destination-ip=DESTINATION_IP `
    --destination-port=DESTINATION_PORT --request-time=REQUEST_TIME `
    --resource-name=RESOURCE_NAME --resource-service=RESOURCE_SERVICE `
    --resource-type=RESOURCE_TYPE

Windows (cmd.exe)

gcloud policy-intelligence troubleshoot-policy iam RESOURCE --principal-email=EMAIL ^
    --permission=PERMISSION --destination-ip=DESTINATION_IP ^
    --destination-port=DESTINATION_PORT --request-time=REQUEST_TIME ^
    --resource-name=RESOURCE_NAME --resource-service=RESOURCE_SERVICE ^
    --resource-type=RESOURCE_TYPE

回覆會說明主體的存取權。對於每個具有條件的角色繫結和拒絕規則,回應會包含 conditionExplanation 欄位,說明條件是否根據您提供的條件背景資訊評估為 true 或 false。

舉例來說,以下是角色繫結的評估,其中條件指定了資源類型和資源服務:

回應

...
{
  "allowAccessState": "ALLOW_ACCESS_STATE_GRANTED",
  "combinedMembership": {
    "membership": "MEMBERSHIP_MATCHED",
    "relevance": "HEURISTIC_RELEVANCE_HIGH"
  },
  "condition": {
    "expression": " resource.type \u003d\u003d \"compute.googleapis.com/Instance\" \u0026\u0026 resource.service \u003d\u003d \"compute.googleapis.com\"",
    "title": "Compute instances only",
    "description": "Condition that limits permissions to only Compute instances"
  },
  "conditionExplanation": {
    "evaluationStates": [{
      "end": 51,
      "start": 1,
      "value": true
    }, {
      "end": 99,
      "start": 55,
      "value": true
    }],
    "value": true,
  },
  "memberships": {
    "user:my-user@example.com": {
      "membership": "MEMBERSHIP_MATCHED",
      "relevance": "HEURISTIC_RELEVANCE_HIGH"
    }
  },
  "relevance": "HEURISTIC_RELEVANCE_HIGH",
  "role": "roles/compute.viewer",
  "rolePermission": "ROLE_PERMISSION_INCLUDED",
  "rolePermissionRelevance": "HEURISTIC_RELEVANCE_HIGH"
}
...

REST

如要排解條件式角色繫結和拒絕規則的問題,請使用政策疑難排解工具 API 的 iam.troubleshoot 方法。

使用任何要求資料之前,請先修改下列項目的值:

  • EMAIL:您要排解權限問題的主體電子郵件地址。如果是代理身分,則必須提供主體 ID。
  • RESOURCE:授予權限的資源。
  • PERMISSION:要排解問題的權限。
  • DESTINATION_IP:選用。檢查條件式角色繫結時,要使用的要求目的地 IP 位址。例如:198.1.1.1。
  • DESTINATION_PORT:選用。檢查條件式角色繫結時要使用的要求目的地通訊埠。例如 `8080`。
  • REQUEST_TIME:選用。檢查條件式角色繫結時要使用的要求時間戳記。請使用 RFC 3339 格式的時間戳記,例如 2099-02-01T00:00:00Z。
  • RESOURCE_NAME:選用。檢查條件式角色繫結時要使用的資源名稱值。如需系統接受的資源名稱格式清單,請參閱「資源名稱格式」。
  • RESOURCE_SERVICE:選用。檢查條件式角色繫結時要使用的資源服務值。如需可接受的服務名稱清單,請參閱「資源服務值」。
  • RESOURCE_TYPE:選用。如需接受的資源類型清單,請參閱「資源類型值」。

HTTP 方法和網址:

POST https://policytroubleshooter.googleapis.com/v3/iam:troubleshoot

JSON 要求主體:

{
  "accessTuple": {
    "principal": "EMAIL",
    "fullResourceName": "RESOURCE",
    "permission": "PERMISSION",
    "conditionContext": {
      "destination": {
        "ip": DESTINATION_IP,
        "port": DESTINATION_PORT
      },
      "request": {
        "receiveTime": REQUEST_TIME
      },
      "resource": {
        "name": RESOURCE_NAME,
        "service": RESOURCE_SERVICE,
        "type": RESOURCE_TYPE
      }
    }
  }
}

請展開以下其中一個選項,以傳送要求:

回覆會說明主體的存取權。對於每個具有條件的角色繫結和拒絕規則,回應會包含 conditionExplanation 欄位,說明條件是否根據您提供的條件背景資訊評估為 true 或 false。

舉例來說,以下是角色繫結的評估,其中條件指定了資源類型和資源服務:

...
{
  "allowAccessState": "ALLOW_ACCESS_STATE_GRANTED",
  "role": "roles/compute.viewer",
  "rolePermission": "ROLE_PERMISSION_INCLUDED",
  "rolePermissionRelevance": "HEURISTIC_RELEVANCE_HIGH",
  "combinedMembership": {
    "membership": "MEMBERSHIP_MATCHED",
    "relevance": "HEURISTIC_RELEVANCE_HIGH"
  },
  "memberships": {
    "user:my-user@example.com": {
      "membership": "MEMBERSHIP_MATCHED",
      "relevance": "HEURISTIC_RELEVANCE_HIGH"
    }
  },
  "relevance": "HEURISTIC_RELEVANCE_HIGH",
  "condition": {
    "expression": " resource.type \u003d\u003d \"compute.googleapis.com/Instance\" \u0026\u0026 resource.service \u003d\u003d \"compute.googleapis.com\"",
    "title": "Compute instances only",
    "description": "Condition that limits permissions to only Compute instances"
  },
  "conditionExplanation": {
    "value": true,
    "evaluationStates": [{
      "start": 1,
      "end": 51,
      "value": true
    }, {
      "start": 55,
      "end": 99,
      "value": true
    }]
  }
}
...

後續步驟