Azure Key Vault .NET 2.0 - Releaseopmerkingen en migratiehandleiding

  • Artikel

De volgende informatie helpt bij het migreren naar versie 2.0 van de Azure Key Vault-bibliotheek voor C# en .NET. Apps die zijn geschreven voor eerdere versies, moeten worden bijgewerkt om de nieuwste versie te ondersteunen. Deze wijzigingen zijn nodig om nieuwe en verbeterde functies, zoals Key Vault certificaten, volledig te ondersteunen.

Key Vault certificaten

Key Vault certificaten beheren x509-certificaten en ondersteunen het volgende gedrag:

  • Maak certificaten via een Key Vault maakproces of importeer een bestaand certificaat. Dit omvat zowel zelfondertekende als door certificeringsinstantie (CA) gegenereerde certificaten.
  • Veilig opslaan en beheren van x509-certificaatopslag zonder tussenkomst met behulp van persoonlijke-sleutelmateriaal.
  • Definieer beleidsregels die Key Vault om de levenscyclus van het certificaat te beheren.
  • Geef contactgegevens op voor levenscyclusevenementen, zoals verloopwaarschuwingen en verlengingsmeldingen.
  • Certificaten automatisch vernieuwen met geselecteerde verleners (Key Vault partner X509-certificaatproviders en certificeringsinstanties).* Ondersteuningscertificaat van alternatieve (niet-partner) biedt en certificeringsinstanties (biedt geen ondersteuning voor automatische verlenging).

.NET-ondersteuning

  • .NET 4.0 wordt niet ondersteund door versie 2.0 van de Azure Key Vault .NET-bibliotheek
  • .NET Framework 4.5.2 wordt ondersteund door de 2.0-versie van de Azure Key Vault .NET-bibliotheek
  • .NET Standard 1.4 wordt ondersteund door versie 2.0 van de Azure Key Vault .NET-bibliotheek

Naamruimten

  • De naamruimte voor modellen wordt gewijzigd van Microsoft.Azure.KeyVault in Microsoft.Azure.KeyVault.Models.

  • De naamruimte Microsoft.Azure.KeyVault.Internal wordt verwijderd.

  • De volgende naamruimten van Azure SDK-afhankelijkheden hebben

    • Hyak.Common is nu Microsoft.Rest.
    • Hyak.Common.Internals is nu Microsoft.Rest.Serialization.

Typewijzigingen

  • Geheim gewijzigd in SecretBundle
  • Woordenlijst gewijzigd in IDictionary
  • Lijst< T>, tekenreeks [] gewijzigd in IList<T>
  • NextList gewijzigd in NextPageLink

Retourtypen

  • KeyList en SecretList retourneren nu IPage<T> in plaats van ListKeysResponseMessage
  • De gegenereerde BackupKeyAsync retourneert nu BackupKeyResult, dat Value (back-up-blob) bevat. Voorheen werd de methode verpakt en alleen de waarde geretourneerd.

Uitzonderingen

  • KeyVaultClientException is gewijzigd in KeyVaultErrorException
  • De servicefout is gewijzigd ten opzichte van de uitzondering. Fout bij uitzondering. Body.Error.Message.
  • Aanvullende informatie uit het foutbericht voor [JsonExtensionData] is verwijderd.

Constructors

  • In plaats van een HttpClient als constructorargument te accepteren, accepteert de constructor alleen HttpClientHandler of DelegatingHandler[].

Gedownloade pakketten

Wanneer een client een Key Vault afhankelijkheid verwerkt, worden de volgende pakketten gedownload:

Vorige pakketlijst

  • 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"

Huidige pakketlijst

  • 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"

Klassewijzigingen

  • De klasse UnixEpoch is verwijderd.
  • De naam van de klasse Base64UrlConverter wordt gewijzigd in Base64UrlJsonConverter.

Andere wijzigingen

  • Ondersteuning voor de configuratie van het kv-beleid voor opnieuw proberen bij tijdelijke fouten is toegevoegd aan deze versie van de API.

Microsoft.Azure.Management.KeyVault NuGet

  • Voor de bewerkingen die een kluis hebben geretourneerd, was het retourtype een klasse die een kluiseigenschap bevatte. Het retourtype is nu Kluis.
  • PermissionsToKeys en PermissionsToSecrets zijn nu Permissions.Keys en Permissions.Secrets
  • Bepaalde wijzigingen in retourtypen zijn ook van toepassing op het besturingsvlak.

Microsoft.Azure.KeyVault.Extensions NuGet

  • Het pakket wordt opgesplitst in Microsoft.Azure.KeyVault.Extensions en Microsoft.Azure.KeyVault.Cryptography voor de cryptografiebewerkingen.