Azure Key Vault API 版本2026-02-01及後續版本會將新保存庫的預設存取控制模型變更為 Azure RBAC,與 Azure 入口網站體驗一致。 Azure RBAC 與存取政策均獲得完整支援。 API 版本2026-02-01可在公開的 Azure 區域、由 21Vianet 運營的 Azure 以及 Azure Government 提供。
本文聚焦於新金鑰保存庫和現有金鑰保存庫的存取控制行為。 關於控制平面 API 退休的指引,以及如何更新應用程式、腳本、範本、SDK、Azure CLI 和 Azure PowerShell,請參見「更新你所使用的 Azure Key Vault API 版本」。
-
新金鑰保險庫建立行為:當你建立 API 版本為
2026-02-01或更高版本的新保險庫時,預設的存取控制模型Azure為 RBAC(enableRbacAuthorization = true)。 此預設僅適用於 建立 操作。 若要讓新的保存庫使用存取原則,請在建立時將enableRbacAuthorization設定為false。 -
現有金鑰保險庫行為:現有保險庫會維持目前的存取控制模型,除非你明確更改
enableRbacAuthorization。 使用 API 版本2026-02-01或更新版本來更新保存庫,不會自動變更存取控制。 在較舊 API 版本中,enableRbacAuthorization為null的保存庫會繼續使用存取原則。
這很重要
在 2026-02-01 之前的所有 金鑰保存庫 控制平面 API 版本將於 2027 年 2 月 27 日淘汰。 此退休與存取控制遷移是分開的。 關於 API 版本更新檢查清單,請參見「更新你所使用的 Azure Key Vault API 版本」。
這很重要
升級至 Azure CLI 2.90.0 或更新版本,或支援 API 版本 2026-02-01 及更新版本的 Azure PowerShell 16.3.0 或更新版本。 2026-02-01 之前的 API 版本將於 2027 年 2 月 27 日後暫停使用。
我們鼓勵您將目前使用存取政策的金鑰保險庫遷移至 Azure RBAC,以提升安全性。 欲了解為何推薦Azure RBAC,請參見 Azure 角色基礎存取控制(Azure RBAC)與存取政策。 如需逐步遷移指引,請參閱從存取政策遷移至 Azure RBAC。
採取行動
如果你已經知道保險庫的存取控制模型,請跳到 「確定你的下一步步驟」。 否則,先 檢查你目前的配置 。
請參考這篇文章來決定存取控制應該如何設定:
- 如果您使用 API 版本
2026-02-01或更新版本建立新的保存庫,請決定是否接受 Azure RBAC 預設值,或明確設定存取原則。 - 如果你使用 API 版本
2026-02-01或更新版本來更新現有的保存庫,請注意,API 版本更新不會自動變更存取控制。 - 如果您要將現有的保存庫從存取原則移轉至 Azure RBAC,請使用專屬移轉指南。
這很重要
要更改金鑰保管庫的 enableRbacAuthorization 屬性,您必須擁有 Microsoft.KeyVault/vaults/write 權限(此權限包含在例如「貢獻者」和「擁有者」等角色中)。 Azure入口網站還需要 Microsoft.Authorization/roleAssignments/write(包含於擁有者與使用者存取管理員等角色中),以確保變更後能指派金鑰保存庫 RBAC 角色並避免鎖定。 欲了解更多資訊,請參閱 在 金鑰保存庫 上啟用 Azure RBAC 權限。
檢查你目前的設定
檢查你的保險庫存取設定是否設定為 Azure RBAC 或存取政策。 請透過 Azure CLI 或 PowerShell 指令檢查此設定。
檢查你的設定後:
- 如果您的保存庫使用 Azure RBAC(
enableRbacAuthorization=true),請移至 使用 Azure RBAC 的保存庫。 - 如果您的保存庫使用存取原則(舊版)(
enableRbacAuthorization=false或null),請移至使用存取原則的保存庫。
檢查單一保存庫
使用 az keyvault show 命令來檢索金鑰保存庫的詳細資訊:
az keyvault show --name <vault-name> --resource-group <resource-group>檢查金鑰保存庫的已啟用 RBAC 授權屬性 (
enableRbacAuthorization)。
依資源群組檢查多個保存庫
請使用 az keyvault list 指令列出資源群組中的所有保險庫,並檢查它們的 RBAC 授權狀態:
# List all key vaults in the resource group and check Azure RBAC status
az keyvault list --resource-group <resource-group> --query "[].{name:name, rbacEnabled:properties.enableRbacAuthorization}" --output table
檢查您的訂用帳戶中的多個保存庫
使用 az keyvault list 命令,列出您的訂用帳戶中所有保存庫,並檢查其 RBAC 授權狀態:
# List all key vaults in the subscription and check Azure RBAC status
az keyvault list --query "[].{name:name, rbacEnabled:properties.enableRbacAuthorization}" --output table
決定你的下一步
根據您目前的存取控制模式,請依照以下相關指引操作。
請將 API 版本更新與存取控制遷移分開
如果您的應用程式、指令碼、範本或 SDK 使用早於 2026-02-01 的控制平面 API 版本,則無論您的金鑰保存庫是否使用 Azure RBAC 或存取原則,都請更新這些應用程式、指令碼、範本或 SDK。 這次 API 版本更新與從存取政策遷移到 Azure RBAC 是分開的。 關於如何辨識及更新應用程式、腳本、範本和 SDK 所使用的 API 版本,請參見「更新你所使用的 Azure Key Vault API 版本」。
採用 Azure RBAC 的保險庫
如果你的金鑰庫已經使用 Azure RBAC,就不需要更改存取控制。 新建的 API 版本2026-02-01或更新版金鑰庫預設也會使用 Azure RBAC,除非你明確設定enableRbacAuthorization為 false。
使用存取政策的保險庫
如果你的金鑰庫使用存取政策(舊有的)(enableRbacAuthorization = false 或 null),請決定是否要遷移到基於角色的存取(建議)或繼續使用存取政策。 欲了解更多存取控制模型資訊,請參閱使用 Azure RBAC 管理 金鑰保存庫 及 Azure Key Vault 最佳實務。
選擇你的道路:
- Azure RBAC(建議):遷移至Azure RBAC以提升安全性。
-
存取原則 (舊版):建立新的保存庫時,將 設為
enableRbacAuthorization,以false。
將至 Azure RBAC (建議使用)
利用這個機會,從保險庫存取政策遷移到 Azure RBAC,提升您的安全態勢。 關於遷移程序,請參見從存取政策遷移到 Azure RBAC。
繼續使用存取策略
存取政策仍是完全支援的存取控制模式。
-
現有保險庫:已使用存取政策的保險庫會繼續使用存取政策,除非你明確更改
enableRbacAuthorization。 -
新保險庫:當您使用 API 版本
2026-02-01或更新版本建立新的保險庫時,必須明確將enableRbacAuthorization設為false,才能使用存取原則,如以下各節所述。
根據您的情況,請選擇以下其中一種方法:
使用 ARM、Bicep、Terraform 模板
使用2026-02-01或更新版本的API建立新的金鑰保險庫時,請將所有金鑰保存庫 ARM、Bicep、Terraform 範本及 enableRbacAuthorization 呼叫中,將 false 設為 ,以使用存取政策(舊有)。
使用 Create 金鑰保存庫 指令
使用2026-02-01或更新版本的API建立新的金鑰保險庫時,必須指定存取政策設定以避免預設為Azure RBAC。
將 Azure CLI 或 PowerShell 模組更新到最新版本。
更新 Azure CLI 到最新版本。 欲了解更多資訊,請參閱 如何更新 Azure CLI。
使用適當的指令建立帶有存取政策的金鑰保險庫:
使用 az keyvault create 指令並設定 --enable-rbac-authorization false:
az keyvault create --name "testCreateTutorial" --resource-group "testResourceGroup" --enable-rbac-authorization false
使用 Create Resource 指令
當你使用 API 版本 2026-02-01 或更新建立新的金鑰庫時,請設定 enableRbacAuthorization 為 false 使用存取政策(舊版)。 如果你沒指定這個屬性,預設會變成 true(Azure RBAC)。
使用 az resource create 指令 並設定 "enableRbacAuthorization": false 和 --api-version "2026-02-01":
az resource create --resource-group $resourceGroup --name $vaultName --resource-type "Microsoft.KeyVault/vaults" --location $location --api-version "2026-02-01" --properties "{\"sku\": { \"family\": \"A\", \"name\": \"standard\" }, \"tenantId\": \"$tenantID\",\"enableRbacAuthorization\": false, \"accessPolicies\": []}"