Workload Identity Federation 可讓您使用聯合身分 (而非服務帳戶金鑰),將 Google Cloud 資源的存取權授予地端部署或多雲端工作負載。
您可以為執行下列任一操作的服務和管道設定聯合:
- 使用 X.509 用戶端憑證進行驗證。
- 在 Amazon Web Services (AWS) 或 Azure 上執行。
- 連線至地端部署 Active Directory。
- 在 GitHub 和 GitLab 等管道中建構及部署。
- 從支援 OpenID Connect (OIDC) 或安全宣告標記語言 (SAML) 2.0 的任何外部識別資訊提供者 (IdP) 取得權杖。
為何要使用 Workload Identity Federation?
在 Google Cloud 外部執行的應用程式可以使用服務帳戶金鑰存取 Google Cloud 資源。不過,服務帳戶金鑰是功能強大的憑證,如果管理不當,可能會帶來安全風險。Workload Identity Federation 可免除服務帳戶金鑰的維護和安全負擔。
透過 Workload Identity Federation,您可以使用 Identity and Access Management (IAM),根據 workload identity pool 中的聯合身分,將 IAM 角色授予主體。您可以授予主體特定 Google Cloud 資源的存取權。這種做法稱為「直接存取」。或者,您也可以將存取權授予服務帳戶,讓服務帳戶存取 Google Cloud 資源。這種做法稱為「服務帳戶模擬」。
workload identity pool
workload identity pool 是用於管理外部身分的實體。
一般來說,建議您為每個需要存取 Google Cloud 資源的非Google Cloud環境 (例如開發、測試或正式環境) 建立新的集區。
workload identity pool 提供者
workload identity pool 提供者是描述 Google Cloud 和 IdP 之間關係的實體,包括:
- AWS
- Microsoft Entra ID
- GitHub
- GitLab
- Kubernetes 叢集
- Okta
- 地端部署 Active Directory Federation Services (AD FS)
- Terraform
Workload Identity Federation 遵循 OAuth 2.0 權杖交換規格。您將 IdP 的憑證提供給 Security Token Service,該服務會驗證憑證上的身分,然後傳回聯合權杖做為交換。
使用本機 JWK 的 OIDC 提供者
如要聯合沒有公開 OIDC 端點的工作負載,可以直接將 OIDC JSON Web Key Sets (JWKS) 上傳至集區。如果 Terraform 或 GitHub Enterprise 託管於自有環境,或有法規要求不得公開網址,通常會發生這種情況。詳情請參閱「管理 OIDC JWK (選用)」。
屬性對應
外部 IdP 核發的權杖包含一或多個屬性。某些 IdP 會將這些屬性稱為「權杖附加資訊」。
Google Security Token Service 權杖也包含一或多個屬性,如下表所示:
| 屬性 | 說明 |
|---|---|
google.subject |
這是必要旗標,使用者的專屬 ID。這項屬性用於 IAM principal:// 角色繫結,並會顯示在 Cloud Logging 記錄中。值不得重複,且長度不得超過 127 個字元。
|
google.groups |
選用。身分所屬的一組群組。這項屬性用於 IAM principalSet:// 角色繫結,可將存取權授予群組的所有成員。 |
attribute.NAME |
選用。您最多可以定義 50 個自訂屬性,並在 IAM principalSet:// 角色繫結中使用這些屬性,將存取權授予具有特定屬性的所有身分。 |
屬性對應關係會定義如何從外部權杖衍生 Google Security Token Service 權杖屬性的值。您可以為每個 Google Security Token Service 權杖屬性定義屬性對應,格式如下:
TARGET_ATTRIBUTE=SOURCE_EXPRESSION
更改下列內容:
TARGET_ATTRIBUTE是 Google Security Token Service 權杖的屬性SOURCE_EXPRESSION是一般運算語言 (CEL) 運算式,可轉換外部 IdP 核發權杖中的一或多個屬性
以下列出屬性對應範例:
將宣告屬性
sub指派給google.subject:google.subject=assertion.sub
串連多個斷言屬性:
google.subject='myprovider::' + assertion.aud + '::' + assertion.sub
將 GUID 值斷言屬性
workload_id對應至名稱,並將結果指派給名為attribute.my_display_name的自訂屬性:attribute.my_display_name={ "8bb39bdb-1cc5-4447-b7db-a19e920eb111": "Workload1", "55d36609-9bcf-48e0-a366-a3cf19027d2a": "Workload2" }[assertion.workload_id]使用 CEL 邏輯運算子和函式,根據身分的 Amazon Resource Name (ARN),將名為
attribute.environment的自訂屬性設為prod或test:attribute.environment=assertion.arn.contains(":instance-profile/Production") ? "prod" : "test"使用
extract函式,以假設角色的名稱填入自訂屬性aws_role,如果沒有假設角色,則填入身分的 ARN。attribute.aws_role=assertion.arn.contains('assumed-role') ? assertion.arn.extract('{account_arn}assumed-role/') + 'assumed-role/' + assertion.arn.extract('assumed-role/{role_name}/') : assertion.arn使用
split函式,依指定的分隔符分割字串。舉例來說,如要從電子郵件地址屬性中擷取username屬性,請在@符號處分割其值,並使用第一個字串,然後使用下列屬性對應:attribute.username=assertion.email.split("@")[0]使用
join函式,在指定的分隔符上加入字串清單。舉例來說,如要串連字串清單並以.做為分隔符號,藉此填入自訂屬性department,請使用下列屬性對應:attribute.department=assertion.department.join(".")
使用 X.509 用戶端憑證時,Workload Identity Federation 預設會將 google.subject 對應至用戶端憑證主體一般名稱 (assertion.subject.dn.cn):
google.subject=assertion.subject.dn.cn
您也可以從葉憑證和中繼憑證對應其他屬性。
如果是 AWS,若您未指定屬性對應,Google 會套用下列預設對應,涵蓋大多數常見情境:
google.subject=assertion.arn
attribute.aws_role=assertion.arn.contains('assumed-role') ? assertion.arn.extract('{account_arn}assumed-role/') + 'assumed-role/' + assertion.arn.extract('assumed-role/{role_name}/') : assertion.arn
這項對應會將 google.subject 設為呼叫者的 ARN,並將 attribute.aws_role 設為假設角色的 ARN (不含工作階段名稱) (如果假設角色的話),否則設為呼叫者的 ARN。您也可以提供自訂對應。
如果是 OIDC 和 SAML 提供者,您必須提供屬性對應。如要建立對應關係,請參閱提供者的說明文件,瞭解其憑證上的屬性清單。
詳情請參閱 attributeMapping 欄位的 API 說明文件。
屬性條件
「屬性條件」是 CEL 運算式,可檢查斷言屬性和目標屬性。如果特定憑證的屬性條件評估結果為 true,系統就會接受該憑證。否則,憑證會遭到拒絕。
您可以使用屬性條件,限制哪些身分可以透過 workload identity pool 進行驗證。
屬性條件適用於下列情況:
如果工作負載使用的 IdP 開放一般大眾使用,您可以限制存取權,只允許您選擇的身分存取 workload identity pool。
如果您使用具有多個雲端平台的 IdP,可以防止用於其他平台的憑證用於 Google Cloud,反之亦然。這有助於避免混淆代理問題。
workload identity pool 提供者的屬性條件可以使用 assertion 關鍵字,這個關鍵字代表 IdP 核發的驗證憑證。您可以使用點標記法存取對應的值。舉例來說,AWS 憑證包含 arn 值,您可以透過 assertion.arn 存取。此外,屬性條件可以使用提供者屬性對應中定義的任何屬性。
下列範例僅允許來自具有特定 AWS 角色的身分要求:
attribute.aws_role == "ROLE_MAPPING"
詳情請參閱 attributeCondition 欄位的 API 說明文件。
存取權管理
權杖交換流程會傳回聯合存取權杖。您可以使用這個聯合存取權杖,代表 Google Cloud 資源上的主體身分授予工作負載存取權,並取得短期 OAuth 2.0 存取權杖。
您可以使用這個存取權杖提供 IAM 存取權。
建議您使用 Workload Identity Federation,直接提供 Google Cloud 資源的存取權。雖然大多數 Google Cloud API 都支援 Workload Identity Federation,但部分 API 有限制。或者,您也可以使用服務帳戶模擬功能。
短期存取權杖可讓您呼叫資源或服務帳戶有權存取的任何 Google Cloud API。
直接存取資源
您可以使用直接資源存取權,透過資源專屬角色,直接將 Google Cloud 資源的存取權授予外部身分。
替代方案:服務帳戶模擬
您必須將 Workload Identity 使用者角色 (roles/iam.workloadIdentityUser) 授予服務帳戶。
主體範圍和安全性
您可以使用主體類型,將存取權授予主體或其子集。
主體類型
下表說明如何將主體定義為個別身分和身分群組:
| 身分 | ID 格式 |
|---|---|
| 單一識別身分 |
principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/
|
| 群組中的所有身分 |
principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/
|
| 具有特定屬性值的所有身分 |
principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/
|
後續步驟
使用 Workload Identity Federation,讓工作負載存取 AWS 或 Azure、X.509 憑證、Active Directory、部署管道或 OIDC 或 SAML 提供者的資源。
瞭解如何使用 Google Cloud CLI 或 REST API 管理 workload identity pool。