Skip to content

Commit 37e2561

Browse files
authored
Merge pull request #18732 from cheenamalhotra/sqlclient-212
Update ADO.NET documentations post release
2 parents ec56b93 + 4e863ea commit 37e2561

5 files changed

Lines changed: 64 additions & 21 deletions

docs/connect/ado-net/sql/azure-key-vault-enclave-example.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,24 +2,28 @@
22
description: "Example demonstrating use of Azure Key Vault provider with Always Encrypted enabled with secure enclaves"
33
title: "Example demonstrating use of Azure Key Vault provider with Always Encrypted enabled with secure enclaves | Microsoft Docs"
44
ms.custom: ""
5-
ms.date: 11/17/2020
6-
ms.reviewer: v-daenge
5+
ms.date: 03/03/2021
76
ms.prod: sql
87
ms.prod_service: connectivity
98
ms.technology: connectivity
109
ms.tgt_pltfrm: ""
1110
ms.topic: tutorial
12-
author: karinazhou
13-
ms.author: v-jizho2
11+
author: David-Engel
12+
ms.author: v-daenge
13+
ms.reviewer: v-jizho2
1414
---
1515

1616
# Example demonstrating use of Azure Key Vault provider with Always Encrypted enabled with secure enclaves
1717

1818
[!INCLUDE [sqlserver2019-windows-only-asdb](../../../includes/applies-to-version/sqlserver2019-windows-only-asdb.md)]
1919

20-
[!INCLUDE [appliesto-netfx-netcore-xxxx-md](../../../includes/appliesto-netfx-netcore-netst-md.md)]
20+
[!INCLUDE [appliesto-netfx-netcore-netst-md](../../../includes/appliesto-netfx-netcore-netst-md.md)]
2121

22-
This example demonstrates use of Azure Key Vault Provider when accessing encrypted columns.
22+
## AzureKeyVaultProvider v2.0+
23+
24+
[!code-csharp [Azure Key Vault Provider 2.0 with Enclave Example#1](~/../sqlclient/doc/samples/AzureKeyVaultProviderWithEnclaveProviderExample_2_0.cs#1)]
25+
26+
## AzureKeyVaultProvider v1.x
2327

2428
[!code-csharp [Azure Key Vault Provider with Enclave Example#1](~/../sqlclient/doc/samples/AzureKeyVaultProviderWithEnclaveProviderExample.cs#1)]
2529

docs/connect/ado-net/sql/azure-key-vault-example.md

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,26 +2,32 @@
22
description: "Example demonstrating use of Azure Key Vault provider with Always Encrypted"
33
title: "Example demonstrating use of Azure Key Vault provider with Always Encrypted | Microsoft Docs"
44
ms.custom: ""
5-
ms.date: 11/17/2020
6-
ms.reviewer: v-daenge
5+
ms.date: 03/03/2021
76
ms.prod: sql
87
ms.prod_service: connectivity
98
ms.technology: connectivity
109
ms.tgt_pltfrm: ""
1110
ms.topic: tutorial
12-
author: karinazhou
13-
ms.author: v-jizho2
11+
author: David-Engel
12+
ms.author: v-daenge
13+
ms.reviewer: v-jizho2
1414
---
1515

1616
# Example demonstrating use of Azure Key Vault provider with Always Encrypted
1717

1818
[!INCLUDE [sqlserver2019-windows-only](../../../includes/applies-to-version/sqlserver2019-windows-only.md)]
1919

20-
[!INCLUDE [appliesto-netfx-netcore-xxxx-md](../../../includes/appliesto-netfx-netcore-netst-md.md)]
20+
[!INCLUDE [appliesto-netfx-netcore-netst-md](../../../includes/appliesto-netfx-netcore-netst-md.md)]
2121

2222
This example demonstrates use of Azure Key Vault Provider when accessing encrypted columns.
2323

24-
[!code-csharp [AKVProvider Example#1](~/../sqlclient/doc/samples/AzureKeyVaultProviderExample.cs#1)]
24+
## AzureKeyVaultProvider v2.0+
25+
26+
[!code-csharp [Azure Key Vault Provider 2.0 Example#1](~/../sqlclient/doc/samples/AzureKeyVaultProviderExample_2_0.cs#1)]
27+
28+
## AzureKeyVaultProvider v1.x
29+
30+
[!code-csharp [Azure Key Vault Provider Example#1](~/../sqlclient/doc/samples/AzureKeyVaultProviderExample.cs#1)]
2531

2632
> [!NOTE]
2733
>

docs/connect/ado-net/sql/sqlclient-support-always-encrypted.md

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
---
22
title: "Using Always Encrypted with SqlClient"
33
description: "Learn how to develop applications using Microsoft.Data.SqlClient and Always Encrypted to keep your data secure."
4-
ms.date: 11/16/2020
4+
ms.date: 03/03/2021
55
ms.assetid:
66
ms.prod: sql
77
ms.prod_service: connectivity
88
ms.technology: connectivity
99
ms.topic: conceptual
10-
author: cheenamalhotra
11-
ms.author: v-chmalh
12-
ms.reviewer: v-daenge
10+
author: David-Engel
11+
ms.author: v-daenge
12+
ms.reviewer: v-jizho2
1313
---
1414

1515
# Using Always Encrypted with the Microsoft .NET Data Provider for SQL Server
@@ -324,6 +324,18 @@ Azure Key Vault is a convenient option to store and manage column master keys fo
324324
|:---|:---|:---|:---|
325325
|[SqlColumnEncryptionAzureKeyVaultProvider Class](/dotnet/api/microsoft.data.sqlclient.alwaysencrypted.azurekeyvaultprovider.sqlcolumnencryptionazurekeyvaultprovider) | Provider for Azure Key Vault. | AZURE_KEY_VAULT | Windows, Linux, macOS |
326326

327+
#### .NET Supportability
328+
329+
| Version | Microsoft.Data.SqlClient version | .NET platforms |
330+
| ------- | ----------- | ------- |
331+
| 2.0.0 | 1.1.3+ <br/> 2.1.0+ | .NET Framework 4.6.1+, .NET Core 2.1+ <br/>.NET Standard 2.0+ |
332+
| 1.2.0 | 1.0.19269.1+ <br/> 2.1.0+ | .NET Framework 4.6+, .NET Core 2.1+ <br/>.NET Standard 2.0+ |
333+
| 1.1.0 | 1.0.19269.1+ | .NET Framework 4.6+, .NET Core 2.1+ |
334+
| 1.0.0 | 1.0.19269.1+ | .NET Framework 4.6+, .NET Core 2.1+ |
335+
|||
336+
337+
Starting with **v2.0.0**, the `Microsoft.Data.SqLClient.AlwaysEncrypted.AzureKeyVaultProvider` supports the new Azure.Core and Azure.Identity APIs to perform authentication with Azure Key Vault. An instance of [`TokenCredential`](/dotnet/api/azure.core.tokencredential) implementation can now be passed to [`SqlColumnEncryptionAzureKeyVaultProvider`](/dotnet/api/microsoft.data.sqlclient.alwaysencrypted.azurekeyvaultprovider.sqlcolumnencryptionazurekeyvaultprovider) constructors to initialize Azure Key Vault provider object.
338+
327339
For examples demonstrating performing encryption/decryption with Azure Key Vault, see [Azure Key Vault working with Always Encrypted](azure-key-vault-example.md) and [Azure Key Vault working with Always Encrypted with secure enclaves](azure-key-vault-enclave-example.md).
328340

329341
### Implementing a custom column master key store provider

docs/connect/ado-net/sqlclient-driver-support-lifecycle.md

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "SqlClient driver support lifecycle"
33
description: "Page that contains product support lifecycle information."
4-
ms.date: "02/26/2021"
4+
ms.date: "03/03/2021"
55
dev_langs:
66
- "csharp"
77
- "vb"
@@ -30,7 +30,7 @@ New stable (GA) releases are published every six months on a regular cadence beg
3030

3131
| Version | Official Release Date | Latest Patch Version | Patch Release Date | Support Level | End of Support |
3232
| -- | -- | -- | -- | -- | -- |
33-
| 2.1 | November 19, 2020 | 2.1.1 | December 18, 2020 | LTS | November 20, 2023 |
33+
| 2.1 | November 19, 2020 | 2.1.2 | March 3, 2021 | LTS | November 20, 2023 |
3434
| 1.1 | November 20, 2019 | 1.1.3 | May 15, 2020 | LTS | November 21, 2022 |
3535

3636
### Out of support releases
@@ -40,14 +40,28 @@ New stable (GA) releases are published every six months on a regular cadence beg
4040
| 2.0 | June 16, 2020 | 2.0.1 | August 25, 2020 |
4141
| 1.0 | September 26, 2019 | 1.0.19269.1 | February 20, 2020 |
4242

43-
### Long Term Support (LTS) releases
43+
44+
## Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProvider release cadence
45+
46+
New stable (GA) releases are published on demand when new features are added. Long Term Support (LTS) releases will be chosen by stakeholders and maintainers based on a few qualifications and customer response.
47+
48+
### Actively supported releases
49+
50+
| Version | Official Release Date | Latest Patch Version | Patch Release Date | Support Level | End of Support |
51+
| -- | -- | -- | -- | -- | -- |
52+
| 2.x | March 3, 2021 | 2.0.0 | March 3, 2021 | LTS | March 4, 2024 |
53+
| 1.x | November 19, 2019 | 1.2.0 | December 01, 2020 | LTS | November 21, 2022 |
54+
55+
56+
## Long Term Support (LTS) releases
4457

4558
LTS releases are supported for three years after the initial release.
4659

47-
### Current releases
60+
## Current releases
4861

4962
Current releases are supported for three months after a subsequent Current or LTS release.
5063

64+
5165
## SQL version compatibility with Microsoft.Data.SqlClient
5266

5367
|Database version&nbsp;&#8594;<br />&#8595; Driver Version|Azure SQL Database|Azure Synapse Analytics|Azure SQL Managed Instance|SQL Server 2019|SQL Server 2017|SQL Server 2016|SQL Server 2014|SQL Server 2012|

docs/connect/ado-net/sqlclient-troubleshooting-guide.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "SqlClient troubleshooting guide"
33
description: "Page that provides resolutions to commonly observed problems."
4-
ms.date: "11/27/2020"
4+
ms.date: "03/03/2021"
55
dev_langs:
66
- "csharp"
77
- "vb"
@@ -167,6 +167,13 @@ at Microsoft.Data.SqlClient.SqlInternalConnection.OnError(SqlException exception
167167

168168
**Recommended Solution:** Generate a new TLS/SSL Certificate for the server whose hash is signed with at-least the SHA-256 hashing algorithm.
169169

170+
- Tightly restricted cipher suites on Linux with .NET 5+
171+
172+
.NET 5 introduced a breaking change for Linux clients, where a tightly restricted list of permitted cipher suites is used by default. You may need to expand the default cipher suite list to accept legacy clients (or to contact legacy servers) by either specify a `CipherSuitePolicy` value or changing the _OpenSSL_ configuration file.
173+
174+
Read more on [Default TLS cipher suites for .NET on Linux
175+
](/dotnet/core/compatibility/cryptography/5.0/default-cipher-suites-for-tls-on-linux) for recommended action.
176+
170177
### Connection Pool exhaustion errors
171178

172179
Stacktrace observed:

0 commit comments

Comments
 (0)