Azure Key Vault .NET 2.0 - Sürüm Notları ve Geçiş Kılavuzu

  • Makale

Aşağıdaki bilgiler C# ve .NET için Azure Key Vault kitaplığının 2.0 sürümüne geçişe yardımcı olur. Önceki sürümler için yazılmış uygulamaların en son sürümü desteklemek için güncelleştirilmesi gerekir. Bu değişiklikler, Key Vault sertifikaları gibi yeni ve geliştirilmiş özellikleri tam olarak desteklemek için gereklidir.

sertifikaları Key Vault

Key Vault sertifikaları x509 sertifikalarını yönetir ve aşağıdaki davranışları destekler:

  • Key Vault oluşturma işlemi aracılığıyla sertifikalar oluşturun veya var olan sertifikayı içeri aktarabilirsiniz. Bu, hem otomatik olarak imzalanan hem de Sertifika Yetkilisi (CA) tarafından oluşturulan sertifikaları içerir.
  • X509 sertifika depolama alanını özel anahtar malzemelerini kullanarak etkileşim kurmadan güvenli bir şekilde depolayın ve yönetin.
  • Sertifika yaşam döngüsünü yönetmek için Key Vault yönlendiren ilkeler tanımlayın.
  • Yaşam döngüsü olayları için süre sonu uyarıları ve yenileme bildirimleri gibi iletişim bilgilerini sağlayın.
  • Seçili verenlerle sertifikaları otomatik olarak yenileyin (Key Vault iş ortağı X509 sertifika sağlayıcıları ve sertifika yetkilileri).* Diğer sertifikalardan (iş ortağı olmayan) sertifikayı destekler ve sertifika yetkililerini sağlar (otomatik yenilemeyi desteklemez).

.NET desteği

  • .NET 4.0, Azure Key Vault .NET kitaplığının 2.0 sürümü tarafından desteklenmiyor
  • .NET Framework 4.5.2, Azure Key Vault .NET kitaplığının 2.0 sürümü tarafından desteklenir
  • .NET Standard 1.4, Azure Key Vault .NET kitaplığının 2.0 sürümü tarafından desteklenir

Ad alanları

  • Modellerin ad alanı Microsoft.Azure.KeyVault'tanMicrosoft.Azure.KeyVault.Models olarak değiştirilir.

  • Microsoft.Azure.KeyVault.Internal ad alanı bırakılır.

  • Aşağıdaki Azure SDK bağımlılıkları ad alanlarının

    • Hyak.Common artık Microsoft.Rest'tir.
    • Hyak.Common.Internals artık Microsoft.Rest.Serialization'dır.

Tür değişiklikleri

  • Gizli diziSecretBundle olarak değiştirildi
  • Sözlük IDictionary olarak değiştirildi
  • Liste< T>, dize []IList<T> olarak değiştirildi
  • NextList, NextPageLink olarak değiştirildi

Dönüş türleri

  • KeyList ve SecretList artık ListKeysResponseMessage yerine IPage<T> döndürür
  • Oluşturulan BackupKeyAsync artık Value (yedekleme blobu) içeren BackupKeyResult değerini döndürür. Daha önce yöntemi sarmalandı ve yalnızca değeri döndürdü.

Özel durumlar

  • KeyVaultClientException, KeyVaultErrorException olarak değiştirildi
  • Hizmet hatası özel durumdan değiştirildi. Özel durum hatası. Body.Error.Message.
  • [JsonExtensionData] hata iletisinden ek bilgiler kaldırıldı.

Oluşturucular

  • Oluşturucu bağımsız değişkeni olarak bir HttpClient kabul etmek yerine, oluşturucu yalnızca HttpClientHandler veya DelegatingHandler[] kabul eder.

İndirilen paketler

İstemci bir Key Vault bağımlılığı işlediğinde aşağıdaki paketler indirilir:

Önceki paket listesi

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

Geçerli paket listesi

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

Sınıf değişiklikleri

  • UnixEpoch sınıfı kaldırıldı.
  • Base64UrlConverter sınıfı Base64UrlJsonConverter olarak yeniden adlandırıldı.

Diğer değişiklikler

  • Geçici hatalarda KV işlemi yeniden deneme ilkesini yapılandırma desteği API'nin bu sürümüne eklendi.

Microsoft.Azure.Management.KeyVault NuGet

  • Kasa döndüren işlemler için dönüş türü,Vault özelliğini içeren bir sınıftı. Dönüş türü artık Vault'tur.
  • PermissionsToKeys ve PermissionsToSecrets artık Permissions.Keys ve Permissions.Secrets şeklindedir
  • Belirli dönüş türleri değişiklikleri kontrol düzlemi için de geçerlidir.

Microsoft.Azure.KeyVault.Extensions NuGet

  • Paket, şifreleme işlemleri için Microsoft.Azure.KeyVault.Extensions ve Microsoft.Azure.KeyVault.Cryptography'ye ayrılmıştır.