|
| 1 | +# Release Notes |
| 2 | + |
| 3 | +## General Availability of Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProvider |
| 4 | +_**1.2.0 released 01 December 2020**_ |
| 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 | + |
| 10 | +- Added support for .NET Standard 2.0. This requires Microsoft.Data.SqlClient v2.1.0 and above. [#823](https://github.com/dotnet/SqlClient/pull/823) |
| 11 | +- Added new HSM endpoints. [#750](https://github.com/dotnet/SqlClient/pull/750) |
| 12 | +- Added source linked PDBs for easier debugging of the package. [#789](https://github.com/dotnet/SqlClient/pull/789) |
| 13 | + |
| 14 | +### Working with SQLColumnEncryptionAzureKeyVaultProvider |
| 15 | +`SqlColumnEncryptionAzureKeyVaultProvider` is implemented against `Microsoft.Data.SqlClient` and supports .NET Framework 4.6+, .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 call the `SqlConnection.RegisterColumnEncryptionKeyStoreProviders()` API once in the lifetime of the driver to register this custom provider by implementing a custom Authentication Callback mechanism. |
| 16 | + |
| 17 | +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. |
| 18 | + |
| 19 | +A sample C# application to demonstrate Always Encrypted with Azure Key Vault can be download from the samples directory: [AzureKeyVaultProviderExample.cs](https://github.com/dotnet/SqlClient/blob/master/doc/samples/AzureKeyVaultProviderExample.cs) |
| 20 | + |
| 21 | +## Target Platform Support |
| 22 | + |
| 23 | +- .NET Framework 4.6+ |
| 24 | +- .NET Core 2.1+ (Windows x86, Windows x64, Linux, macOS) |
| 25 | +- .NET Standard 2.0+ |
| 26 | + |
| 27 | +### Dependencies |
| 28 | + |
| 29 | +#### .NET Framework |
| 30 | + |
| 31 | +- Microsoft.Azure.KeyVault 3.0.4 |
| 32 | +- Microsoft.Azure.KeyVault.WebKey 3.0.4 |
| 33 | +- Microsoft.Data.SqlClient 1.0.19269.1 |
| 34 | +- Microsoft.Rest.ClientRuntime 2.3.20 |
| 35 | +- Microsoft.Rest.ClientRuntime.Azure 3.3.19 |
| 36 | + |
| 37 | +#### .NET Core |
| 38 | + |
| 39 | +- Microsoft.Azure.KeyVault 3.0.4 |
| 40 | +- Microsoft.Azure.KeyVault.WebKey 3.0.4 |
| 41 | +- Microsoft.Data.SqlClient 1.0.19269.1 |
| 42 | +- Microsoft.Rest.ClientRuntime 2.3.20 |
| 43 | +- Microsoft.Rest.ClientRuntime.Azure 3.3.19 |
| 44 | + |
| 45 | +#### .NET Standard |
| 46 | + |
| 47 | +- Microsoft.Azure.KeyVault 3.0.4 |
| 48 | +- Microsoft.Azure.KeyVault.WebKey 3.0.4 |
| 49 | +- Microsoft.Data.SqlClient 2.1.0 |
| 50 | +- Microsoft.Rest.ClientRuntime 2.3.20 |
| 51 | +- Microsoft.Rest.ClientRuntime.Azure 3.3.19 |
0 commit comments