Azure Kubernetes Service (AKS) 支援結構化驗證,可讓您設定外部身分識別提供者,以向 Kubernetes API 伺服器驗證使用者。 此功能基於上游 Kubernetes 結構化認證設定。 AKS 會透過 JSON Web 權杖 (JWT) 驗證器來實作此功能,以根據您的設定驗證來自外部身分識別提供者的權杖。 透過結構化認證,組織能將 AKS 整合至超越 Microsoft Entra ID 的現有身份基礎架構。
本文概述如何利用外部身份提供者搭配 AKS 結構化認證,包括關鍵概念、安全考量及後續設定步驟。
這很重要
AKS 預覽功能可透過自助服務,以加入方式使用。 預覽是「依現況」及「可用時」提供的,並不包括在服務等級協定和有限保固之內。 客戶支援部門會盡最大努力,部分支援 AKS 預覽。 因此,這些功能不適合實際執行用途。 如需詳細資訊,請參閱下列支援文章:
外部身份提供者驗證的好處
結構化驗證將 AKS 的功能延伸至傳統 Microsoft Entra ID 整合之外,支援業界標準的 OpenID Connect (OIDC) 身分識別提供者。 這項功能可讓您:
- 使用外部身份提供者如 Google、GitHub 或任何符合 OIDC 規範的提供者來驗證使用者。
- 維持整個組織的集中身份管理。
- 實作自訂的理賠驗證與使用者映射規則。
- 在單一叢集中同時支援多個身份提供者。
外部身份提供者認證流程
當使用者嘗試使用外部身份提供者的結構化認證存取 Kubernetes API 伺服器時,認證與授權流程如下:
-
驗證:下列步驟會驗證使用者的身分識別:
- 令牌呈現:使用者從其設定的身份提供者中呈現 JWT 令牌。
- 代幣驗證:API 伺服器會驗證代幣的簽名、發行者、對象及到期日。
- 申請處理:會套用自訂的申請驗證規則,以確保代幣符合您的要求。
- 使用者映射:聲明會映射到 Kubernetes 的使用者身份(使用者名稱、群組及額外屬性)。
- 授權:標準 Kubernetes Role-Based 存取控制(RBAC)決定已驗證使用者可執行的動作。
支援的身分識別提供者
雖然 AKS 結構化認證允許任何符合 OIDC 的身份提供者使用,但常見提供者包括:
- GitHub:使用 GitHub 身份或 GitHub Actions 進行認證。
- Google OAuth 2.0:使用 Google 帳號進行認證。
- 通用 OIDC 提供者:任何實施 OIDC 標準的提供者。
- 自訂身份解決方案:組織專屬的 OIDC 實作。
備註
不支援透過結構化驗證將 Microsoft Entra ID 作為外部身分識別提供者。 使用現有的 Microsoft Entra 整合 來進行 Microsoft Entra ID 認證。
外部身份提供者的需求
外部身份提供者必須符合以下要求才能使用 AKS 結構化認證:
- 支援OIDC標準。
- 提供公開可存取的 OIDC 發現端點。
- 發行帶有適當主張權的JWT代幣。
- 可以從 AKS 叢集節點存取,以便進行代幣驗證。
JWT 驗證器用於 AKS 的結構化身份驗證
JWT 認證器是一個設定物件,定義 AKS 如何驗證並處理來自外部身份提供者的憑證。 例如,AKS 期望一個 ID 憑證(JWT),其 aud (受眾)聲明與你為驗證器設定的受眾值相符,例如 "my-api",或 OAuth 用戶端 ID。 每個 JWT 驗證器包含以下元件:
- 發行者配置:指定 OIDC 發行者網址及代幣的預期受眾值。
- 權利要求驗證規則:使用 CEL(通用表達語言)表達式來強制代幣權利要求的自訂驗證邏輯。
- 權利要求映射:定義 JWT 權利要求如何映射到 Kubernetes 使用者屬性,如使用者名稱、群組及額外欄位。
- 使用者驗證規則:在申請映射後套用額外的驗證邏輯,以進一步限制或允許存取。
用於理賠驗證與映射的 CEL 表達式
結構化認證使用 CEL 表達式進行靈活的理賠驗證與映射。 CEL 提供一個安全的沙盒環境,用於評估自訂邏輯與 JWT 主張。
CEL 運算式範例:
// Validate that the 'sub' claim exists
has(claims.sub)
// Map username with AKS prefix
'aks:jwt:' + claims.sub
// Map groups from comma-separated string
claims.groups.split(',').map(g, 'aks:jwt:' + g)
// Conditional mapping based on claim verification
'aks:jwt:' + (claims.email_verified ? claims.email : claims.sub)
安全性最佳做法
在使用帶有 AKS 結構化認證的外部身份提供者時,請謹記以下安全最佳實務:
- 使用強聲明驗證: 實施全面的驗證規則,確保僅接受授權代幣。
- 限制權杖範圍:設定您的識別提供者,以發出具有最少必要宣告的權杖。
- 定期輪換:定期輪換用戶端密碼和憑證。
-
監控存取:啟用 資源日誌 並開啟
kube-apiserver日誌,以檢查已配置的 JWT 驗證器的任何潛在問題並追蹤驗證事件。 - 測試設定:先在非生產環境中驗證你的 JWT 認證器設定。
安全性考慮
使用帶有 AKS 結構化認證的外部身份提供者時,請留意以下安全考量:
-
前綴要求:所有透過結構化驗證映射的使用者名稱與群組必須以 作為
aks:jwt:前綴,以避免與其他認證方法及系統帳號衝突。 -
網路存取:身份提供者端點必須能從以下管道存取:
- AKS 叢集節點用於令牌驗證。
- 用於代幣取得的客戶端系統。
- 任何涉及驗證流程的網路路徑。
-
驗證層:結構化認證提供多層驗證:
- 令牌簽名驗證 確保令牌真實性。
- 標準理賠驗證 會核實發行人、對象及到期日。
- 客製化理賠驗證 會依照貴組織的具體要求進行。
- 使用者驗證 是在索賠映射後進行的最後檢查。
相關內容
欲了解更多關於結構化驗證及相關功能的資訊,請參閱以下資源: