拒絕使用者授予存取權的權限,有助於防止未經授權的提權,並強化安全控管。本文說明如何找出這些權限,並建立拒絕政策,禁止大多數使用者使用這些權限,同時允許信任的主體使用。
事前準備
啟用 IAM API (如果尚未啟用)。
啟用 API 所需的角色
如要啟用 API,您必須具備
serviceusage.services.enable權限。如果您建立了專案,可能已透過擁有者角色 (roles/owner) 取得這項權限。否則,您可以透過 Service Usage 管理員角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。設定驗證方法。
請根據您打算如何使用本頁範例,選取對應的分頁標籤:
控制台
使用 Cloud de Confiance 控制台存取 Cloud de Confiance by S3NS 服務和 API 時,不需要設定驗證機制。
gcloud
安裝 Google Cloud CLI,然後使用聯合身分登入 gcloud CLI。 登入後, 執行下列指令來初始化 Google Cloud CLI:
gcloud initREST
如要在本機開發環境中使用本頁的 REST API 範例,請使用您提供給 gcloud CLI 的憑證。
安裝 Google Cloud CLI,然後使用聯合身分登入 gcloud CLI。
詳情請參閱 Cloud de Confiance 驗證說明文件中的「使用 REST 進行驗證」一節。
選用:參閱拒絕政策總覽。
必要的角色
如要取得建立拒絕政策所需的權限,請要求管理員授予您組織的拒絕管理員 (roles/iam.denyAdmin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
這個預先定義的角色具備 iam.denypolicies.create 權限,可建立拒絕政策。
找出可讓使用者授予存取權的權限
建立拒絕政策來防止使用者授予存取權之前,請先決定要拒絕哪些權限。
使用者可透過下列權限授予存取權:
權限將於
setIamPolicy到期。在這些權限中,Resource Manager 資源的權限最為寬鬆,因為這些資源的允許政策會由所有子系資源繼承。這些權限如下:cloudresourcemanager.googleapis.com/projects.setIamPolicycloudresourcemanager.googleapis.com/folders.setIamPolicycloudresourcemanager.googleapis.com/organizations.setIamPolicy
其他資源也具有
setIamPolicy權限,例如 Compute Engine 執行個體具有compute.googleapis.com/instances.setIamPolicy權限。如要防止使用者修改這些資源的允許政策,請將這些權限新增至拒絕政策。如需以
setIamPolicy結尾的可拒絕權限完整清單,請前往「拒絕政策支援的權限」並搜尋setIamPolicy。iam.googleapis.com/roles.update權限:可讓使用者修改自訂角色。具備這項權限的使用者可以將權限新增至自訂角色,有效授予自己或他人這些權限。
拒絕存取權變更權限
決定要拒絕哪些權限後,請為組織建立拒絕政策,拒絕這些權限。
控制台
前往 Cloud de Confiance 控制台「IAM」頁面的「拒絕」分頁。
選取您的機構。
按一下「 建立拒絕政策」。
在「Policy name」(政策名稱) 部分,執行下列任一操作來定義政策 ID:
- 在「Display name」(顯示名稱) 欄位中,輸入政策的顯示名稱。填寫這個欄位後,系統會自動填寫「ID」欄位。如要變更政策 ID,請更新「ID」欄位中的文字。
- 在「ID」欄位中,輸入政策 ID。
在「Deny rules」(拒絕規則) 部分,新增拒絕規則,封鎖存取權變更權限:
在「Denied principals」(遭拒主體) 欄位中,新增要拒絕存取權的主體。如要拒絕所有使用者的存取權變更權限,請使用
principalSet://goog/public:all值。如需可使用的值完整清單,請參閱「拒絕政策的主體 ID」。在「Exception principals」(例外主體) 欄位中,新增要允許授予存取權的信任主體。如需可使用的完整值清單,請參閱「拒絕政策的主體 ID」。
在「Denied permissions」部分,新增您在「找出可讓使用者授予存取權的權限」中找到的權限。
選用:新增拒絕條件,指定這項規則會影響哪些資源。舉例來說,您可以新增條件,確保政策只適用於標記值為
prod的資源。如要進一步瞭解拒絕條件,請參閱「拒絕政策中的條件」。
點選「建立」。
gcloud
gcloud iam policies create 指令會為資源建立拒絕政策。
使用下列任何指令資料前,請先替換以下項目:
POLICY_ID:拒絕政策的 ID。-
ORG_ID:要建立拒絕政策的組織數字 ID。 -
POLICY_FILE:包含要設定的拒絕政策的檔案。請使用下列格式設定拒絕政策:{ "displayName": "POLICY_NAME", "rules": [ { "denyRule": { "deniedPrincipals": [ DENIED_PRINCIPALS ], "exceptionPrincipals": [ EXCEPTION_PRINCIPALS ], "deniedPermissions": [ ACCESS_CHANGE_PERMISSIONS ], DENIAL_CONDITION } } ] }
替換下列值:
POLICY_NAME:拒絕政策的顯示名稱。-
DENIED_PRINCIPALS:要拒絕存取權的主體。如要拒絕所有使用者的存取權變更權限,請使用"principalSet://goog/public:all"值。如需可使用的值完整清單,請參閱「拒絕政策的主體 ID」。 -
EXCEPTION_PRINCIPALS:您要允許授予存取權的信任主體。如需可使用的值完整清單,請參閱「拒絕政策的主體 ID」。 -
ACCESS_CHANGE_PERMISSIONS:您在「找出可讓使用者授予存取權的權限」中找出的權限。 -
DENIAL_CONDITION:選用。指定這項規則會影響哪些資源的拒絕條件。舉例來說,您可以新增條件,確保規則只適用於標記值為prod的資源。如要進一步瞭解拒絕條件,請參閱「拒絕政策中的條件」。
執行下列指令:
Linux、macOS 或 Cloud Shell
gcloud iam policies create POLICY_ID \ --attachment-point=cloudresourcemanager.googleapis.com/organizations/ORG_ID \ --kind=denypolicies \ --policy-file=POLICY_FILE
Windows (PowerShell)
gcloud iam policies create POLICY_ID ` --attachment-point=cloudresourcemanager.googleapis.com/organizations/ORG_ID ` --kind=denypolicies ` --policy-file=POLICY_FILE
Windows (cmd.exe)
gcloud iam policies create POLICY_ID ^ --attachment-point=cloudresourcemanager.googleapis.com/organizations/ORG_ID ^ --kind=denypolicies ^ --policy-file=POLICY_FILE
如果成功,這個指令不會傳回任何輸出內容。如要輸出詳細回應,請使用 --format=json 旗標。
REST
policies.createPolicy 方法會為資源建立拒絕政策。
使用任何要求資料之前,請先修改下列項目的值:
-
ORG_ID:要建立拒絕政策的組織數字 ID。 POLICY_ID:拒絕政策的 ID。POLICY_NAME:拒絕政策的顯示名稱。-
DENIED_PRINCIPALS:要拒絕存取權的主體。如要拒絕所有使用者的存取權變更權限,請使用"principalSet://goog/public:all"值。如需可使用的完整值清單,請參閱「拒絕政策的主體 ID」。 -
EXCEPTION_PRINCIPALS:您要允許授予存取權的信任主體。如需可使用的值完整清單,請參閱「拒絕政策的主體 ID」。 -
ACCESS_CHANGE_PERMISSIONS:您在「找出可讓使用者授予存取權的權限」中找到的權限。 -
DENIAL_CONDITION:選用。指定受這項規則影響的資源。舉例來說,您可以新增條件,確保規則只適用於標記值為prod的資源。如要進一步瞭解拒絕條件,請參閱「拒絕政策中的條件」。
HTTP 方法和網址:
POST https://iam.googleapis.com/v2/policies/cloudresourcemanager.googleapis.com%2Forganizations%2FORG_ID/denypolicies?policyId=POLICY_ID
JSON 要求主體:
{
"displayName": "POLICY_NAME",
"rules": [
{
"denyRule": {
"deniedPrincipals": [
DENIED_PRINCIPALS
],
"exceptionPrincipals": [
EXCEPTION_PRINCIPALS
],
"deniedPermissions": [
ACCESS_CHANGE_PERMISSIONS
],
DENIAL_CONDITION
}
}
]
}
請展開以下其中一個選項,以傳送要求:
您應該會收到如下的 JSON 回覆:
{
"name": "policies/cloudresourcemanager.googleapis.com%2Forganizations%2F1234567890123/denypolicies/deny-access-granting/operations/89cb3e508bf1ff01",
"metadata": {
"@type": "type.googleapis.com/google.iam.v2.PolicyOperationMetadata",
"createTime": "2026-10-31T19:06:12.455151Z"
},
"response": {
"@type": "type.googleapis.com/google.iam.v2.Policy",
"name": "policies/cloudresourcemanager.googleapis.com%2Forganizations%2F1234567890123/denypolicies/deny-access-granting",
"uid": "6665c437-a3b2-a018-6934-54dd16d3426e",
"kind": "DenyPolicy",
"displayName": "Deny access change permissions.",
"etag": "MTc3NDU4KjM4OZ0MzU5MjQ5OTI=",
"createTime": "2026-10-31T19:06:12.455151Z",
"updateTime": "2026-10-31T22:26:21.968687Z",
"rules": [
{
"denyRule": {
"deniedPrincipals": [
"principalSet://goog/public:all"
],
"exceptionPrincipals": [
"principalSet://cloudresourcemanager.googleapis.com/organizations/1234567890123/type/ServiceAgent",
"principalSet://iam.googleapis.com/locations/global/workforcePools/example-pool/group/iam-admins"
],
"deniedPermissions": [
"cloudresourcemanager.googleapis.com/projects.setIamPolicy",
"cloudresourcemanager.googleapis.com/folders.setIamPolicy",
"cloudresourcemanager.googleapis.com/organizations.setIamPolicy"
],
"denialCondition": {
"title": "Only for prod resources",
"expression": "resource.matchTag('12345678/env', 'prod')"
}
}
}
]
}
}
回應會指出長時間執行的作業。您可以監控長時間執行的作業狀態,瞭解作業何時完成。詳情請參閱「檢查長時間執行的作業狀態」。
後續步驟
- 瞭解如何排解拒絕政策的存取權問題。
- 進一步瞭解如何拒絕主體存取權。