本頁面說明如何排解 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,請按照下列步驟操作:
控制台
- 找出目標資源的所有父項資源。上層資源是指資源階層中位於該資源上方的任何專案、資料夾和組織。
- 查看繫結至各項上層資源的 UAP。如果 UAP 提及主體,則可能會影響主體對目標資源的存取權。
gcloud
- 找出目標資源的所有父項資源。上層資源是指資源階層中位於該資源上方的任何專案、資料夾和組織。
- 列出目標資源和每個目標資源祖系的 UAP 繫結。記錄每個繫結中的政策 ID。
- 查看您擷取的每個繫結中的每個 UAP。如果 UAP 提及主體,則可能會影響主體對目標資源的存取權。
REST
- 找出目標資源的所有父項資源。上層資源是指資源階層中位於該資源上方的任何專案、資料夾和組織。
- 列出目標資源和每個目標資源祖系的 UAP 繫結。記錄每個繫結中的政策 ID。
- 查看您擷取的每個繫結中的每個 UAP。如果 UAP 提及主體,則可能會影響主體對目標資源的存取權。