統一存取政策

統一存取政策 (UAP) 可用於授予及拒絕Google Cloud 資源的存取權。與允許和拒絕政策不同,UAP 可讓您在同一政策中授予和拒絕存取權,簡化政策管理。UAP 也可以重複使用,也就是說,您可以將相同的 UAP 套用至多個資源。

統一存取政策的運作方式

如要在 IAM 中授予或拒絕存取權,您必須指定誰可以或不可以對哪項資源執行什麼操作。

在 UAP 中,您可以建立 UAP 規則,指定誰可以或不可以執行哪些操作。每項規則都會列出一組主體、一組角色和權限,以及一項效果。效果 (允許或拒絕) 會指定是否要將規則中的角色和權限授予列出的主體,或禁止主體使用規則中的權限。單一 UAP 最多可有 100 項規則。

如要指定 UAP 控管存取權的資源,請使用 UAP 繫結,將 UAP 繫結至資源。單一 UAP 最多可繫結 5 項資源。單一資源最多可繫結 5 項政策。

用途

在 IAM 中,您可以使用多種政策類型來允許和拒絕存取:

  • 如要允許存取,您可以使用允許政策或 UAP 允許規則。
  • 如要拒絕存取,可以使用拒絕政策或 UAP 拒絕規則。

如果您已使用允許或拒絕政策控管存取權,建議繼續使用這些政策。政策疑難排解工具也支援這些政策類型,可讓您更輕鬆地瞭解存取錯誤的根本原因。

您可在下列情況下使用 UAP:

  • 您正在設定新組織,並打算使用 UAP 控管整個組織的存取權。
  • 您想使用 UAP 條件設定精細的存取控管。

統一存取政策規則

UAP 由允許和拒絕規則組成。這些規則包含下列元件:

  • 作用:規則是授予還是拒絕存取權。授予存取權的規則稱為「允許規則」。拒絕存取權的規則稱為「拒絕規則」。

  • 一組主體:要納入規則的主體,例如使用者、群組或服務帳戶。在允許規則中,這些主體會獲得存取權。在拒絕規則中,這些主體會遭到拒絕存取。

  • 角色和權限清單:要納入規則的角色和權限。在允許規則中,系統會授予這些權限。在拒絕規則中,這些權限會遭到拒絕。

  • 選用:條件運算式:IAM 條件運算式,指定必須符合哪些條件,規則才會套用。詳情請參閱本頁的「UAP 中的條件」一節。

統一存取政策規則中的主體

如要指定要納入規則的主體,請定義下列項目:

  • 納入的主體:要納入規則的主體。
  • 排除的主體:要從規則中排除的主體,即使這些主體位於納入的主體清單群組中也一樣。

透過這兩份清單,您可以簡明扼要地指定要納入規則的主體。舉例來說,假設您要建立允許規則,授予 example.com 使用者存取權。如要將存取權授予 all@example.com 群組中除了 reduced-access@example.com 以外的所有使用者,請將 all@example.com 新增至納入的主體清單,並將 reduced-access@example.com 新增至排除的主體清單。

統一存取政策規則中的角色和權限

如要建立規則中要包含的權限清單,請定義下列項目:

  • 納入的權限:要納入規則的權限。
  • 排除的權限:您不想納入規則的權限,即使這些權限位於納入權限清單中的角色或權限群組,也一樣。

如要將權限新增至納入或排除的權限清單,可以參考下列任一項目:

  • 權限:完整網域名稱 (FQDN) 格式的個別權限名稱。例如:cloudresourcemanager.googleapis.com/projects.get。

  • 角色 (僅限允許規則):預先定義的角色名稱,例如 roles/logging.logsViewer。如果您在規則中加入角色名稱,則規則會包含該角色中的所有權限。如要查看角色中的所有權限,請參閱角色和權限參考資料。

    在 UAP JSON 中,這些名稱一律會加上 role: 前置字元,例如 role:roles/logging.logsViewer。

    角色只能用於允許規則。任何規則都不支援自訂角色。

  • 權限群組:一組權限,例如 aiplatform.googleapis.com/*.*。權限群組是一組符合指定模式的權限。可參照的權限群組和群組內含的權限有一些限制。詳情請參閱本頁的「權限群組」一節。

權限群組

權限群組是一組符合指定模式的權限。您可以使用權限群組,授予或拒絕一組相關權限,例如拒絕單一服務的所有權限,或授予所有以特定動詞結尾的權限。

權限群組在允許和拒絕規則中的運作方式不同。以下各節說明如何在各個規則類型中使用權限群組。

允許規則中的權限群組

如要在允許規則中識別權限群組,請將權限名稱的一或多個部分替換為萬用字元 (*)。每個群組包含的權限取決於萬用字元的位置:

  • SERVICE_FQDN/RESOURCE.*:包含指定資源的所有權限。
  • SERVICE_FQDN/*.*::包含 指定服務的所有權限。
  • SERVICE_FQDN/*.VERB:包含服務中所有以指定動詞結尾的權限。
  • */*.VERB:包含所有以指定動詞結尾的權限。
  • *:包含所有權限。只有在列出納入的權限 (而非排除的權限) 時,才能使用這個值。

權限群組只包含自訂角色支援的權限。即使其他權限符合指定格式,也不會納入。

如要瞭解自訂角色支援哪些權限,請參閱「自訂角色的權限支援級別」。

該頁面列出的權限與 UAP 中的權限格式不同:

  • 自訂角色會使用 v1 格式做為權限名稱,也就是 SERVICE_ID.RESOURCE.VERB。
  • UAP 使用完整網域名稱格式做為權限名稱,即 SERVICE_FQDN/RESOURCE.VERB。

不過,SERVICE_ID 和 SERVICE_FQDN 的值通常相似。在多數情況下,SERVICE_FQDN 的值是 v1 API 的 SERVICE_ID 值,後面加上 .googleapis.com。舉例來說,刪除角色的權限可以寫成下列形式:

  • v1 格式:iam.roles.delete
  • 完整網域名稱格式:iam.googleapis.com/roles.delete

在檢查允許規則的權限群組時,您可以利用這項相似性,在兩種格式之間進行轉換。

這項規則有例外狀況。如要查看這些例外狀況,請參閱拒絕政策支援的權限清單,並在篩選器欄位中搜尋 IAM v1 API。

拒絕規則中的權限群組

拒絕規則僅支援特定權限群組。如要查看支援的權限群組,請參閱「拒絕政策支援的權限」。支援的權限群組 ID 會以萬用字元 (*) 取代權限名稱的一或多個部分。每個群組包含的權限取決於萬用字元的位置:

  • SERVICE_FQDN/RESOURCE.*:拒絕指定資源的所有權限。
  • SERVICE_FQDN/*.*:拒絕指定服務的所有權限。
  • SERVICE_FQDN/*.VERB:拒絕服務中以指定動詞結尾的所有權限。

權限群組包含符合指定模式的所有目前和未來權限。舉例來說,假設您使用權限群組 example.googleapis.com/exampleResource.* 拒絕使用者對 exampleResource 資源類型的所有權限。如果 example.googleapis.com 為 exampleResource 資源類型新增權限 (例如 example.googleapis.com/exampleResource.newPermission),系統會自動拒絕使用者取得新權限。

萬用字元只能用於支援的權限群組。在拒絕規則中,其他權限名稱不得使用萬用字元。

建立統一存取政策

您可以在專案、資料夾或組織中建立 UAP。建立 UAP 的資源會成為 UAP 的父項。不過,在您套用 UAP 之前,UAP 不會產生任何作用。

UAP 的名稱會顯示 UAP 的父項。政策名稱的格式為 RESOURCE_TYPE/RESOURCE_ID/locations/global/accessPolicies/POLICY_ID,其中預留位置代表下列項目:

  • RESOURCE_TYPE:建立 UAP 的資源類型。這個值可以是 projects、folders 或 organizations。
  • RESOURCE_ID:建立 UAP 的資源 ID。
  • POLICY_ID:UAP 的英數字元 ID。

舉例來說,如果您在專案 example-project 中建立 UAP example-policy,則該 UAP 的父項資源為 example-project,UAP 的名稱為 projects/example-project/locations/global/accessPolicies/example-policy。

建立統一存取政策的位置

UAP 的父項不會影響可套用 UAP 的資源。但會影響誰有權查看及編輯 UAP。為確保適當的使用者有權查看及編輯適當的 UAP,建議您選擇最能反映 UAP 範圍的父項資源。

舉例來說,如果您想將 UAP 套用至組織,建議在組織中建立 UAP。

將政策套用至資源

如要套用 UAP,請建立繫結。每個繫結都會指定 UAP,以及要繫結至 UAP 的資源。建立繫結後,UAP 中的規則就會對該資源及其子系生效。

舉例來說,假設您有一個 UAP compute-access-management。這項 UAP 會將 Compute 編輯者角色 (roles/compute.editor) 授予群組 compute-users@example.com,並拒絕向 compute-users@example.com 以外的所有使用者授予 compute.googleapis.com/instances.* 權限。

如果沒有任何繫結,這項 UAP 就不會生效。

您希望這項 UAP 適用於組織 example.com 中的所有資源,因此建立繫結,將 compute-access-management UAP 附加至 example.com。建立繫結後,UAP 會產生下列效果:

  • compute-users@example.com 的成員可以使用 Compute 編輯者角色中的權限,存取 example.com 中的資源。
  • 所有非 compute-users@example.com 成員的使用者都無法使用執行個體相關權限,存取 example.com 中的資源。

支援的資源

下表列出可繫結 UAP 的資源。每個資料列都包含下列資訊:

  • 資源類型
  • 該資源的 ID 格式
  • 該類型資源的繫結父項 Resource Manager 資源 (專案、資料夾或組織)
資源 資源 ID 繫結的父項資源
Resource Manager 專案 //cloudresourcemanager.googleapis.com/projects/PROJECT_ID 繫結中的專案
Resource Manager 資料夾 //cloudresourcemanager.googleapis.com/folders/FOLDER_ID 繫結中的資料夾
Resource Manager 組織 //cloudresourcemanager.googleapis.com/organizations/ORG_ID 繫結中的機構
Agent Registry AI 應用程式 //agentregistry.googleapis.com/projects/PROJECT_ID/locations/LOCATION/aiApplications/APPLICATION_ID 應用程式的上層專案
Network Services API Agent Gateway //networkservices.googleapis.com/projects/PROJECT_ID/locations/LOCATION/agentGateways/GATEWAY_ID 閘道的上層專案

停用繫結建立功能

如要禁止在組織中建立繫結,可以強制執行 iam.managed.disableAccessPolicyBinding 組織政策限制。這項限制可防止組織中的主體建立 UAP 繫結。

如要瞭解如何啟用或停用這項限制,請參閱「在組織政策中使用代管限制」。

政策繼承

如果將 UAP 繫結至專案、資料夾或組織,該 UAP 會透過資源階層繼承。

資源階層最上層是組織 (根),接著是分組用的資料夾 (選用),然後是專案,其中包含 Compute Engine 虛擬機器和 Cloud Storage bucket 等服務專屬資源。

在這個階層中,專案、資料夾和組織是「上層資源」。換句話說,這些資源包含其他資源:

  • 專案包含服務專屬資源。
  • 資料夾包含其他資料夾、專案和專案資源。
  • 機構包含資料夾、專案和專案資源。

父項資源包含的資源稱為「子系」。

將 UAP 繫結至父項資源後,該 UAP 會套用至父項資源「和」該資源的所有子系。也就是說,資源的子項會沿用 UAP。

政策繼承功能可讓您透過單一繫結,將政策套用至大量資源。舉例來說,假設您建立 UAP,授予 taylor@example.com Compute Engine 管理員角色 (roles/compute.admin)。UAP 也會拒絕 noam@example.com 的 compute.googleapis.com/instances.delete 權限。

您希望這項 UAP 適用於組織 example.com 中的所有資源。為此,您需要將這個 UAP 繫結至組織資源。將 UAP 繫結至組織後,該組織中的所有資源都會繼承 UAP。

將 UAP 繫結至組織會產生下列影響:

  • taylor@example.com 可使用 Compute Engine 管理員角色的權限,存取 example.com 中的任何資源。
  • noam@example.com 無法對 example.com 中的任何資源使用 compute.googleapis.com/instances.delete 權限,即使後續資源的 UAP 授予存取權也一樣。

如要將 UAP 套用至較少資源,可以將 UAP 繫結至資源階層中較低的層級,例如專案或支援的服務專屬資源。

跨組織繫結

您無法為 UAP 建立跨組織繫結。跨組織繫結是指將某個組織中的 UAP 繫結至另一個組織中的資源。

IAM 會定期刪除現有的跨組織繫結。當您將專案從一個組織移至另一個組織時,可能會發生跨組織繫結。舉例來說,假設有以下情況:

  • 您在機構 example.com 中有一個專案 example-project。
  • 您在專案 example-project 中建立 UAP,並將其繫結至 example-project。
  • 將 example-project 從 example.com 移至 cymbalgroup.com。

在這種情況下,移動專案會建立跨組織繫結。這是因為 example.com 中的 UAP 繫結至 cymbalgroup.com 中的資源。如果您未手動刪除繫結,IAM 最終會自動刪除。刪除這個繫結,可確保 cymbalgroup.com 管理員能存取繫結至組織資源的所有 UAP。

已刪除統一存取政策的繫結

一般來說,您必須先刪除 UAP 的繫結,才能刪除 UAP。如果嘗試刪除具有現有繫結的 UAP,會發生錯誤。

不過,如果您想刪除 UAP,但不想刪除現有繫結,可以強制刪除 UAP。

強制刪除 UAP 會將其從所有繫結的資源中移除。參照 UAP 的繫結最終都會刪除。不過,在刪除之前,這些繫結仍會計入可參照單一資源的繫結數量上限。

統一存取政策中的條件

IAM 條件可讓您定義並強制執行 Google Cloud 資源的條件式、以屬性為基礎的存取控管機制。在 UAP 中,您可以為個別規則新增條件,控制規則的套用時機。您無法在 UAP 繫結中新增條件。

條件由標題、說明和布林運算式組成。如果運算式對要求的評估結果為 true,則規則會套用至要求。如果評估結果為 false,則規則不適用於要求。

不同服務提供不同的屬性和函式,可用於編寫條件運算式。在規則中新增條件時,請務必在條件前面加上您使用的屬性和函式所屬的服務名稱。您可以為規則新增多個條件,但單一條件不能混合不同服務的屬性。

舉例來說,如果您要新增使用 IAM 提供的屬性的條件,請在條件前面加上 iam.googleapis.com:

"conditions": {
  "iam.googleapis.com": {
    "title": "CONDITION_TITLE",
    "description": "CONDITION_DESCRIPTION",
    "expression": "CONDITION_EXPRESSION"
  }
}

如要瞭解如何建立含有條件的 UAP 規則,請參閱「建立及套用 UAP」。

條件屬性的適用權限

部分服務專屬屬性僅適用於涉及特定權限的要求。舉例來說,eventarc.googleapis.com 屬性 message.id 僅適用於需要 eventarc.googleapis.com/messageBuses.publish 權限的要求。

您只能在包含適用權限的規則中使用這些屬性。如果您在規則中使用屬性,但沒有適用權限,則 UAP 建立作業會失敗。

支援的條件屬性

UAP 規則支援下列屬性:

服務 屬性 適用權限 更多資訊
iam.googleapis.com (預先發布版) 資源標記 不限 資源標記屬性
eventarc.googleapis.com (預先發布版) 訊息 eventarc.googleapis.com/messageBuses.publish Eventarc 訊息屬性
iap.googleapis.com (GA) 目的地 iap.googleapis.com/resources.egressViaIAP Identity-Aware Proxy 目的地屬性

後續步驟