Udostępnij za pośrednictwem

Azure Key Vault .NET 2.0 — informacje o wersji i przewodnik migracji

Poniższe informacje ułatwiają migrację do wersji 2.0 biblioteki usługi Azure Key Vault dla języków C# i .NET. Aplikacje napisane dla wcześniejszych wersji muszą być aktualizowane, aby obsługiwać najnowszą wersję. Te zmiany są potrzebne do pełnej obsługi nowych i ulepszonych funkcji, takich jak certyfikaty usługi Key Vault.

Certyfikaty usługi Key Vault

Certyfikaty usługi Key Vault zarządzają certyfikatami x509 i obsługują następujące zachowania:

  • Utwórz certyfikaty za pomocą procesu tworzenia usługi Key Vault lub zaimportuj istniejący certyfikat, w tym zarówno certyfikaty z podpisem własnym, jak i wygenerowany przez urząd certyfikacji.
  • Bezpieczne przechowywanie i zarządzanie magazynem certyfikatów x509 bez interakcji przy użyciu materiału klucza prywatnego.
  • Zdefiniuj zasady, które kierują usługę Key Vault do zarządzania cyklem życia certyfikatu.
  • Podaj informacje kontaktowe dotyczące zdarzeń cyklu życia, takich jak ostrzeżenia o wygaśnięciu i powiadomienia o odnowieniu.
  • Automatyczne odnawianie certyfikatów z wybranymi wystawcami certyfikatów (partnerzy dostawcy certyfikatów X509 i urzędów certyfikacji Key Vault). Wsparcie dla certyfikatów od alternatywnych (niepartnerskich) dostawców i urzędów certyfikacji (nie obsługuje automatycznego odnawiania).

Obsługa platformy .NET

  • Platforma .NET 4.0 nie jest obsługiwana przez wersję 2.0 biblioteki .NET usługi Azure Key Vault
  • Program .NET Framework 4.5.2 jest obsługiwany przez wersję 2.0 biblioteki .NET usługi Azure Key Vault
  • Program .NET Standard 1.4 jest obsługiwany przez wersję 2.0 biblioteki .NET usługi Azure Key Vault

Przestrzenie nazw

  • Przestrzeń nazw modeli została zmieniona z Microsoft.Azure.KeyVault na Microsoft.Azure.KeyVault.Models.

  • Usunięto przestrzeń nazw Microsoft.Azure.KeyVault.Internal.

  • Następujące przestrzenie nazw zależności zestawu Azure SDK mają

    • Hyak.Common to teraz Microsoft.Rest.
    • Hyak.Common.Internals jest teraz Microsoft.Rest.Serialization.

Zmiany typu

  • Tajne zostało zmienione na SecretBundle
  • Słownik został zmieniony na IDictionary
  • Lista<T>, ciąg [] został zmieniony na IList<T>
  • NextList została zmieniona na NextPageLink

Typy zwracane

  • KeyList i SecretList zwracają teraz IPage<T> zamiast ListKeysResponseMessage
  • Wygenerowana BackupKeyAsync zwraca teraz BackupKeyResult, która zawiera Value (kopię zapasową obiektu blob). Wcześniej metoda była opakowana i zwracała jedynie wartość.

Wyjątki

  • KeyVaultClientException został zmieniony na KeyVaultErrorException
  • Błąd usługi zmienił się z exception.Error na exception.Body.Error.Message.
  • Usunięto dodatkowe informacje z komunikatu o błędzie [JsonExtensionData].

Konstruktory

  • Zamiast akceptować obiekt HttpClient jako argument konstruktora, konstruktor akceptuje tylko metodę HttpClientHandler lub DelegatingHandler[].

Pobrane pakiety

Gdy klient przetwarza zależność usługi Key Vault, pobierane są następujące pakiety:

Poprzednia lista pakietów

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

Bieżąca lista pakietów

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

Zmiany klas

  • Klasa UnixEpoch jest usuwana.
  • Nazwa klasy Base64UrlConverter została zmieniona na Base64UrlJsonConverter.

Inne zmiany

  • Obsługa konfiguracji zasad ponawiania prób operacji KV w przypadku przejściowych błędów jest dodawana do tej wersji interfejsu API.

Microsoft.Azure.Management.KeyVault NuGet

  • W przypadku operacji, które zwróciły magazyn, zwracany typ był klasą zawierającą właściwość Vault . Zwracany typ to teraz Vault.
  • PermissionsToKeys i PermissionsToSecrets są teraz Permissions.Keys i Permissions.Secrets
  • Niektóre zmiany typów zwracanych mają zastosowanie również do płaszczyzny sterowania.

Microsoft.Azure.KeyVault.Extensions NuGet

  • Pakiet jest podzielony na microsoft.Azure.KeyVault.Extensions i Microsoft.Azure.KeyVault.Cryptography dla operacji kryptograficznych.