管理存取權政策

本頁面說明如何管理現有的存取權政策,您可以採取以下做法:

取得存取權政策的名稱和 ETag

控制台

如要在 Google Cloud 控制台中取得存取權政策的數字名稱,請按照下列步驟操作:

  1. 在 Google Cloud 控制台導覽選單中,依序點按「Security」(安全性) 和「VPC Service Controls」。

    前往 VPC Service Controls

  2. 系統顯示提示時,請選取組織、資料夾或專案。

  3. 在「VPC Service Controls」頁面上,按一下「Manage policies」(管理政策)。

  4. 在「Manage VPC Service Control policies」(管理 VPC Service Controls 政策) 頁面中,按一下要檢查的存取權政策標題。

  5. 在「Edit access policy」(編輯存取權政策) 頁面中,找出「Access policy name」(存取權政策名稱) 下方的政策數字 ID。

gcloud

如要取得存取權政策的名稱,請使用 list 指令。如要使用 gcloud 指令列工具執行所有存取層級指令,就必須提供存取權政策名稱。

gcloud access-context-manager policies list \
    --organization ORGANIZATION_ID

其中:

  • ORGANIZATION_ID 是貴組織的數字 ID。

畫面會顯示類似以下的輸出:

NAME           ORGANIZATION  TITLE        ETAG
1034095178592  511928527926  Corp Policy  10bc3c76ca809ab2

API

如要取得存取權政策名稱,請呼叫 accessPolicies.list。

GET https://accesscontextmanager.googleapis.com/v1/accessPolicies

要求主體

要求主體必須為空白。

回應主體

如果成功,回應主體將輸出類似以下內容:

{
  "accessPolicies": [
    {
      object(AccessPolicy)
    }
  ],
  "nextPageToken": string
}

其中:

設定 gcloud 指令列工具的預設存取權政策

使用 gcloud 指令列工具時,您可以設定預設存取權政策。設定預設政策後,每次使用 Access Context Manager 指令時,就不必再指定政策。

如要設定預設存取權政策,請使用 config 指令。

gcloud config set access_context_manager/policy POLICY_NUMBER

其中:

委派存取權政策

控制台

如要在Google Cloud 控制台委派範圍存取權政策的管理權,請按照下列步驟操作:

  1. 在 Google Cloud 控制台導覽選單中,依序點按「Security」(安全性) 和「VPC Service Controls」。

    前往 VPC Service Controls

  2. 系統顯示提示時,請選取組織、資料夾或專案。

  3. 在「VPC Service Controls」頁面上,按一下「Manage policies」(管理政策)。

  4. 在「Manage VPC Service Control policies」(管理 VPC Service Controls 政策) 頁面中,找出要委派的範圍存取權政策,然後在對應的資料列中按一下 按鈕,再點選「Edit」(編輯)。

  5. 在「Edit access policy」(編輯存取權政策) 頁面的「Manage principals」(管理主體) 下方,點按「Add principals」(新增主體)。

  6. 在「Add principals」(新增主體) 窗格中,選取主體,例如使用者或服務帳戶。

  7. 選取要與主體建立關聯的角色,例如「Access Context Manager admin」(Access Context Manager 管理員)、「Access Context Manager editor」(Access Context Manager 編輯者) 或「Access Context Manager reader」(Access Context Manager 讀取者),然後按一下「Save」(儲存)。

  8. 在「Edit access policy」(編輯存取權政策) 頁面中,點按「Save」(儲存)。

gcloud

如要繫結主體和角色與範圍存取權政策,藉此委派管理權,請使用 add-iam-policy-binding 指令。

gcloud access-context-manager policies add-iam-policy-binding \
[POLICY] --member=PRINCIPAL --role=ROLE

其中:

  • POLICY 是政策的 ID 或完整 ID。

  • PRINCIPAL 是您要新增繫結的主體。請用下列格式指定:user|group|serviceAccount:email 或 domain:domain。

  • ROLE 是要指派給主體的角色名稱。角色名稱是預先定義角色的完整路徑 (例如 roles/accesscontextmanager.policyEditor),或是自訂角色的角色 ID (例如 organizations/{ORGANIZATION_ID}/roles/accesscontextmanager.policyEditor)。

API

如要委派範圍存取權政策的管理權,請按照下列步驟操作:

  1. 建立要求主體。

    {
    "policy": "IAM_POLICY",
    }

    其中:

    • IAM_POLICY 是一組繫結。繫結可將一或多個成員或主體與單一角色連結。主體可以是使用者帳戶、服務帳戶、Google 群組和網域。角色是具名權限清單,每個角色可以是 IAM 預先定義的角色,也可以是使用者建立的自訂角色。
  2. 呼叫 accessPolicies.setIamPolicy 來委派存取權政策。

    POST https://accesscontextmanager.googleapis.com/v1/accessPolicies
    

回應主體

如果成功,回應主體會包含 policy 的執行個體。

描述存取權政策

控制台

如要在 Google Cloud 控制台查看存取權政策的詳細資料,請按照下列步驟操作:

  1. 在 Google Cloud 控制台導覽選單中,依序點按「Security」(安全性) 和「VPC Service Controls」。

    前往 VPC Service Controls

  2. 系統顯示提示時,請選取組織、資料夾或專案。

  3. 在「VPC Service Controls」頁面上,按一下「Manage policies」(管理政策)。

  4. 在「Manage VPC Service Control policies」(管理 VPC Service Controls 政策) 頁面中,按一下要查看的存取權政策標題。

    「Edit access policy」(編輯存取權政策) 頁面會顯示政策標題、數字存取權政策名稱、範圍和委派主體。

gcloud

如要描述存取權政策,請使用 describe 指令。

gcloud access-context-manager policies describe POLICY_NUMBER

其中:

  • POLICY_NUMBER 是政策的數字名稱。

畫面會出現以下輸出結果:

name: accessPolicies/1034095178592
parent: organizations/511928527926
title: Corp Policy

API

如要說明存取權政策,請呼叫 accessPolicies.get

GET https://accesscontextmanager.googleapis.com/v1/accessPolicies/POLICY_NUMBER

其中:

  • POLICY_NUMBER 是政策的數字名稱。

要求主體

要求主體必須為空白。

回應主體

如果成功,回應主體會包含 AccessPolicy 物件。

更新存取權政策

控制台

在 Google Cloud 控制台中,您無法變更現有存取權政策的標題或範圍。如要變更存取權政策的標題,請使用 gcloud 指令列工具或 API。

如要在 Google Cloud 控制台更新範圍存取權政策的委派主體和角色繫結,請參閱「委派存取權政策」。

gcloud

如要更新存取權政策,請使用 update 指令。目前您只能變更政策的標題。

gcloud access-context-manager policies update POLICY_NUMBER \
    --title=POLICY_TITLE

其中:

  • POLICY_NUMBER 是政策的數字名稱。

  • POLICY_TITLE 是指政策的人類可讀標題。

畫面會出現以下輸出結果:

Waiting for PATCH operation [accessPolicies/POLICY_NUMBER/update/1542234231134882]...done.

API

目前,您只能變更存取權政策的標題。

更新政策的方式如下:

  1. 建立要求主體。

    {
     "parent": "ORGANIZATION_ID",
     "title": "POLICY_TITLE"
    }

    其中:

    • ORGANIZATION_ID 是貴組織的數字 ID。

    • POLICY_TITLE 是指政策的人類可讀標題。

  2. 呼叫 accessPolicies.patch。

    PATCH https://accesscontextmanager.googleapis.com/v1/accessPolicies/POLICY_NUMBER/UPDATE_MASK
    

    其中:

    • POLICY_NUMBER 是政策的數字名稱。

    • UPDATE_MASK 是代表要更新值的字串。例如:title。

    回應主體

    如果成功,呼叫的回應主體會包含 Operation 資源,其中提供有關 PATCH 作業的詳細資料。

刪除存取權政策

控制台

如要在 Google Cloud 控制台刪除存取權政策,請按照下列步驟操作:

  1. 在 Google Cloud 控制台導覽選單中,依序點按「Security」(安全性) 和「VPC Service Controls」。

    前往 VPC Service Controls

  2. 系統顯示提示時,請選取組織、資料夾或專案。

  3. 在「VPC Service Controls」頁面上,按一下「Manage policies」(管理政策)。

  4. 在「Manage VPC Service Control policies」(管理 VPC Service Controls 政策) 頁面中,找到要刪除的存取權政策,然後在該列中按一下 按鈕,接著點選「Delete」(刪除)。

  5. 在確認對話方塊中點按「刪除」。

gcloud

刪除存取權政策的方式如下:

  1. 使用 delete 指令。

    gcloud access-context-manager policies delete POLICY_NUMBER

    其中:

    • POLICY_NUMBER 是政策的數字名稱。
  2. 確認您要刪除存取權政策。

    例如:

    You are about to delete policy [POLICY_NUMBER]
    
    Do you want to continue (Y/n)?
    

    畫面會出現以下輸出結果:

    Deleted policy [1034095178592].
    

API

如要刪除存取權政策,請呼叫 accessPolicies.delete。

DELETE https://accesscontextmanager.googleapis.com/v1/accessPolicies/POLICY_NUMBER

其中:

  • POLICY_NUMBER 是政策的數字名稱。

要求主體

要求主體必須為空白。

回應主體

如果成功,呼叫的回應主體會包含 Operation 資源,其中提供有關 DELETE 作業的詳細資料。

後續步驟