|
| 1 | +# Release Notes |
| 2 | + |
| 3 | +## General Availability of Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProvider |
| 4 | +_**2.0.0 released 03 March 2021**_ |
| 5 | + |
| 6 | +This library contains the implementation of `Microsoft.Data.SqlClient.SqlColumnEncryptionKeyStoreProvider` for accessing Azure Key Vault, and the provider class is named `SqlColumnEncryptionAzureKeyVaultProvider`. |
| 7 | + |
| 8 | +### Added |
| 9 | +- Upgraded Azure Key Vault Provider to use new Azure Key Vault libraries [#630](https://github.com/dotnet/SqlClient/pull/630) |
| 10 | + |
| 11 | +### Breaking Changes |
| 12 | +- Drops support for .NET Framework 4.6. The new minimum supported .NET Framework version is v4.6.1 [#630](https://github.com/dotnet/SqlClient/pull/630) |
| 13 | +- Updated dependency of Microsoft.Data.SqlClient on .NET Framework and .NET Core to LTS stable version v1.1.3+ [#946](https://github.com/dotnet/SqlClient/pull/946) |
| 14 | + |
| 15 | + |
| 16 | +### Working with SQLColumnEncryptionAzureKeyVaultProvider |
| 17 | +`SqlColumnEncryptionAzureKeyVaultProvider` is implemented against `Microsoft.Data.SqlClient` and supports .NET Framework 4.6.1+, .NET Core 2.1+, and .NET Standard 2.0+. The provider name identifier for this library is "**AZURE_KEY_VAULT**" and it is not registered in the driver by default. Client applications may now initialize this provider by providing an instance of `Azure.Core.TokenCredential` implementation and register it with the driver. |
| 18 | + |
| 19 | +Once the provider is registered, it can be used to perform Always Encrypted operations by creating a Column Master Key using the Azure Key Vault Key Identifier URL. |
| 20 | + |
| 21 | +The linked C# samples below demonstrate using Always Encrypted with secure enclaves with Azure Key Vault: |
| 22 | +- Legacy API support (Always Encrypted): [AzureKeyVaultProviderExample.cs](https://github.com/dotnet/SqlClient/blob/master/doc/samples/AzureKeyVaultProviderLegacyExample_2_0.cs) |
| 23 | +- New API support (Always Encrypted): [AzureKeyVaultProviderExample.cs](https://github.com/dotnet/SqlClient/blob/master/doc/samples/AzureKeyVaultProviderExample_2_0.cs) |
| 24 | +- Legacy API support (Always Encrypted with secure enclaves): [AzureKeyVaultProviderExample.cs](https://github.com/dotnet/SqlClient/blob/master/doc/samples/doc\samples\AzureKeyVaultProviderWithEnclaveProviderExample.cs) |
| 25 | +- New API support (Always Encrypted with secure snclaves): [AzureKeyVaultProviderExample.cs](https://github.com/dotnet/SqlClient/blob/master/doc/samples/doc\samples\AzureKeyVaultProviderWithEnclaveProviderExample_2_0.cs) |
| 26 | + |
| 27 | + |
| 28 | +## Target Platform Support |
| 29 | + |
| 30 | +- .NET Framework 4.6.1+ |
| 31 | +- .NET Core 2.1+ (Windows x86, Windows x64, Linux, macOS) |
| 32 | +- .NET Standard 2.0+ |
| 33 | + |
| 34 | +### Dependencies |
| 35 | + |
| 36 | +#### .NET Framework |
| 37 | + |
| 38 | +- Azure.Core 1.2.2 |
| 39 | +- Azure.Security.KeyVault.Keys 4.0.3 |
| 40 | +- Microsoft.Data.SqlClient 1.1.3 |
| 41 | + |
| 42 | +#### .NET Core |
| 43 | + |
| 44 | +- Azure.Core 1.2.2 |
| 45 | +- Azure.Security.KeyVault.Keys 4.0.3 |
| 46 | +- Microsoft.Data.SqlClient 1.1.3 |
| 47 | + |
| 48 | +#### .NET Standard |
| 49 | + |
| 50 | +- Azure.Core 1.2.2 |
| 51 | +- Azure.Security.KeyVault.Keys 4.0.3 |
| 52 | +- Microsoft.Data.SqlClient 2.1.0 |
0 commit comments