主體存取邊界 (PAB) 政策可限制一組主體可存取的資源。如果不想再對主體集強制執行主體存取邊界政策,可以刪除將政策繫結至主體集的政策繫結。如要從繫結的所有主體集移除主體存取邊界政策,可以刪除政策。
從主體集移除主體存取邊界政策,會產生下列其中一項影響:
- 如果主體集中的主體不受任何其他主體存取邊界政策限制,則可存取所有Google Cloud 資源。
- 如果主體集中的主體受其他主體存取邊界政策規範,則只能存取這些政策中的資源。
事前準備
設定驗證方法。
請根據您打算如何使用本頁範例,選取對應的分頁標籤:
gcloud
在 Google Cloud 控制台啟用 Cloud Shell。
Google Cloud 控制台底部會開啟 Cloud Shell 工作階段,並顯示指令列提示。Cloud Shell 是已安裝 Google Cloud CLI 的殼層環境,並已設定適用於您目前專案的值。工作階段可能要幾秒鐘的時間才能初始化。
REST
如要在本機開發環境中使用本頁的 REST API 範例,請使用您提供給 gcloud CLI 的憑證。
安裝 Google Cloud CLI。
若您採用的是外部識別資訊提供者 (IdP),請先使用聯合身分登入 gcloud CLI。
詳情請參閱 Google Cloud 驗證說明文件中的「使用 REST 進行驗證」一節。
閱讀主體存取邊界政策總覽。
刪除主體存取邊界政策所需的角色
如要取得刪除主體存取邊界政策所需的權限,請要求管理員授予您組織的主體存取邊界管理員 (roles/iam.principalAccessBoundaryAdmin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
這個預先定義的角色具備 iam.principalaccessboundarypolicies.delete 權限,可刪除主體存取邊界政策。
刪除主體存取邊界政策繫結所需的角色
如要刪除主體存取邊界政策的政策繫結,所需權限取決於繫結至政策的主體集。
如要取得刪除主體存取權範圍政策繫結所需的權限,請要求管理員授予您下列 IAM 角色:
- 貴組織的主體存取邊界使用者 (
roles/iam.principalAccessBoundaryUser) -
刪除繫結至員工身分集區的主體存取邊界政策繫結:目標員工身分集區的身分與存取權管理員工集區管理員 (
roles/iam.workforcePoolAdmin) -
刪除繫結至 workload identity pool 的主體存取邊界政策繫結:目標 workload identity pool 所屬專案的 IAM Workload Identity Pool 管理員 (
roles/iam.workloadIdentityPoolAdmin) -
取得刪除參照 workload identity pool 的繫結,這項長時間執行作業的狀態:目標 workload identity pool 所屬專案的 IAM 作業檢視者 (
roles/iam.operationViewer) -
刪除繫結至 Google Workspace 網域的主體存取邊界政策繫結:
組織的工作區集區 IAM 管理員 (
roles/iam.workspacePoolAdmin) -
刪除繫結至專案主體集的主體存取邊界政策繫結:專案的專案 IAM 管理員 (
roles/resourcemanager.projectIamAdmin) -
取得長時間執行的作業狀態,以便刪除參照專案主體集的繫結:專案的 IAM 作業檢視者 (
roles/iam.operationViewer) -
刪除繫結至資料夾主體集的主體存取邊界政策繫結:資料夾的資料夾 IAM 管理員 (
roles/resourcemanager.folderIamAdmin) -
刪除繫結至組織主體集的主體存取邊界政策繫結:組織的組織管理員 (
roles/resourcemanager.organizationAdmin)
如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
這些預先定義的角色具備刪除主體存取邊界政策繫結所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:
所需權限
必須具備下列權限,才能刪除主體存取權範圍政策的政策繫結:
-
iam.principalaccessboundarypolicies.unbind組織 -
刪除繫結至員工身分集區的主體存取邊界政策繫結:
iam.workforcePools.deletePolicyBinding(在目標員工身分集區) -
刪除繫結至 workload identity pool 的主體存取邊界政策繫結:
iam.workloadIdentityPools.deletePolicyBinding(在目標 workload identity pool 所屬的專案中) -
取得長時間執行的作業狀態,以便刪除參照 workload identity pool 的繫結:
iam.operations.get在擁有目標 workload identity pool 的專案上 -
刪除繫結至 Google Workspace 網域的主體存取邊界政策繫結:
iam.workspacePools.deletePolicyBinding(位於組織) -
刪除繫結至專案主體集的主體存取邊界政策繫結:
resourcemanager.projects.deletePolicyBinding(位於專案) -
取得長時間執行的作業狀態,刪除參照專案主體集的繫結:
iam.operations.get專案 -
刪除繫結至資料夾主體集的主體存取邊界政策繫結:
resourcemanager.folders.deletePolicyBinding(位於資料夾) -
刪除繫結至組織主體集的主體存取邊界政策繫結:
resourcemanager.organizations.deletePolicyBinding(位於組織)
準備移除主體存取邊界政策
移除主體存取邊界政策前,請先決定要達成下列哪項目標:
- 讓主體集中的主體可以存取所有資源
- 減少主體集中的主體可存取的資源數量
以下各節將說明達成這些目標的步驟。
讓主體可存取所有資源
如要讓主體集中的主體有權存取所有資源,請按照下列步驟操作:
- 找出繫結至主體集的所有主體存取邊界政策。
- 刪除相關政策繫結,移除繫結至主體集的所有主體存取邊界政策。
如果主體不受任何主體存取邊界政策規範,則可存取所有 Google Cloud 資源。
符合資源存取資格,不代表使用者一定能存取資源。詳情請參閱「政策評估」。
減少主體可存取的資源
如果主體集中的主體受多項主體存取邊界政策規範,您可以移除一或多項適用的主體存取邊界政策,減少主體可存取的資源數量。不過,請勿在任何時候移除主體適用的所有主體存取邊界政策,否則主體將可存取所有 Google Cloud 資源。
如要移除主體存取邊界政策,同時確保主體集中的主體一律受至少一項主體存取邊界政策規範,請按照下列步驟操作:
- 找出繫結至主體集的所有主體存取邊界政策。
找出主體存取邊界政策,其中「僅」包含您要讓主體集中的主體存取的資源。這些政策不會從主體集中移除。
如果沒有這類政策,請建立新的主體存取邊界政策,並只加入您要讓主體存取的資源。然後將政策附加至主體組合。
找出主體存取邊界政策,其中包含您不希望主體集中的主體存取的資源。接著,刪除相關政策繫結,移除這些主體存取邊界政策。
如要減少特定主體的存取權,請在政策繫結中新增條件,而非刪除繫結。
如要減少主體可存取的資源數量,但不想移除任何主體存取邊界政策,可以改為修改主體適用的主體存取邊界政策。如要瞭解如何修改主體存取邊界政策,請參閱「編輯主體存取邊界政策」。
測試刪除主體存取邊界政策或繫結
在刪除主體存取權範圍政策或繫結前,建議您先測試這項變更對主體存取權的影響。您可以使用 Policy Simulator 模擬刪除作業,瞭解可能造成的影響。
如要測試刪除作業,請參閱 Policy Intelligence 說明文件中的下列程序:
如要進一步瞭解如何使用 Policy Simulator 測試主體存取邊界政策,請參閱「主體存取邊界政策的 Policy Simulator」。
從主體集移除主體存取邊界政策
從主體集移除主體存取邊界政策前,請先準備移除政策。接著,刪除將政策繫結至主體集的政策繫結,即可移除政策。
您可以使用 Google Cloud 控制台、gcloud CLI 或 IAM REST API 刪除政策繫結。
控制台
前往 Google Cloud 控制台的「Principal Access Boundary policies」(主體存取權邊界政策) 頁面。
選取要刪除繫結的主體存取邊界政策所屬組織。
按一下要刪除繫結的主體存取邊界政策 ID。
按一下「繫結」分頁標籤。
找出要刪除的繫結 ID。在該繫結的資料列中,依序點選「 動作」和「刪除繫結」。
在確認對話方塊中點按「刪除」。
gcloud
gcloud iam policy-bindings delete 指令會刪除政策繫結。
使用下列任何指令資料前,請先替換以下項目:
-
BINDING_ID:要刪除的政策繫結 ID,例如example-binding。 -
RESOURCE_TYPE:政策繫結所屬 Resource Manager 資源 (專案、資料夾或組織) 的類型。請使用project、folder或organization值。資源類型取決於政策繫結中設定的主體。如要瞭解應使用哪種資源類型,請參閱「支援的主體類型」。
-
RESOURCE_ID:政策繫結所屬的專案、資料夾或組織 ID。專案 ID 是英數字串,例如my-project。資料夾和組織 ID 則為數字,例如123456789012。
執行下列指令:
Linux、macOS 或 Cloud Shell
gcloud iam policy-bindings delete BINDING_ID \ --RESOURCE_TYPE=RESOURCE_ID --location=global
Windows (PowerShell)
gcloud iam policy-bindings delete BINDING_ID ` --RESOURCE_TYPE=RESOURCE_ID --location=global
Windows (cmd.exe)
gcloud iam policy-bindings delete BINDING_ID ^ --RESOURCE_TYPE=RESOURCE_ID --location=global
回應會包含代表要求的長時間執行的作業。如要瞭解如何取得長時間執行的作業狀態,請參閱本頁的「查看長時間執行的作業狀態」一節。
Delete request issued for: [example-binding] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374724030-6181fcd1520c5-d21b0a12-b704e1ce] to complete...done. Deleted policyBinding [example-binding].
REST
policyBindings.delete 方法會刪除政策繫結。
使用任何要求資料之前,請先修改下列項目的值:
-
RESOURCE_TYPE:政策繫結所屬 Resource Manager 資源 (專案、資料夾或組織) 的類型。請使用projects、folders或organizations值。資源類型取決於政策繫結中設定的主體。如要瞭解應使用哪種資源類型,請參閱「支援的主體類型」。
-
RESOURCE_ID:政策繫結所屬的專案、資料夾或組織 ID。專案 ID 是英數字串,例如my-project。資料夾和組織 ID 則為數字,例如123456789012。 -
BINDING_ID:要刪除的政策繫結 ID,例如example-binding。
HTTP 方法和網址:
DELETE https://iam.googleapis.com/v3/RESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings/BINDING_ID
請展開以下其中一個選項,以傳送要求:
回應會包含代表要求的長時間執行的作業。如要瞭解如何取得長時間執行的作業狀態,請參閱本頁的「查看長時間執行的作業狀態」一節。
{
"name": "organizations/123456789012/locations/global/operations/operation-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2024-05-10T20:33:11.165728913Z",
"target": "organizations/123456789012/locations/global/policyBindings/example-binding",
"verb": "delete",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
刪除主體存取邊界政策
刪除主體存取邊界政策前,建議您找出並刪除所有參照該政策的主體存取邊界政策繫結。
如果刪除的主體存取邊界政策含有現有政策繫結,這些繫結最終會遭到刪除。不過,在刪除之前,政策繫結仍會計入單一主體集可參照的 10 個繫結限制。
您可以使用 Google Cloud 控制台、gcloud CLI 或 IAM REST API,刪除主體存取權邊界政策。
控制台
前往 Google Cloud 控制台的「Principal Access Boundary policies」(主體存取權邊界政策) 頁面。
選取要刪除的主體存取權邊界政策所屬組織。
找出要刪除的政策 ID。在該政策的資料列中,依序點選「 動作」和「刪除政策」。
在確認對話方塊中,確認要刪除政策:
- 如要刪除政策,但僅限政策沒有任何相關聯的繫結,請按一下「Delete」(刪除)。
- 如要刪除政策和所有相關繫結,請勾選「Forcefully delete policy」(強制刪除政策) 核取方塊,然後按一下「Delete」(刪除)。
gcloud
gcloud iam gcloud iam principal-access-boundary-policies delete 指令會刪除主體存取邊界政策和所有相關繫結。
使用下列任何指令資料前,請先替換以下項目:
-
PAB_POLICY_ID:要刪除的主體存取邊界政策 ID,例如example-policy。 ORG_ID:主體存取權邊界政策所屬組織的 ID。組織 ID 為數字,例如123456789012。FORCE_FLAG:選用。如要強制指令刪除政策 (即使現有政策繫結中參照了該政策),請使用--force旗標。如果未設定這個旗標,且現有政策繫結參照了該政策,指令就會失敗。
執行下列指令:
Linux、macOS 或 Cloud Shell
gcloud iam principal-access-boundary-policies delete PAB_POLICY_ID \ --organization=ORG_ID --location=global FORCE_FLAG
Windows (PowerShell)
gcloud iam principal-access-boundary-policies delete PAB_POLICY_ID ` --organization=ORG_ID --location=global FORCE_FLAG
Windows (cmd.exe)
gcloud iam principal-access-boundary-policies delete PAB_POLICY_ID ^ --organization=ORG_ID --location=global FORCE_FLAG
回應會包含代表要求的長時間執行的作業。如要瞭解如何取得長時間執行的作業狀態,請參閱本頁的「查看長時間執行的作業狀態」一節。
Delete request issued for: [example-policy] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374811191-6181fd2471ab4-f0947406-85778c43] to complete... Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374811191-6181fd2471ab4-f0947406-85778c43] to complete...done. Deleted principalAccessBoundaryPolicy [example-policy].
REST
principalAccessBoundaryPolicies.delete 方法會刪除主體存取邊界政策和所有相關聯的繫結。
使用任何要求資料之前,請先修改下列項目的值:
ORG_ID:主體存取權邊界政策所屬組織的 ID。組織 ID 為數字,例如123456789012。-
PAB_POLICY_ID:要刪除的主體存取邊界政策 ID,例如example-policy。 -
FORCE_DELETE:選用。如要強制要求刪除政策,即使現有政策繫結中參照了該政策,也請新增查詢參數force=true。如果未設定這項查詢參數,且現有政策繫結中參照了該政策,則要求會失敗。
HTTP 方法和網址:
DELETE https://iam.googleapis.com/v3/organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID?FORCE_DELETE
請展開以下其中一個選項,以傳送要求:
回應會包含代表要求的長時間執行的作業。如要瞭解如何取得長時間執行的作業狀態,請參閱本頁的「查看長時間執行的作業狀態」一節。
{
"name": "organizations/123456789012/locations/global/operations/operation-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2024-05-10T20:33:11.165728913Z",
"target": "organizations/123456789012/locations/global/policyBindings/example-policy",
"verb": "delete",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
查看長時間執行的作業狀態
使用 REST API 或用戶端程式庫時,任何變更政策或繫結的方法都會傳回長時間執行的作業 (LRO)。長時間執行的作業會追蹤要求狀態,並指出政策或繫結的變更是否已完成。
REST
operations.get 方法會傳回長時間執行的作業的狀態。
使用任何要求資料之前,請先修改下列項目的值:
-
OPERATION_NAME::作業的全名。您會在原始要求的 回應中收到這個名稱。作業名稱的格式如下:
RESOURCE_TYPE/RESOURCE_ID/locations/global/operations/OPERATION_ID
HTTP 方法和網址:
GET https://iam.googleapis.com/v3/OPERATION_NAME
請展開以下其中一個選項,以傳送要求:
您應該會收到如下的 JSON 回覆:
{
"name": "organizations/314340013352/locations/global/operations/operation-1732752311821-627edd607a3df-9a62cdea-2a7d9f07",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2024-11-28T00:05:12.006289686Z",
"endTime": "2024-11-28T00:05:12.192141801Z",
"target": "organizations/314340013352/locations/global/POLICY_TYPE/POLICY_ID",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": true,
"response": {
POLICY
}
}
如果作業沒有 done 欄位,請重複取得作業,繼續監控其狀態。使用部分指數輪詢,在每次要求之間加入延遲時間。當 done 欄位設為 true 時,代表作業已完成,您可以停止取得作業。