針對具有兩組驗證認證的資源,將祕密的輪替自動化

驗證 Azure 服務的最佳方式是使用管理身份,但有些情況仍需存取金鑰或密碼。 經常輪換這些憑證,以減少洩漏的影響。

本教學示範如何自動化使用兩組認證憑證的資料庫與服務的週期性秘密輪換。 關於不同資產類型自動旋轉的概述,請參閱《了解 Azure Key Vault 中的自動旋轉》。

具體而言,本教學課程會輪替以祕密形式儲存在 Azure Key Vault 中的 Azure 儲存體帳戶金鑰。 它使用一個由 Azure 事件方格 通知觸發的功能。

Important

對於 Azure 儲存體,建議使用 Microsoft Entra ID 授權並使用管理身份,而非共享帳戶金鑰。 在合規條件允許的情況下,關閉儲存 帳號上的共享金鑰授權 ,完全移除金鑰輪換的需求。 只有當工作負載需要儲存帳戶金鑰或 連接字串 時,才使用本教學中的模式。

以下是本教學課程中所述的輪替解決方案:

顯示旋轉解決方案的圖表。

在此解決方案中,Azure Key Vault 將每個儲存帳號存取金鑰儲存為同一秘密的版本,並在不同版本中交替使用主金鑰與次要金鑰。 當其中一組存取金鑰被儲存為秘密的最新版本時,備用金鑰會被重新產生並加入 金鑰保存庫,成為新的最新版本。 此設計讓應用程式有一個完整的旋轉週期來接收新生出的金鑰。

  1. 在秘密到期前三十天,金鑰保存庫 將即將到期的事件發布到 Event Grid。
  2. 事件網格會檢查事件訂閱,並使用 HTTP POST 呼叫已訂閱事件的函數應用程式端點。
  3. 函式應用程式會識別替代金鑰(不是最新的金鑰),並呼叫記憶體帳戶來重新產生它。
  4. function 應用程式會將重新生成的金鑰加入 Azure Key Vault,作為秘密的新版本。

先決條件

  • 一個 Azure 訂閱。 免費建立一個。
  • Azure Cloud Shell。 這個教學是使用 Portal Cloud Shell 搭配 PowerShell 環境。
  • Azure 金鑰保存庫。
  • 兩個 Azure 儲存帳號。

備註

旋轉共享儲存帳戶金鑰會撤銷該金鑰產生的任何帳號層級共享存取簽章(SAS)。 輪替後,重新生成帳號層級的 SAS 代幣,以避免對應用程式造成干擾。

如果你沒有現有的金鑰庫和兩個儲存帳號,請使用這個部署連結:

標示為「Deploy to Azure」的連結。

  1. 在 [資源群組] 下,選取 [新建]。 將群組 保存庫輪替 命名為 ,然後選取 [ 確定]。

  2. 選擇 檢閱 + 創建。

  3. 選取 ,創建。

    顯示如何建立資源群組的螢幕快照。

你現在有一個金鑰庫和兩個儲存帳戶。 請喺 Azure CLI 或 Azure PowerShell 中驗證此設定:

az resource list -o table -g vaultrotation

結果與以下輸出相似:

Name                     ResourceGroup         Location    Type                               Status
-----------------------  --------------------  ----------  ---------------------------------  --------
vaultrotation-kv         vaultrotation      westus      Microsoft.KeyVault/vaults
vaultrotationstorage     vaultrotation      westus      Microsoft.Storage/storageAccounts
vaultrotationstorage2    vaultrotation      westus      Microsoft.Storage/storageAccounts

建立和部署金鑰輪替函式

接著,建立一個功能應用程式,並配備系統指派的管理身份及其他必要元件,並部署儲存帳戶金鑰的輪替功能。

旋轉函數需要以下組件與配置:

  • Azure App 服務 方案。
  • 用於管理函式應用程式觸發程序的儲存體帳戶。
  • 可讓函式應用程式存取金鑰保存庫中祕密的 Azure 角色指派。
  • 指派給函式應用程式的 Storage Account Key Operator Service Role,使其能夠存取儲存體帳戶存取金鑰。
  • 一個帶有事件網格觸發器和 HTTP 觸發器(用於按需旋轉)的金鑰旋轉函式。
  • SecretNearExpiry 事件的「事件方格」事件訂閱。
  1. 選擇 Azure 範本部署連結:

    Azure模板部署連結。

  2. 在 資源群組 列表中,選取 vaultrotation。

  3. 在 儲存帳號 RG 中,輸入儲存帳號所在的資源群組名稱。 如果儲存帳號和輪換功能在同一資源群組,就保留預設 [resourceGroup().name] 值。

  4. 在 儲存帳號名稱中,輸入你想輪換的存取金鑰的儲存帳號名稱。 如果你使用[concat(resourceGroup().name, 'storage')]的儲存帳號,則保留預設。

  5. 在 金鑰保存庫 RG 中,輸入該 key vault 所在的資源群組名稱。 如果金鑰保險庫和輪換函式在同一資源群組,就保留預設 [resourceGroup().name] 值。

  6. 在 金鑰保存庫 名稱中,輸入 key vault 名稱。 如果您使用的是來自 [concat(resourceGroup().name, '-kv')] 的金鑰保存庫,請保留預設的 。

  7. 在 App Service 方案類型中,選擇主機方案。 只有當金鑰庫位於防火牆後方時,才需要使用高級方案。

  8. 在 功能應用程式名稱中,輸入功能應用程式名稱。

  9. 在 Secret Name 中,輸入用來儲存存取金鑰的秘密名稱。

  10. 在 Repo 網址中,輸入函式程式碼的 GitHub 位置:https://github.com/Azure-Samples/KeyVault-Rotation-StorageAccountKey-PowerShell.git。

  11. 選擇 檢閱 + 創建。

  12. 選取 ,創建。

    顯示如何建立和部署函式的螢幕快照。

部署完成後,你擁有一個儲存帳號、一個伺服器叢集、一個函式應用程式,以及一個 Application Insights 資源:

顯示 [您的部署已完成] 頁面的螢幕快照。

備註

這個 ARM 範本使用 App Service 原始碼控制(Kudu)部署,從 GitHub 拉取函式程式碼。 針對生產工作負載,建議改用套件式部署,例如 func azure functionapp publish,或 搭配 WEBSITE_RUN_FROM_PACKAGE 的 ZIP 部署 。 若部署失敗,請選擇 重新部署 以重試。

rotation 函式的部署範本和程式碼都在 Azure-Samples/KeyVault-Rotation-StorageAccountKey-PowerShell 裡。

將儲存帳戶存取金鑰加入 金鑰保存庫 機密中

首先,為自己指定 金鑰保存庫 秘密官的角色,這樣你就能管理 Vault 中的秘密:

az role assignment create --role "Key Vault Secrets Officer" --assignee <email-address-of-user> --scope /subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.KeyVault/vaults/vaultrotation-kv

你現在可以建立一個秘密,其值是儲存帳號存取金鑰。 除了這個值外,還要加上儲存帳戶資源 ID、秘密有效期和金鑰 ID 作為標籤,讓輪替功能能在儲存帳戶中重新生成金鑰。

確認儲存體帳戶資源識別碼。 就是 id 屬性:

az storage account show -n vaultrotationstorage

列出記憶體帳戶存取金鑰,以便取得金鑰值:

az storage account keys list -n vaultrotationstorage

將祕密新增至金鑰保存庫,並將其有效期設為 60 天,且(為了示範)將到期日設為明天,以立即觸發輪替。 使用你為 key1Value 和 storageAccountResourceId 取得的值來執行此命令:

tomorrowDate=$(date -u -d "+1 day" +"%Y-%m-%dT%H:%M:%SZ")
az keyvault secret set --name storageKey --vault-name vaultrotation-kv --value <key1-value> --tags "CredentialId=key1" "ProviderAddress=<storage-account-resource-id>" "ValidityPeriodDays=60" --expires $tomorrowDate

這個祕密會在幾分鐘內觸發一次 SecretNearExpiry 事件,進而觸發用來輪替該祕密的函式,並將到期日設為 60 天後。在這種配置下,SecretNearExpiry 事件每隔 30 天觸發一次(即到期前 30 天),而輪替函式會在 key1 與 key2 之間交替。

透過取得儲存帳號金鑰和 金鑰保存庫 秘密,確認存取金鑰是否重新生成,然後進行比較。

使用此指令來取得秘密資訊:

az keyvault secret show --vault-name vaultrotation-kv --name storageKey

請注意,CredentialId 已更新為可替代的 keyName,且 value 已重新生成。

此螢幕擷取畫面顯示第一個儲存體帳戶的 az keyvault secret show 命令的輸出。

擷取存取金鑰以比較值:

az storage account keys list -n vaultrotationstorage

注意金鑰值與金鑰庫中的秘密相符:

此螢幕擷取畫面顯示第一個儲存體帳戶的 az storage account keys list 命令的輸出。

使用現有的輪替功能來管理多個儲存帳號

你可以重複使用同一個功能應用程式來輪換多個儲存帳號的金鑰。

要將另一個儲存帳戶的金鑰加入現有的輪替函數,你需要:

  • 指派給函式應用程式的 Storage Account Key Operator Service Role,使其能夠存取儲存體帳戶存取金鑰。
  • SecretNearExpiry 事件的「事件方格」事件訂閱。
  1. 選擇 Azure 範本部署連結:

    Azure模板部署連結。

  2. 在 資源群組 列表中,選取 vaultrotation。

  3. 在 儲存帳號 RG 中,輸入儲存帳號所在的資源群組名稱。 如果儲存帳號和輪換功能在同一資源群組,就保留預設 [resourceGroup().name] 值。

  4. 在 儲存帳號名稱中,輸入你想輪換的存取金鑰的儲存帳號名稱。

  5. 在 金鑰保存庫 RG 中,輸入該 key vault 所在的資源群組名稱。 如果金鑰保險庫和輪換函式在同一資源群組,就保留預設 [resourceGroup().name] 值。

  6. 在 金鑰保存庫 名稱中,輸入 key vault 名稱。

  7. 在 功能應用程式名稱中,輸入功能應用程式名稱。

  8. 在 Secret Name 中,輸入用來儲存存取金鑰的秘密名稱。

  9. 選擇 檢閱 + 創建。

  10. 選取 ,創建。

    顯示如何建立其他記憶體帳戶的螢幕快照。

將儲存帳戶存取金鑰添加到 金鑰保存庫 機密中

確認儲存體帳戶資源識別碼。 您可以在 屬性中找到 id 此值。

az storage account show -n vaultrotationstorage2

列出記憶體帳戶存取金鑰,以便取得 key2 值:

az storage account keys list -n vaultrotationstorage2

將祕密新增至金鑰保存庫,並將其有效期設為 60 天,且(為了示範)將到期日設為明天,以立即觸發輪替。 使用你為 key2Value 和 storageAccountResourceId 取得的值來執行此命令:

tomorrowDate=$(date -u -d "+1 day" +"%Y-%m-%dT%H:%M:%SZ")
az keyvault secret set --name storageKey2 --vault-name vaultrotation-kv --value <key2-value> --tags "CredentialId=key2" "ProviderAddress=<storage-account-resource-id>" "ValidityPeriodDays=60" --expires $tomorrowDate

使用此指令來取得秘密資訊:

az keyvault secret show --vault-name vaultrotation-kv --name storageKey2

請注意,CredentialId 已更新為可替代的 keyName,且 value 已重新生成。

此螢幕擷取畫面顯示第二個儲存體帳戶的 az keyvault secret show 命令的輸出。

擷取存取金鑰以比較值:

az storage account keys list -n vaultrotationstorage2

注意金鑰值與金鑰庫中的秘密相符:

顯示第二個記憶體帳戶之 A Z 記憶體帳戶金鑰清單命令輸出的螢幕快照。

停用祕密輪替

若要停用該祕密的輪換,請刪除該祕密的事件網格訂閱。 使用 Azure PowerShell Remove-AzEventGridSubscription Cmdlet 或 Azure CLI az eventgrid event-subscription delete 命令。

利用 AI 自訂其他服務的旋轉功能

這個教學示範了 Azure 儲存體帳戶的密鑰輪換功能,但你也可以將這個輪換功能應用於其他使用雙重憑證的 Azure 服務。 GitHub Copilot 可以協助你修改 PowerShell 的輪換函式程式碼,使其能與你的服務相容。

I'm using the Azure Key Vault dual-credential secret rotation tutorial for Storage accounts. Help me modify the PowerShell rotation function to work with Azure Cosmos DB instead. The function should:
1. Connect to Cosmos DB and regenerate the secondary key
2. Store the new key in Key Vault as a new secret version
3. Alternate between primary and secondary keys on each rotation
Show me the changes needed to the PowerShell function code, including the correct Cosmos DB PowerShell cmdlets.

GitHub Copilot 由 AI 驅動,因此意外與錯誤是有可能發生的。 欲了解更多資訊,請參閱 Copilot常見問題。

後續步驟