Guida alla migrazione e note sulla versione .NET 2.0 per l'insieme di credenziali delle chiavi di AzureAzure Key Vault .NET 2.0 - Release Notes and Migration Guide

Le informazioni seguenti consentono la migrazione alla versione 2.0 della libreria di Azure Key Vault per C# e .NET.The following information helps migrating to the 2.0 version of the Azure Key Vault library for C# and .NET. È necessario che le app scritte per le versioni precedenti siano aggiornate per supportare la versione più recente.Apps written for earlier versions need to be updating to support the latest version. Queste modifiche sono necessarie per supportare completamente le funzionalità nuove e migliorate, come ad esempio i certificati Key Vault.These changes are needed to fully support new and improved features, such as Key Vault certificates.

Certificati Key VaultKey Vault certificates

I certificati Key Vault gestiscono i certificati x509 e supportano i comportamenti seguenti:Key Vault certificates manage x509 certificates and supports the following behaviors:

  • Creare dei certificati tramite un processo di creazione Key Vault o importare un certificato esistente.Create certificates through a Key Vault creation process or import existing certificate. Sono inclusi sia i certificati autofirmati che i certificati generati dall'autorità di certificazione.This includes both self-signed and Certificate Authority (CA) generated certificates.
  • Archiviare e gestire in modo sicuro l'archiviazione di certificati x509 senza alcuna interazione tramite materiale con chiave privata.Securely store and manage x509 certificate storage without interaction using private key material.
  • Definire i criteri necessari per l'insieme di credenziali chiave per la gestione del ciclo di vita dei certificati.Define policies that direct Key Vault to manage the certificate lifecycle.
  • Fornire informazioni di contatto per eventi inerenti il ciclo di vita, ad esempio avvisi di scadenza e notifiche di rinnovo.Provide contact information for lifecycle events, such as expiration warnings and renewal notifications.
  • Rinnovare automaticamente i certificati con autorità emittenti selezionate (provider di certificati X509 partner per Key Vault e autorità di certificazione).* Supportare certificati forniti da parti (non-partner) e autorità di certificazione altenrative (non supporta il rinnovo automatico).Automatically renew certificates with selected issuers (Key Vault partner X509 certificate providers and certificate authorities).* Support certificate from alternate (non-partner) provides and certificate authorities (does not support auto-renewal).

Supporto .NET.NET support

  • .NET 4.0 non è supportata dalla versione 2.0 della libreria .NET di Azure Key Vault.NET 4.0 is not supported by the 2.0 version of the Azure Key Vault .NET library
  • .NET Framework 4.5.2 non è supportata dalla versione 2.0 della libreria .NET di Azure Key Vault.NET Framework 4.5.2 is supported by the 2.0 version of the Azure Key Vault .NET library
  • .NET Standard 1.4 non è supportata dalla versione 2.0 della libreria .NET di Azure Key Vault.NET Standard 1.4 is supported by the 2.0 version of the Azure Key Vault .NET library

Spazi dei nomiNamespaces

  • Lo spazio dei nomi per i modelli viene cambiato da Microsoft.Azure.KeyVault a Microsoft.Azure.KeyVault.Models.The namespace for models is changed from Microsoft.Azure.KeyVault to Microsoft.Azure.KeyVault.Models.
  • Lo spazio dei nomi Microsoft.Azure.KeyVault.Internal viene rimosso.The Microsoft.Azure.KeyVault.Internal namespace is dropped.
  • Nello spazio dei nomi delle seguenti dipendenze SDK di AzureThe following Azure SDK dependencies namespaces have

    • Hyak.Common è ora Microsoft.Rest.Hyak.Common is now Microsoft.Rest.
    • Hyak.Common.Internals è ora Microsoft.Rest.Serialization.Hyak.Common.Internals is now Microsoft.Rest.Serialization.

Modifiche del tipoType changes

  • Secret modificato in SecretBundleSecret changed to SecretBundle
  • Dictionary modificato in IDictionaryDictionary changed to IDictionary
  • List, string [] modificato in IListList, string [] changed to IList
  • NextList modificato in NextPageLinkNextList changed to NextPageLink

Tipi restituitiReturn types

  • KeyList e SecretList restituiranno IPage anziché ListKeysResponseMessageKeyList and SecretList now returns IPage instead of ListKeysResponseMessage
  • L'oggetto BackupKeyAsync generato restituirà BackupKeyResult che contiene Valore (BLOB di backup).The generated BackupKeyAsync now returns BackupKeyResult, which contains Value (back-up blob). Prima veniva eseguito il wrapping del metodo e veniva restituito solo il valore.Previously, the method was wrapped and returned just the value.

EccezioniExceptions

  • KeyVaultClientException viene modificato in KeyVaultErrorExceptionKeyVaultClientException is changed to KeyVaultErrorException
  • L'errore del servizio è stato modificato da exception.Error in exception.Body.Error.Message.The service error changed from exception.Error to exception.Body.Error.Message.
  • Le informazioni aggiuntive sono rimosse dal messaggio di errore per [JsonExtensionData].Removed additional info from the error message for [JsonExtensionData].

CostruttoriConstructors

  • Invece di accettare HttpClient come argomento del costruttore, il costruttore accetta solo HttpClientHandler o DelegatingHandler[].Instead of accepting an HttpClient as a constructor argument, the constructor only accepts HttpClientHandler or DelegatingHandler[].

Pacchetti scaricatiDownloaded packages

Quando un client elabora una dipendenza Key Vault, vengono scaricati i pacchetti seguenti:When a client processes a Key Vault dependency, the following packages are downloaded:

Elenco dei pacchetti precedentiPrevious package list

  • package id="Hyak.Common" version="1.0.2" targetFramework="net45"
  • package id="Microsoft.Azure.Common" version="2.0.4" targetFramework="net45"
  • package id="Microsoft.Azure.Common.Dependencies" version="1.0.0" targetFramework="net45"
  • package id="Microsoft.Azure.KeyVault" version="1.0.0" targetFramework="net45"
  • package id="Microsoft.Bcl" version="1.1.9" targetFramework="net45"
  • package id="Microsoft.Bcl.Async" version="1.0.168" targetFramework="net45"
  • package id="Microsoft.Bcl.Build" version="1.0.14" targetFramework="net45"
  • package id="Microsoft.Net.Http" version="2.2.22" targetFramework="net45"

Elenco dei pacchetti correntiCurrent package list

  • package id="Microsoft.Azure.KeyVault" version="2.0.0-preview" targetFramework="net45"
  • package id="Microsoft.Rest.ClientRuntime" version="2.2.0" targetFramework="net45"
  • package id="Microsoft.Rest.ClientRuntime.Azure" version="3.2.0" targetFramework="net45"

Modifiche alle classiClass changes

  • La classe UnixEpoch è stata rimossa.UnixEpoch class has been removed.
  • La classe Base64UrlConverter viene rinominata Base64UrlJsonConverter.Base64UrlConverter class is renamed to Base64UrlJsonConverter.

Altre modificheOther changes

  • A questa versione dell'API è stato aggiunto il supporto per la configurazione dei criteri per i tentativi dell'operazione insieme di credenziali delle chiavi su errori temporanei.Support for the configuration of KV operation retry policy on transient failures has been added to this version of the API.

Microsoft.Azure.Management.KeyVault NuGetMicrosoft.Azure.Management.KeyVault NuGet

  • Per le operazioni che restituivano un insieme di credenziali, il tipo restituito era una classe che conteneva una proprietà Vault.For the operations that returned a vault, the return type was a class that contained a Vault property. Il tipo restituito è ora Vault.The return type is now Vault.
  • PermissionsToKeys e PermissionsToSecrets ora sono Permissions.Keys e Permissions.SecretsPermissionsToKeys and PermissionsToSecrets are now Permissions.Keys and Permissions.Secrets
  • Alcune delle modifiche che riguardano i tipi restituiti si applicano anche al piano di controllo.Certain return types changes apply to the control-plane as well.

Microsoft.Azure.KeyVault.Extensions NuGetMicrosoft.Azure.KeyVault.Extensions NuGet

  • Il pacchetto viene interrotto a Microsoft.Azure.KeyVault.Extensions e Microsoft.Azure.KeyVault.Cryptography per le operazioni di crittografia.The package is broken up to Microsoft.Azure.KeyVault.Extensions and Microsoft.Azure.KeyVault.Cryptography for the cryptography operations.