Avvio rapido: Impostare e recuperare una chiave da Azure Key Vault con Azure PowerShellQuickstart: Set and retrieve a key from Azure Key Vault using Azure PowerShell

In questa guida di avvio rapido viene creato un insieme di credenziali delle chiavi in Azure Key Vault con Azure PowerShell.In this quickstart, you create a key vault in Azure Key Vault with Azure PowerShell. Azure Key Vault è un servizio cloud che funziona come archivio protetto dei segreti.Azure Key Vault is a cloud service that works as a secure secrets store. È possibile archiviare in modo sicuro chiavi, password, certificati e altri segreti.You can securely store keys, passwords, certificates, and other secrets. Per altre informazioni su Key Vault, vedere la panoramica.For more information on Key Vault you may review the Overview. Azure PowerShell viene usato per creare e gestire le risorse di Azure con comandi o script.Azure PowerShell is used to create and manage Azure resources using commands or scripts. Successivamente verrà archiviata una chiave.Once that you have completed that, you will store a key.

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.If you don't have an Azure subscription, create a free account before you begin.

Usare Azure Cloud ShellUse Azure Cloud Shell

Azure Cloud Shell è un ambiente di shell interattivo ospitato in Azure e usato tramite il browser.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. È possibile usare Bash o PowerShell con Cloud Shell per usare i servizi di Azure.You can use either Bash or PowerShell with Cloud Shell to work with Azure services. È possibile usare i comandi preinstallati di Cloud Shell per eseguire il codice contenuto in questo articolo senza dover installare strumenti nell'ambiente locale.You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Per avviare Azure Cloud Shell:To start Azure Cloud Shell:

OpzioneOption Esempio/CollegamentoExample/Link
Selezionare Prova nell'angolo superiore destro di un blocco di codice.Select Try It in the upper-right corner of a code block. La selezione di Prova non comporta la copia automatica del codice in Cloud Shell.Selecting Try It doesn't automatically copy the code to Cloud Shell. Esempio di Prova per Azure Cloud Shell
Passare a https://shell.azure.com o selezionare il pulsante Avvia Cloud Shell per aprire Cloud Shell nel browser.Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. Avviare Cloud Shell in una nuova finestraLaunch Cloud Shell in a new window
Selezionare il pulsante Cloud Shell nella barra dei menu nell'angolo in alto a destra del portale di Azure.Select the Cloud Shell button on the menu bar at the upper right in the Azure portal. Pulsante Cloud Shell nel portale di Azure

Per eseguire il codice di questo articolo in Azure Cloud Shell:To run the code in this article in Azure Cloud Shell:

  1. Avviare Cloud Shell.Start Cloud Shell.

  2. Selezionare il pulsante Copia in un blocco di codice per copiare il codice.Select the Copy button on a code block to copy the code.

  3. Incollare il codice nella sessione di Cloud Shell premendo CTRL+MAIUSC+V in Windows e Linux o CMD+MAIUSC+V in macOS.Paste the code into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux or by selecting Cmd+Shift+V on macOS.

  4. Premere INVIO per eseguire il codice.Select Enter to run the code.

Se si sceglie di installare e usare PowerShell in locale, per questa esercitazione è necessario il modulo Azure PowerShell 1.0.0 o versione successiva.If you choose to install and use PowerShell locally, this tutorial requires Azure PowerShell module version 1.0.0 or later. Digitare $PSVersionTable.PSVersion per trovare la versione.Type $PSVersionTable.PSVersion to find the version. Se è necessario eseguire l'aggiornamento, vedere Installare e configurare Azure PowerShell.If you need to upgrade, see Install Azure PowerShell module. Se si esegue PowerShell in locale, è anche necessario eseguire Login-AzAccount per creare una connessione con Azure.If you are running PowerShell locally, you also need to run Login-AzAccount to create a connection with Azure.

Login-AzAccount

Creare un gruppo di risorseCreate a resource group

Creare un gruppo di risorse di Azure con New-AzResourceGroup.Create an Azure resource group with New-AzResourceGroup. Un gruppo di risorse è un contenitore logico in cui le risorse di Azure vengono distribuite e gestite.A resource group is a logical container into which Azure resources are deployed and managed.

New-AzResourceGroup -Name ContosoResourceGroup -Location EastUS

Creare un insieme di credenziali delle chiaviCreate a Key Vault

Creata quindi un'istanza di Key Vault.Next you create a Key Vault. Per questo passaggio sono necessarie alcune informazioni:When doing this step, you need some information:

Anche se si usa "Contoso KeyVault2" come nome dell'istanza di Key Vault in questa guida di avvio rapido, è necessario usare un nome univoco.Although we use "Contoso KeyVault2" as the name for our Key Vault throughout this quickstart, you must use a unique name.

  • Nome dell'insieme di credenziali Contoso-Vault2.Vault name Contoso-Vault2.
  • Nome del gruppo di risorse ContosoResourceGroup.Resource group name ContosoResourceGroup.
  • Posizione: Stati Uniti orientali.Location East US.
New-AzKeyVault -Name 'Contoso-Vault2' -ResourceGroupName 'ContosoResourceGroup' -Location 'East US'

L'output di questo cmdlet mostra le proprietà dell'istanza di Key Vault appena creata.The output of this cmdlet shows properties of the newly created key vault. Prendere nota delle due proprietà elencate di seguito:Take note of the two properties listed below:

  • Vault Name: nell'esempio corrisponde a Contoso-Vault2.Vault Name: In the example that is Contoso-Vault2. Questo nome verrà usato per altri cmdlet di insieme di credenziali delle chiavi.You will use this name for other Key Vault cmdlets.
  • Vault URI (URI dell'insieme di credenziali): in questo esempio corrisponde a https://Contoso-Vault2.vault.azure.net/.Vault URI: In this example that is https://Contoso-Vault2.vault.azure.net/. Le applicazioni che usano l'insieme di credenziali tramite l'API REST devono usare questo URI.Applications that use your vault through its REST API must use this URI.

Dopo aver creato l'insieme di credenziali, l'account Azure è l'unico autorizzato a eseguire qualsiasi operazione su questo nuovo insieme di credenziali.After vault creation your Azure account is the only account allowed to do anything on this new vault.

Aggiungere una chiave a Key VaultAdd a key to Key Vault

Per aggiungere una chiave a Key Vault, sono sufficienti un paio di passaggi aggiuntivi.To add a key to the vault, you just need to take a couple of additional steps. Questa chiave può essere usata da un'applicazione.This key could be used by an application.

Digitare i comandi seguenti per creare una chiave denominata ExampleKey:Type the commands below to create a called ExampleKey :

Add-AzKeyVaultKey -VaultName 'Contoso-Vault2' -Name 'ExampleKey' -Destination 'Software'

È ora possibile fare riferimento a questa chiave aggiunta ad Azure Key Vault usando il relativo URI.You can now reference this key that you added to Azure Key Vault by using its URI. Usare https://Contoso-Vault2.vault.azure.net/keys/ExampleKey per ottenere la versione corrente.Use https://Contoso-Vault2.vault.azure.net/keys/ExampleKey to get the current version.

Per visualizzare la chiave archiviata in precedenza:To view previously stored key:

Get-AzKeyVaultKey -VaultName 'Contoso-Vault2' -KeyName 'ExampleKey'

A questo punto è stata creata un'istanza di Key Vault nella quale è stata archiviata e recuperata una chiave.Now, you have created a Key Vault, stored a key, and retrieved it.

Pulire le risorseClean up resources

Altre guide introduttive ed esercitazioni della raccolta si basano su questa.Other quickstarts and tutorials in this collection build upon this quickstart. Se si prevede di usare le guide di avvio rapido e le esercitazioni successive, è consigliabile non cancellare le risorse create.If you plan to continue on to work with subsequent quickstarts and tutorials, you may wish to leave these resources in place. Quando non servono più, è possibile usare il comando Remove-AzResourceGroup per rimuovere il gruppo di risorse e tutte le risorse correlate.When no longer needed, you can use the Remove-AzResourceGroup command to remove the resource group, and all related resources. È possibile eliminare le risorse in questo modo:You can delete the resources as follows:

Remove-AzResourceGroup -Name ContosoResourceGroup

Passaggi successiviNext steps

In questa guida di avvio rapido è stata creata un'istanza di Key Vault in cui è stato archiviato un certificato.In this quickstart you created a Key Vault and stored a certificate in it. Per altre informazioni sul servizio Key Vault e su come integrarlo nelle applicazioni, continuare con gli articoli seguenti.To learn more about Key Vault and how to integrate it with your applications, continue on to the articles below.