共用方式為

快速入門：使用 Azure PowerShell 從 Azure Key Vault 設定及擷取金鑰

  • 發行項

在本快速入門中，您會在 Azure Key Vault 中使用 Azure PowerShell 建立金鑰保存庫。 Azure Key Vault 是一項雲端服務，可作為安全的祕密存放區。 您也可以安全地儲存金鑰、密碼、憑證和其他祕密。 如需 Key Vault 的詳細資訊，您可以檢閱概觀。 Azure PowerShell 可供使用命令列或指令碼來建立和管理 Azure 資源。 完成後，就能儲存金鑰。

必要條件

如果您沒有 Azure 訂用帳戶，請在開始前建立免費帳戶。

建立資源群組

資源群組是在其中部署與管理 Azure 資源的邏輯容器。 使用 Azure PowerShell New-AzResourceGroup Cmdlet，在 eastus 位置中建立名為 myResourceGroup 的資源群組。

New-AzResourceGroup -Name "myResourceGroup" -Location "EastUS"

建立金鑰保存庫

使用 Azure PowerShell New-AzKeyVault Cmdlet，在上一個步驟的資源群組中建立 Key Vault。 您需要提供一些資訊：

  • 金鑰保存庫名稱：由 3 到 24 個字元組成的字串，只能包含數字 (0-9)、字母 (a-z、A-Z) 和連字號 (-)

    重要

    每個金鑰保存庫必須有唯一的名稱。 在下列範例中，將 <your-unique-keyvault-name> 取代為您的金鑰保存庫名稱。

  • 資源群組名稱：myResourceGroup。

  • 位置：EastUS。

New-AzKeyVault -Name "<your-unique-keyvault-name>" -ResourceGroupName "myResourceGroup" -Location "EastUS"

此 Cmdlet 的輸出會顯示新建立金鑰保存庫的屬性。 記下這兩個屬性：

  • 保存庫名稱：您提供給 -Name 參數的名稱。
  • 保存庫 URI：在此範例中，URI 為 https://<your-unique-keyvault-name>.vault.azure.net/。 透過其 REST API 使用保存庫的應用程式必須使用此 URI。

此時，您的 Azure 帳戶是唯一獲得授權在此新保存庫上執行任何作業的帳戶。

在 金鑰保存庫 中授與用戶帳戶管理密鑰的許可權

若要透過角色型存取控制 (RBAC) 取得金鑰保存庫的權限，請使用 Azure PowerShell cmdlet New-AzRoleAssignment 將角色指派給「使用者主體名稱」(UPN)。

New-AzRoleAssignment -SignInName "<upn>" -RoleDefinitionName "Key Vault Crypto Officer" -Scope "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.KeyVault/vaults/<your-unique-keyvault-name>"

以實際值取代 <upn>、<subscription-id>、<resource-group-name> 和 <your-unique-keyvault-name>。 您 UPN 的格式通常是電子郵件地址 (例如，username@domain.com)。

將金鑰新增到 Key Vault

若要在保存庫中新增金鑰，您只需要另外進行幾個步驟。 此金鑰可供應用程式使用。

輸入這個命令以建立 ExampleKey：

Add-AzKeyVaultKey -VaultName "<your-unique-keyvault-name>" -Name "ExampleKey" -Destination "Software"

透過使用這個金鑰的 URI，您現在可以參照您新增至 Azure Key Vault 的這個金鑰。 使用 https://<your-unique-keyvault-name>.vault.azure.net/keys/ExampleKey 來取得最新版本。

若要檢視先前儲存的金鑰：

Get-AzKeyVaultKey -VaultName "<your-unique-keyvault-name>" -KeyName "ExampleKey"

您已建立了 Key Vault、儲存並擷取了金鑰。

清除資源

此集合中的其他快速入門和教學課程會以本快速入門為基礎。 如果您打算繼續進行其他快速入門和教學課程，您可以讓這些資源留在原處。

當不再需要時，您可以使用 Azure PowerShell Remove-AzResourceGroup Cmdlet 來移除資源群組和所有相關資源。

Remove-AzResourceGroup -Name "myResourceGroup"

下一步

在本快速入門中，您已建立 Key Vault 並在其中儲存憑證。 若要深入了解 Key Vault，以及如何與應用程式整合的詳細資訊，請繼續閱讀以下文章。