快速入門:使用 Azure CLI 從 Azure Key Vault 設定及擷取祕密

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

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

必要條件

  • Azure Cloud Shell中使用 Bash 環境。

    在新視窗中啟動 Cloud Shell

  • 如果想要,請安裝 Azure CLI 以執行 CLI 參考命令。

    • 如果您使用的是本機安裝,請使用 az login 命令,透過 Azure CLI 來登入。 請遵循您終端機上顯示的步驟,完成驗證程序。 如需其他登入選項,請參閱使用 Azure CLI 登入

    • 出現提示時,請在第一次使用時安裝 Azure CLI 擴充功能。 如需擴充功能詳細資訊,請參閱使用 Azure CLI 擴充功能

    • 執行 az version 以尋找已安裝的版本和相依程式庫。 若要升級至最新版本,請執行 az upgrade

本快速入門需要 2.0.4 版或更新版本的 Azure CLI。 如果您是使用 Azure Cloud Shell,就已安裝最新版本。

建立資源群組

資源群組是在其中部署與管理 Azure 資源的邏輯容器。 使用 az group create命令,在 eastus 位置建立名為 myResourceGroup 的資源群組。

az group create --name "myResourceGroup" -l "EastUS"

建立金鑰保存庫

使用 Azure CLI az keyvault create 命令,在上一個步驟的資源群組中建立 Key Vault。 您必須提供一些資訊:

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

    重要

    每個金鑰保存庫必須有唯一的名稱。 在下列範例中,以您的金鑰保存庫名稱取代 。

  • 資源群組名稱:myResourceGroup

  • 位置:EastUS

az keyvault create --name "<your-unique-keyvault-name>" --resource-group "myResourceGroup" --location "EastUS"

此命令的輸出會顯示新建立之金鑰保存庫的屬性。 請記下下列兩個屬性:

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

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

將祕密新增至 Key Vault

若要將祕密新增至保存庫,您只需要採取一些額外步驟。 應用程式可以使用此密碼。 此密碼會稱為 ExamplePassword,且其中會儲存 hVFkk965BuUv 值。

使用下方的 Azure CLI az keyvault secret set 命令,在稱為 >examplepassword 的 Key Vault 中建立秘密,以儲存 hVFkk965BuUv 的值:

az keyvault secret set --vault-name "<your-unique-keyvault-name>" --name "ExamplePassword" --value "hVFkk965BuUv"

從 Key Vault 擷取祕密

透過使用其 URI,您現在可以參照您新增至 Azure Key Vault 的密碼。 使用 ' HTTPs://<您的-唯一-keyvault-name>. vault.azure.net/secrets/ExamplePassword ' 取得目前的版本。

若要以純文字形式來查看秘密中包含的值,請使用 Azure CLI az keyvault secret show 命令:

az keyvault secret show --name "ExamplePassword" --vault-name "<your-unique-keyvault-name>" --query "value"

現在,您已建立 Key Vault,儲存祕密,並擷取它。

清除資源

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

若不再需要,您可以使用 Azure CLI az group delete 命令來移除資源群組和所有相關資源:

az group delete --name "myResourceGroup"

後續步驟

在本快速入門中,您已建立 Key Vault 並在其中儲存祕密。 若要深入了解 Key Vault 以及要如何將其與應用程式整合,請繼續閱讀下列文章。