有了員工身分聯盟,外部 IdP 中的使用者就能透過單一登入 (SSO) 存取 Google Cloud 資源。
什麼是員工身分聯盟?
員工身分聯盟可讓您使用外部 IdP 驗證員工,包括使用者和使用者群組,例如員工、合作夥伴和承包商。使用者可以透過 IdP,使用單一登入 (SSO) 存取 Google Cloud 。使用允許政策,授權工作團隊使用者存取 Google Cloud 服務。
聯盟與同步處理
員工身分聯盟會從 IdP 聯合身分,因此不會將使用者帳戶儲存在 Google Cloud中。因此,員工身分聯盟不需要同步處理,也就是說,您不必使用工具,將 IdP 的使用者身分同步至需要 Google 帳戶的 Google 代管身分。舉例來說,使用員工身分聯盟時,您不需要使用 Cloud Identity 的 Google Cloud Directory Sync (GCDS)。
如要比較這個方法與其他聯合架構,請參閱「身分聯合架構模式」。
員工身分聯盟與 Workload Identity Federation
員工身分聯盟會聯合使用者身分,而 Workload Identity Federation 則會聯合工作負載身分。
員工身分聯盟是針對人類登入率設計,並依此建立容量模型。權杖交換受限於配額指標 sts.googleapis.com/workforce_requests,預設為每個組織每分鐘 1,000 個要求。如要查看目前的值,請參閱「配額與限制」。
詳情請參閱「Workload Identity Federation」。
以屬性為準的存取權
員工身分聯盟可擴充 Google Cloud的身分功能,支援以屬性為基礎的存取權。在某些 IdP 中,屬性也稱為「權杖附加資訊」或「斷言」。
使用者驗證後,系統會使用從 IdP 接收的屬性,判斷 Google Cloud 資源的存取範圍。
支援的通訊協定
員工身分聯盟可與任何支援 OpenID Connect (OIDC) 或 SAML 2.0 的 IdP 搭配使用,例如 Microsoft Entra ID、Active Directory Federation Services (AD FS)、Okta 等。
基本概念
本節說明員工身分聯盟的重要概念。
工作團隊身分集區
員工身分集區可讓您管理員工身分群組,以及這些群組對 Google Cloud 資源的存取權。
集區可讓您執行下列操作:
- 群組使用者身分,例如
employees或partners - 授予整個集區或部分集區的 IAM 存取權。
- 從一或多個 IdP 聯合身分。
- 為需要類似存取權限的一群使用者定義政策。
- 指定 IdP 專屬設定資訊,包括屬性對應和屬性條件。
- 為第三方身分啟用 Google Cloud CLI 和 API 存取權。
- 將集區內使用者的存取記錄和集區 ID 傳送至 Cloud 稽核記錄。
您可以建立多個集區。如需說明其中一種方法的範例,請參閱「範例:多個員工身分集區」。
集區是在Google Cloud 組織層級設定,因此請考量下列事項:
- 首次為組織設定員工身分聯盟時,請為集區提供專屬 ID。集區 ID 在 Google Cloud的所有員工身分集區中不得重複,且應清楚說明其中包含的身分。
- 如果您具備適當的 IAM 權限,可以查看集區,則組織內的所有專案和資料夾都能透過集區 ID 參照集區。
員工身分集區提供者
員工身分集區提供者是一個實體,會說明 Google Cloud 組織和 IdP 之間的關係。
員工身分聯盟遵循 OAuth 2.0 權杖交換規格 (RFC 8693)。您將外部 IdP 的憑證提供給 Security Token Service,該服務會驗證憑證中的身分,然後傳回短期 Google Cloud 存取權杖做為交換。
OIDC 流程類型
如果是 OIDC 提供者,員工身分聯盟支援授權碼流程和隱含流程。一般認為授權碼流程的安全性最高,因為使用者驗證後,權杖會透過獨立的安全後端交易,直接從 IdP 傳回 Google Cloud。因此,程式碼流程交易可以擷取任何大小的權杖,讓您有更多宣告可用於屬性對應和屬性條件。相較之下,在隱含流程中,ID 權杖會從 IdP 傳回瀏覽器。權杖受限於個別瀏覽器網址大小限制。
使用授權碼流程時,您可以設定提供者,將 OIDC UserInfo 端點的宣告與 ID 權杖宣告合併 (merge-user-info-over-id-token-claims),或僅納入 ID 權杖宣告 (only-id-token-claims)。隱含流程僅支援 ID 權杖宣告 (only-id-token-claims)。
Google Cloud 員工身分聯盟控制台
員工身分集區中的使用者可以存取 Google Cloud 員工身分聯盟控制台 (也稱為控制台 (聯合))。控制台可讓這些使用者透過 UI 存取Google Cloud 支援員工身分聯盟的產品。
屬性
IdP 會提供屬性,某些 IdP 會稱之為「權杖附加資訊」。屬性內含使用者的資訊。您可以在屬性對應和屬性條件中使用這些屬性。
屬性對應
您可以使用一般運算語言 (CEL) 對應這些屬性,供 Google Cloud 使用。
本節說明Google Cloud 提供的必要和選用屬性。
您也可以在 IdP 中定義自訂屬性,然後由特定 Google Cloud 產品使用,例如在 IAM 許可政策中。
屬性對應的大小上限為 16 KB。如果屬性對應的大小超過 16 KB 限制,登入嘗試就會失敗。
屬性如下:
google.subject(必要):驗證使用者的專屬 ID。這通常是 JWT 的主體宣告,因為 Cloud 稽核記錄會將這個欄位的內容記錄為主體。您可以使用這個欄位,設定 IAM 授權決策。建議您不要使用可變動的值,因為如果您在 IdP 的使用者目錄中變更該值,使用者就會失去存取權。長度上限為 127 個位元組。
google.groups(選用):驗證使用者所屬的群組集合。您可以使用 CEL 子集設定邏輯運算式,產生字串陣列。您也可以使用這個欄位,設定 IAM 的授權決策。google.groups的限制如下:建議您將群組名稱限制在 40 個字元內。
如果單一使用者屬於超過 400 個群組,該使用者的登入嘗試將會失敗。如要降低這類風險,請在宣告中定義較小的群組組合,並只對應那些用於將使用者連結至 Google Cloud的群組。
如果您使用這項屬性在 IAM 中授予存取權,對應群組中的每位成員都會獲得存取權。因此,建議您確保只有貴機構中獲得授權的使用者,才能修改對應群組的成員。
google.display_name(選用):用於 Google Cloud 設定控制台中 登入使用者名稱的屬性。這項屬性無法用於 IAM 允許政策或屬性條件。長度上限為 100 個位元組。
google.profile_photo(選用):使用者縮圖相片的網址。 建議使用 400x400 像素的相片。設定這項屬性後, Google Cloud 控制台會顯示該圖片做為使用者的個人資料相片。如果未設定這個值,或無法擷取,系統會改為顯示一般使用者圖示。這項屬性無法用於 IAM 允許政策或屬性條件。google.posix_username(選用):符合 POSIX 標準的不重複使用者名稱字串,用於下列用途:這項屬性無法用於 IAM 允許政策或屬性條件。長度上限為 32 個字元。
google.email(選用):這項屬性用於將已登入的聯合使用者電子郵件地址,從 IdP 對應至您使用員工身分聯盟 OAuth 用戶端整合整合的產品。這項屬性無法用於 IAM 允許政策或屬性條件。舉例來說,如要使用 OIDC 通訊協定對應 Okta 的電子郵件地址,請在屬性對應中加入
google.email=assertion.email。支援 OAuth 用戶端整合的 Google Cloud 產品範例如下:
attribute.KEY(選用):使用者 IdP 權杖中,由外部 IdP 定義的屬性。您可以使用自訂屬性,在 IAM 許可政策中定義授權策略。舉例來說,在 IdP 中,您可以選擇將使用者的成本中心等屬性定義為
costcenter = "1234",然後以下列方式參照主體:principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workforcePools/WORKFORCE_POOL_ID/attribute.costcenter/1234
將 Google Cloud 資源的存取權授予這個主體 ID 後,在 IdP 中設定為
costcenter屬性設為1234的所有身分,都能存取資源。您最多可以設定 50 項自訂屬性對應規則。每項規則的大小上限為 2048 個半形字元。
雖然我們不限制您在此對應的屬性,但強烈建議您選擇值穩定的屬性。舉例來說,
attribute.job_description等屬性可能會因多種原因而變更 (例如提高可讀性)。建議您改用attribute.role。後者的變更表示指派的責任有所變更,且與授予使用者的存取權變更一致。
您可以使用標準 CEL 函式轉換屬性值。您也可以使用下列自訂函式:
split函式會根據提供的分隔符值分割字串。舉例來說,如要從電子郵件地址屬性中擷取username屬性,請在@處分割值,並使用第一個字串,然後使用下列屬性對應:attribute.username=assertion.email.split("@")[0]join函式會根據提供的分隔符號值,彙整字串清單。舉例來說,如要串連字串清單並以.做為分隔符號,藉此填入自訂屬性department,請使用下列屬性對應:attribute.department=assertion.department.join(".")
屬性條件
屬性條件是選用的 CEL 運算式,可讓您對 Google Cloud 接受的身分屬性設定限制。
使用屬性條件的好處包括:
- 您可以使用屬性條件,只允許部分外部身分向 Google Cloud 專案進行驗證。舉例來說,您可能只想允許特定團隊中的身分登入,尤其是在使用公開 IdP 時。再舉一個例子,您可能想允許會計團隊登入,但不允許工程團隊登入。
- 屬性條件可防止用於其他平台的憑證用於 Google Cloud,反之亦然。這有助於避免混淆代理問題。
多租戶 IdP 的屬性條件
員工身分聯盟不會維護使用者帳戶目錄,而是採用宣告式身分。因此,如果兩個權杖是由同一個 IdP 核發,且其權杖附加資訊對應至相同的 google.subject 值,系統會假設這兩個權杖識別的是同一位使用者。為找出核發權杖的 IdP,員工身分聯盟會檢查並驗證權杖的核發者網址。
多租戶 IdP (例如 GitHub 和 Terraform Cloud) 會在所有租戶中使用單一發布者網址。對於這些供應商,核發者網址會識別整個 GitHub 或 Terraform Cloud,而非特定的 GitHub 或 Terraform Cloud 組織。
使用這些 IdP 時,僅讓員工身分聯盟檢查權杖的核發者網址,不足以確保權杖來自信任的來源,且其聲明可信。如果多租戶 IdP 只有一個核發者網址,您必須使用屬性條件,確保只有正確的租戶可以存取。
詳細的稽核記錄
詳細稽核記錄是員工身分聯盟的一項功能,可將從 IdP 接收的屬性記錄到 Cloud 稽核記錄。
建立員工身分集區提供者時,可以啟用詳細稽核記錄功能。
如要瞭解如何透過詳細的稽核記錄排解屬性對應錯誤,請參閱「一般屬性對應錯誤」。
JSON Web 金鑰
工作團隊集區提供者可以存取 IdP 在 /.well-known/openid-configuration 文件 jwks_uri 欄位中提供的 JSON Web 金鑰 (JWK)。如果 OIDC 供應商未提供這項資訊,或核發者不公開,您可以在建立或更新 OIDC 供應商時,手動上傳 JWK。
SCIM 支援
如果 IdP 支援跨網域身分管理系統 (SCIM),您可以設定 IdP,在 Google Cloud中佈建及管理群組。
詳情請參閱「員工身分聯盟的 SCIM 佈建」和「設定 Gemini Enterprise 的識別資訊提供者」。
允許政策的工作團隊主體 ID
下表列出主體 ID,可用於將角色授予個別使用者和使用者群組。
| 身分 | ID 格式 |
|---|---|
| 工作團隊身分集區中的單一身分 |
principal://iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ATTRIBUTE_VALUE
|
| 群組中的所有員工身分 |
principalSet://iam.googleapis.com/locations/global/workforcePools/POOL_ID/group/GROUP_ID
|
| 具有特定屬性值的所有員工身分 |
principalSet://iam.googleapis.com/locations/global/workforcePools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE
|
| 員工身分集區中的所有身分 |
principalSet://iam.googleapis.com/locations/global/workforcePools/POOL_ID/*
|
如需主體 ID 的完整清單,請參閱「主體 ID」。
其他注意事項
本節說明使用員工身分聯盟時的其他注意事項。
限制跨組織存取
員工身分集區主體無法直接存取所屬組織以外的資源。不過,如果主體有權模擬組織中的服務帳戶,則可略過這項限制,因為服務帳戶不受相同限制。
工作團隊集區使用者專案
大多數 Google Cloud API (以資源為基礎的 API) 會向包含資源的專案收取費用和配額。某些 API (用戶端 API) 會向與用戶端相關聯的專案 (稱為「配額專案」) 收費。
建立員工身分聯盟設定檔時,您必須指定員工集區使用者專案。這個專案會向 Google API 識別您的應用程式,並做為用戶端 API 的預設配額專案,除非您使用 gcloud CLI 提出要求。您必須具備指定專案的 serviceusage.services.use 權限,這項權限包含在服務使用情形消費者角色 (roles/serviceusage.serviceUsageConsumer) 中。
如要進一步瞭解配額專案、以資源為基礎的 API 和以用戶端為基礎的 API,請參閱「配額專案總覽」。
範例:多個員工身分集區
本節提供一個範例,說明多個集區的一般用途。
您可以為員工和合作夥伴分別建立一個集區。跨國組織可能會為組織中的不同部門建立個別集區。集區可進行分散式管理,不同群組可以獨立管理特定集區,且角色只會授予集區中的身分。
舉例來說,假設有一家名為 Enterprise Example Organization 的公司,與另一家名為 Partner Example Organization Inc 的公司簽約,由後者提供 Google Kubernetes Engine (GKE) DevOps 服務。為提供服務,Partner Example Organization 的員工必須能存取 Enterprise Example Organization 的 Google Kubernetes Engine (GKE) 和其他 Google Cloud 資源。Enterprise Example 組織已有一個名為 enterprise-example-organization-employees 的員工身分集區。
為允許 Partner Example Organization 管理 Enterprise Example Organization 資源的存取權,Enterprise Example Organization 為 Partner Example Organization 工作團隊使用者建立獨立的工作團隊集區,以便 Partner Example Organization 進行管理。Enterprise Example Organization 將工作團隊集區提供給 Partner Example Organization 組織管理員。合作夥伴範例機構的管理員使用自己的 IdP 授予員工存取權。
為此,Enterprise Example Organization 的管理員會執行下列工作:
在 Enterprise Example Organization 的 IdP 中,為 Partner Example Organization 組織管理員建立身分 (例如
partner-organization-admin@example.com),該 IdP 已在名為enterprise-example-organization-employees的集區中設定。建立新的工作團隊集區,並命名為
example-organization-partner。為
example-organization-partner集區建立下列允許政策:{ "bindings": [ { "role": "roles/iam.workforcePoolEditor", "members": [ "principalSet://iam.googleapis.com/locations/global/workforcePools/enterprise-example-organization-employees/subject/partner-organization-admin@example.com" ] } ] }在 Enterprise Example Organization 組織中,為
example-organization-partner集區授予所需資源的角色。
Partner Example Organization 的管理員現在可以設定 example-organization-partner 集區,與其 IdP 建立連線。接著,他們可以允許 Partner Example Organization 員工使用 Partner Example Organization 的 IdP 憑證登入。登入後,Partner Example Organization 工作團隊使用者可以存取 Google Cloud 資源,但受限於 Enterprise Example Organization 定義的政策。
安全性群組最佳做法
在大型企業中,IT 管理員通常會建立安全性群組,做為最佳做法存取控管模型的一部分。安全性群組會控管內部資源的存取權。此外,公司通常會為員工建立額外的群組,並為合作夥伴建立其他群組,將這種存取控管模式延伸至雲端資源。這可能會導致深度巢狀群組激增,變得難以管理。
貴組織也可能設有政策,限制可建立的群組數量,以維持使用者目錄階層的扁平化。如要避免允許政策設定錯誤,並限制群組成長,更好的解決方案是使用多個集區,更廣泛地分隔來自不同組織單位、業務單位和合作夥伴組織的使用者。接著,您可以參照這些集區和集區中的群組,定義允許政策 (請參閱「設定 IAM」步驟中的範例)。如需群組治理和集區管理的其他建議,請參閱「使用員工身分聯盟的最佳做法」。
VPC Service Controls 限制
員工身分聯盟管理功能 (包括員工集區設定 API) 不支援 VPC Service Controls。不過,同時支援員工身分聯盟和 VPC Service Controls 的 Google Cloud 產品會按照說明文件運作,並須接受 VPC Service Controls 政策檢查。此外,您也可以在 VPC Service Controls 的輸入或輸出規則中,使用第三方身分,例如員工集區使用者和 Workload Identity。
如果 Security Token Service API 要求的目標對象是員工身分聯盟集區 (組織層級資源),您必須設定輸出規則。這是因為 VPC Service Controls 不支援直接將組織層級資源新增至 perimeter。下列輸出規則允許源自 perimeter 的要求,連線至與組織層級工作團隊集區互動的工作團隊 STS API:
- egressTo:
operations:
- serviceName: 'sts.googleapis.com'
methodSelectors:
- method: '*'
resources:
- '*'
egressFrom:
identityType: ANY_IDENTITY
員工身分聯盟和重要聯絡人
如要接收有關組織或Google Cloud 產品異動的重要資訊,請務必在使用 Workforce Identity Federation 時提供重要聯絡人。Cloud Identity 使用者可透過 Cloud Identity 電子郵件地址聯絡,但員工身分聯盟使用者則需透過重要聯絡人聯絡。
使用 Google Cloud 控制台建立或管理員工身分集區時,您會看到橫幅,要求您設定「法律」和「停權」類別的重要聯絡人。如果沒有個別聯絡人,也可以在「All」(全部) 類別中定義聯絡人。提供聯絡人後,橫幅就會移除。
後續步驟
- 查看身分聯合架構模式。
- 請參閱「使用員工身分聯盟的最佳做法」。
- 如要瞭解如何設定員工身分聯盟,請參閱「設定員工身分聯盟」。如需特定 IdP 的操作說明,請參閱下列文章:
- 取得員工身分聯盟的短期權杖
- 管理工作團隊集區提供者
- 刪除員工身分聯盟使用者及其資料
- 撤銷員工身分聯盟使用者工作階段
- 查看員工身分聯盟稽核記錄
- 查看支援員工身分聯盟的產品
- 設定使用者對控制台 (聯合) 的存取權