更新用於外部節點憑證啟動程序的自訂 Azure 角色

自 2026 年 11 月 30 日起,Azure Kubernetes Service (AKS) 需要專用的 Azure 角色基礎存取控制(Azure RBAC)DataAction 來授權 kubelet 客戶端憑證的發行。

Important

更新受影響的自訂 Azure 角色,請在 2026 年 11 月 30 日前更新。 否則,新的外部節點可能會無法加入 AKS 叢集,現有的外部節點也可能無法續訂其 kubelet 用戶端憑證。

此要求適用於用於外部節點啟動或 Kubelet 客戶端憑證更新的自訂 Azure 角色,包括 AKS Stretch 整合。 AKS 管理的節點通常不會受到影響。

過去,較廣泛的 certificatesigningrequests/write DataAction 也授權發行 kubelet 用戶端憑證。 AKS 將這些權限分開,以協助防止擁有一般憑證簽署要求寫入權限的主體取得可將其身分驗證為 Kubernetes 節點的憑證。

判斷自訂角色是否受到影響

若自訂角色被用於以下任一操作,則會受到影響:

  • 外部節點自舉。
  • 外部節點的 Kubelet 用戶端憑證更新。

如果自訂角色只用於一般的憑證簽署請求操作,則不需要加入新權限。

檢視你 Azure 服務健康狀態 通知或角色清單中的角色 ID,並確定每個角色的使用方式。 保留每個受影響角色現有的憑證簽署請求與 API 發現權限。

新增所需的 DataAction

新增對應你整合所使用的資源端點的 DataAction:

資源端點 所需 DataAction
受控叢集 Microsoft.ContainerService/managedClusters/certificates.k8s.io/certificatesigningrequests/nodeclient/action
車隊樞紐 Microsoft.ContainerService/fleets/certificates.k8s.io/certificatesigningrequests/nodeclient/action
車隊成員 Microsoft.ContainerService/fleets/members/certificates.k8s.io/certificatesigningrequests/nodeclient/action
AI 管理員 Microsoft.ContainerService/aiManagers/certificates.k8s.io/certificatesigningrequests/nodeclient/action

例如,透過管理叢集端點進行外部節點啟動的自訂角色包含以下權限:

{
  "DataActions": [
    "Microsoft.ContainerService/managedClusters/certificates.k8s.io/certificatesigningrequests/write",
    "Microsoft.ContainerService/managedClusters/certificates.k8s.io/certificatesigningrequests/read",
    "Microsoft.ContainerService/managedClusters/certificates.k8s.io/certificatesigningrequests/delete",
    "Microsoft.ContainerService/managedClusters/apis/certificates.k8s.io/read",
    "Microsoft.ContainerService/managedClusters/apis/certificates.k8s.io/v1beta1/read",
    "Microsoft.ContainerService/managedClusters/certificates.k8s.io/certificatesigningrequests/nodeclient/action"
  ]
}

對於艦隊樞紐、艦隊成員或 AI 管理員存取,請使用前表對應的資源路徑。

要更新受影響的角色:

  1. 請取得目前的角色定義。
  2. 將適用的 DataActions 權限加入角色的 certificatesigningrequests/nodeclient/action 屬性。
  3. 確認所有現有的憑證簽署請求與 API 發現權限保持不變。
  4. 更新自訂角色定義。
  5. 請預留時間讓 Azure RBAC 更新生效。

確認角色更新

在你更新受影響的自訂角色後:

  1. 檢索角色定義,並確認適用 certificatesigningrequests/nodeclient/action 權限是否出現在 DataActions。
  2. 確認所有現有的憑證簽署請求與 API 發現權限保持不變。
  3. 在測試環境中,執行端對端外部節點啟動測試,確認節點已達到 Ready 狀態。
  4. 對於現有的整合,請確認 kubelet 用戶端憑證是否能透過正常驗證流程成功續期。

預留大約一小時進行端對端外部節點啟動測試。 所需總時間可能會因組織的變更管理流程及更新角色數量而有所不同。

下一步