下載憑證設定並授予存取權

Workload Identity Federation 可讓您直接或透過服務帳戶模擬,授予外部工作負載Google Cloud 資源的存取權。接著,您可以下載憑證設定檔,為用戶端程式庫設定應用程式預設憑證 (ADC)。

如需端對端、特定用途的操作說明,請參閱 Amazon Web Services (AWS) 和 Azure、Active Directory、GitHub、GitLab 和其他部署管道,以及 Kubernetes 的設定指南。

允許外部工作負載存取 Google Cloud 資源

如要讓工作負載存取 Google Cloud 資源,建議您直接將資源存取權授予主體。在本例中,主體是聯合使用者。部分 Google Cloud 產品有 Google Cloud API 限制。如果工作負載呼叫的 API 端點有限制,您可以改用服務帳戶模擬。在本例中,主體是Google Cloud 服務帳戶,代表身分。您授予服務帳戶資源存取權。

直接存取資源

您可以使用 Google Cloud 控制台或 gcloud CLI,直接授予聯合身分資源存取權。

控制台

如要使用 Google Cloud 控制台直接對資源授予 IAM 角色,請前往資源頁面,然後授予角色。以下範例說明如何前往 Cloud Storage 頁面,並直接在 Cloud Storage bucket 上,將 Storage 物件檢視者角色 (roles/storage.objectViewer) 授予聯合身分。

  1. 前往 Google Cloud 控制台的「Cloud Storage bucket」頁面。

    前往「Buckets」(值區) 頁面

  2. 在 bucket 清單中,點選要授予角色的 bucket 名稱。

  3. 選取靠近頁面上方的 [Permissions] (權限) 分頁標籤。

  4. 按一下 「Grant access」(授予存取權) 按鈕。

    系統會隨即顯示「Add principals」(新增主體) 對話方塊。

  5. 在「New principals」(新增主體) 欄位中,輸入一或多個需要存取 bucket 的身分。

    依科目

    principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/subject/SUBJECT
    

    更改下列內容:

    • PROJECT_NUMBER:專案編號
    • POOL_ID:工作負載集區 ID
    • SUBJECT:從 IdP 對應的個別主體,例如 administrator@example.com

    依群組

    principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/group/GROUP
    

    更改下列內容:

    • PROJECT_NUMBER:專案編號
    • WORKLOAD_POOL_ID:工作負載集區 ID
    • GROUP:從 IdP 對應的群組,例如:administrator-group@example.com

    依屬性

    principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE
    

    更改下列內容:

    • PROJECT_NUMBER:專案編號
    • WORKLOAD_POOL_ID:工作負載集區 ID
    • ATTRIBUTE_NAME:從 IdP 對應的其中一個屬性
    • ATTRIBUTE_VALUE:屬性的值
  6. 從「Select a role」(選取角色) 下拉式選單中選取一或多個角色。 面板中會顯示選取的角色,並針對這些角色授予的權限提供簡短說明。

  7. 按一下「Save」(儲存)。

gcloud

如要使用 gcloud CLI 授予專案中資源的 IAM 角色,請按照下列步驟操作:

  1. 取得定義資源的專案編號。

    gcloud projects describe $(gcloud config get-value core/project) --format=value\(projectNumber\)
    
  2. 授予資源存取權。

    如要使用 gcloud CLI,將 Storage 物件檢視者角色 (roles/storage.objectViewer) 授予符合特定條件的外部身分,請執行下列指令。

    依主題

    gcloud storage buckets add-iam-policy-binding BUCKET_ID \
        --role=roles/storage.objectViewer \
        --member="principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/subject/SUBJECT"

    依群組

    gcloud storage buckets add-iam-policy-binding BUCKET_ID \
        --role=roles/storage.objectViewer \
        --member="principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/group/GROUP"

    依屬性

    gcloud storage buckets add-iam-policy-binding BUCKET_ID \
        --role=roles/storage.objectViewer \
        --member="principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE"

    更改下列內容:

    • BUCKET_ID:要授予存取權的 bucket
    • PROJECT_NUMBER:workload identity pool 所在專案的專案編號。
    • POOL_ID:workload identity pool 的集區 ID
    • SUBJECT:您對應至 google.subject 的屬性預期值
    • GROUP:您對應至 google.groups 的屬性預期值
    • ATTRIBUTE_NAME:屬性對應中的自訂屬性名稱
    • ATTRIBUTE_VALUE:屬性對應中的自訂屬性值

    您可以對任何支援 IAM 允許政策的 Google Cloud 資源授予角色。

服務帳戶模擬

  1. 如要為外部工作負載建立服務帳戶,請按照下列步驟操作:

    1. 啟用 IAM、Security Token Service 和 Service Account Credentials API (如果尚未啟用)。

      啟用 API 所需的角色

      如要啟用 API,您必須具備 serviceusage.services.enable 權限。如果您建立了專案,可能已透過擁有者角色 (roles/owner) 取得這項權限。否則,您可以透過 Service Usage 管理員角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

      啟用 API

    2. 建立代表工作負載的服務帳戶。建議您為每項工作負載使用專屬服務帳戶。服務帳戶不一定要與 workload identity pool 位於相同專案,但您必須參照含有服務帳戶的專案。

    3. 授予服務帳戶存取權,讓外部身分存取所需資源。

  2. 如要允許聯合身分模擬服務帳戶,請按照下列步驟操作:

控制台

如要使用 Google Cloud 控制台,將 IAM 角色授予具備服務帳戶的聯合身分,請按照下列步驟操作:

相同專案中的服務帳戶

  1. 如要使用服務帳戶模擬功能,為同一專案中的服務帳戶授予存取權,請按照下列步驟操作:

    1. 前往「Workload Identity Pools」頁面。

      前往「Workload Identity Pools」頁面

    2. 選取「授予存取權」。

    3. 在「Grant access to service account」(授予服務帳戶存取權) 對話方塊中,選取「Grant access using Service Account impersonation」(透過服務帳戶模擬功能授予存取權)。

    4. 在「Service accounts」(服務帳戶) 清單中,選取要讓外部身分模擬的服務帳戶,然後執行下列操作:

    5. 如要選擇集區中哪些身分可以模擬服務帳戶,請執行下列任一操作:

      • 如要僅允許 workload identity pool 的特定身分模擬服務帳戶,請選取「Only identities matching the filter」(僅限符合篩選條件的身分)。

      • 在「Attribute name」(屬性名稱) 清單中,選取要篩選的屬性。

      • 在「Attribute value」(屬性值) 欄位中,輸入預期的屬性值。舉例來說,如果您使用屬性對應 google.subject=assertion.sub,請將「Attribute name」(屬性名稱) 設為 subject,並將「Attribute value」(屬性值) 設為外部身分識別資訊提供者所核發權杖中的 sub 權杖附加資訊值。

    6. 如要儲存設定,請依序點選「Save」(儲存) 和「Dismiss」(關閉)。

其他專案中的服務帳戶

  1. 如要使用服務帳戶模擬功能,為其他專案中的服務帳戶授予存取權,請按照下列步驟操作:

    1. 前往「Service Accounts」(服務帳戶) 頁面

      前往「Service Accounts」(服務帳戶) 頁面

    2. 選取要模擬的服務帳戶。

    3. 按一下「管理存取權」。

    4. 按一下「Add principal」(新增主體)。

    5. 在「New principal」(新增主體) 欄位中,輸入下列其中一個主體 ID,代表集區中要模擬服務帳戶的身分。

      依科目

      principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/subject/SUBJECT
      

      更改下列內容:

      • PROJECT_NUMBER:專案編號
      • POOL_ID:工作負載集區 ID
      • SUBJECT:從 IdP 對應的個別主體,例如 administrator@example.com

      依群組

      principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/group/GROUP
      

      更改下列內容:

      • PROJECT_NUMBER:專案編號
      • WORKLOAD_POOL_ID:工作負載集區 ID
      • GROUP:從 IdP 對應的群組,例如:administrator-group@example.com

      依屬性

      principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE
      

      更改下列內容:

      • PROJECT_NUMBER:專案編號
      • WORKLOAD_POOL_ID:工作負載集區 ID
      • ATTRIBUTE_NAME:從 IdP 對應的其中一個屬性
      • ATTRIBUTE_VALUE:屬性的值

      依集區

      principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/*
      

      更改下列內容:

      • PROJECT_NUMBER:專案編號
      • WORKLOAD_POOL_ID:工作負載集區 ID
    6. 在「Select a role」(選取角色) 中,選取 Workload Identity 使用者角色 (roles/iam.workloadIdentityUser)。

    7. 如要儲存設定,請按一下「儲存」。

gcloud

如要將 Workload Identity 使用者角色 (roles/iam.workloadIdentityUser) 授予聯合主體或主體集,請執行下列指令。如要進一步瞭解 Workload Identity Federation 主體 ID,請參閱「主體類型」。

依主題

gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
    --role=roles/iam.workloadIdentityUser \
    --member="principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/subject/SUBJECT"

依群組

gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
    --role=roles/iam.workloadIdentityUser \
    --member="principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/group/GROUP"

依屬性

gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
    --role=roles/iam.workloadIdentityUser \
    --member="principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE"

更改下列內容:

  • SERVICE_ACCOUNT_EMAIL:服務帳戶的電子郵件地址
  • PROJECT_NUMBER:workload identity pool 所在專案的專案編號。
  • POOL_ID:workload identity pool 的集區 ID
  • SUBJECT:您對應至 google.subject 的屬性預期值
  • GROUP:您對應至 google.groups 的屬性預期值
  • ATTRIBUTE_NAME:屬性對應中的自訂屬性名稱
  • ATTRIBUTE_VALUE:屬性對應中的自訂屬性值

下載設定

如要讓工作負載存取用戶端程式庫,您必須先下載並設定應用程式預設憑證 (ADC),步驟如下:

  1. 前往 Google Cloud 控制台的「Workload Identity Pools」頁面。

    前往「Workload Identity Pools」頁面
  2. 在表格中選取集區,前往集區的詳細資料頁面。

  3. 按一下「授予存取權」。

  4. 選取「使用聯合身分授予存取權 (建議)」。

  5. 如要下載應用程式預設憑證 (ADC),讓工作負載存取用戶端程式庫,請按照下列步驟操作:

    1. 按一下「下載設定檔」。

    2. 在「Configure your application」(設定應用程式) 對話方塊中,執行下列操作:

      1. 在「Provider」(供應商) 下拉式選單中,選取您的供應商。

      2. 在「OIDC token path」(OIDC 權杖路徑) 或「SAML assertion path」(SAML 斷言路徑) 中,輸入權杖或斷言所在的路徑。

      3. 在「Format type」(格式類型) 下拉式選單中,選取格式。

    3. 按一下「Download configuration」(下載設定),並記下檔案儲存路徑。