Azure Key Vault .NET 2.0 - Catatan Rilis dan Panduan Migrasi

Informasi berikut membantu migrasi ke versi 2.0 dari pustaka Azure Key Vault untuk C# dan .NET. Aplikasi yang ditulis untuk versi sebelumnya perlu diperbarui untuk mendukung versi terbaru. Perubahan ini diperlukan untuk sepenuhnya mendukung fitur baru dan yang disempurnakan, seperti sertifikat Key Vault.

Sertifikat Key Vault

Sertifikat Key Vault mengelola sertifikat x509 dan mendukung perilaku berikut:

  • Membuat sertifikat melalui proses pembuatan Key Vault atau mengimpor sertifikat yang ada. Ini termasuk sertifikat yang ditandatangani sendiri dan Otoritas Sertifikat (CA).
  • Simpan dan kelola penyimpanan sertifikat x509 dengan aman tanpa interaksi menggunakan materi kunci privat.
  • Tentukan kebijakan yang mengarahkan Key Vault untuk mengelola siklus hidup sertifikat.
  • Berikan informasi kontak untuk peristiwa siklus hidup, seperti peringatan kedaluwarsa dan pemberitahuan perpanjangan.
  • Memperbarui sertifikat secara otomatis dengan pengeluar sertifikat terpilih (mitra Key Vault X509 penyedia sertifikat dan otoritas sertifikat).* Sertifikat dukungan dari alternatif (non-mitra) memberikan dan otoritas sertifikat (tidak mendukung perpanjangan otomatis).

Dukungan .NET

  • .NET 4.0 tidak didukung oleh versi 2.0 dari pustaka Azure Key Vault .NET
  • .NET Framework 4.5.2 tidak didukung oleh versi 2.0 dari pustaka Azure Key Vault .NET
  • Standar .NET 1.4 tidak didukung oleh versi 2.0 dari pustaka Azure Key Vault .NET

Namaspace

  • Namespace layanan untuk model diubah dari Microsoft.Azure.KeyVault menjadi Microsoft.Azure.KeyVault.Models.

  • Namespace layanan Microsoft.Azure.KeyVault.Internal dihilangkan.

  • Namespace layanan dependensi Azure SDK berikut ini memiliki

    • Hyak.Common sekarang Microsoft.Rest.
    • Hyak.Common.Internals sekarang Microsoft.Rest.Serialization.

Perubahan jenis

  • Rahasia diubah menjadi SecretBundle
  • Kamus diubah menjadi IDictionary
  • Daftar <T>, string [] diubah menjadi IList <T>
  • NextList diubah ke NextPageLink

Jenis yang dikembalikan

  • KeyList dan SecretList sekarang mengembalikan IPage, <T> bukan ListKeysResponseMessage
  • BackupKeyAsync yang dihasilkan sekarang mengembalikan BackupKeyResult, yang berisi Nilai (blob cadangan). Sebelumnya, metode ini dibungkus dan dikembalikan hanya nilainya.

Pengecualian

  • KeyVaultClientException diubah menjadi KeyVaultErrorException
  • Kesalahan layanan berubah dari exception.Error pada exceptoion.Body.Error.Message.
  • Menghapus info tambahan dari pesan kesalahan untuk [JsonExtensionData] .

Konstruktor

  • Alih-alih menerima HttpClient sebagai argumen konstruktor, konstruktor hanya menerima HttpClientHandler atau DelegatingHandler[] .

Paket yang diunduh

Saat klien memproses dependensi Key Vault, paket berikut diunduh:

Daftar paket sebelumnya

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

Daftar paket saat ini

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

Perubahan kelas

  • Kelas UnixEpoch telah dihapus.
  • Kelas Base64UrlConverter diubah namanya menjadi Base64UrlJsonConverter.

Perubahan lain

  • Dukungan untuk konfigurasi operasi KV mencoba kembali kebijakan tentang kegagalan sementara telah ditambahkan ke versi API ini.

Microsoft.Azure.Manajemen.KeyVault NuGet

  • Untuk operasi yang mengembalikan vault, jenis pengembalian adalah kelas yang berisi properti Vault. Jenis hasil sekarang Vault.
  • PermissionsToKeys dan PermissionsToSecrets sekarang menjadi Permissions.Keys dan Permissions.Secrets
  • Perubahan jenis hasil tertentu juga berlaku untuk pesawat kontrol.

Microsoft.Azure.KeyVault.Ekstensi NuGet

  • Paket dipecah menjadi Microsoft.Azure.KeyVault.Extensions dan Microsoft.Azure.KeyVault.Cryptography untuk operasi kriptografi.