Skip to content

Commit 1835fe2

Browse files
Merge pull request #36111 from VanMSFT/vanmsft-sql-security-entra-auth-tutorial
Update Microsoft Entra authentication tutorial with certificate CN warning
2 parents 33c2fb0 + e30296c commit 1835fe2

2 files changed

Lines changed: 8 additions & 4 deletions

File tree

docs/includes/entra-id-tutorial.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
author: MikeRayMSFT
33
ms.author: mikeray
44
ms.reviewer: randolphwest
5-
ms.date: 07/31/2025
5+
ms.date: 12/18/2025
66
ms.service: sql
77
ms.topic: include
88
---
@@ -31,9 +31,13 @@ In this tutorial, you learn how to:
3131
- Access to Microsoft Entra ID is available for authentication purpose. For more information, see [Microsoft Entra authentication for SQL Server](../relational-databases/security/authentication-access/azure-ad-authentication-sql-server-overview.md).
3232
- A supported version of [SQL Server Management Studio](/ssms/install/install) is installed on the client machine.
3333
- A supported certificate.
34-
- [Network requirements for enabling Entra ID authentication](../sql-server/azure-arc/prerequisites.md#network-requirements-for-enabling-microsoft-entra-authentication)
3534

36-
Microsoft Entra ID supports CSP certificates. Entra ID doesn't support CNG certificates.
35+
> [!WARNING]
36+
> When configuring Microsoft Entra authentication for SQL Server, the certificate used for Microsoft Entra login must have a unique Common Name (CN). If multiple certificates in the computer's certificate store share the same CN, SQL Server might not select the correct certificate for Microsoft Entra authentication, and Microsoft Entra logins will fail.
37+
38+
- [Network requirements for enabling Microsoft Entra ID authentication](../sql-server/azure-arc/prerequisites.md#network-requirements-for-enabling-microsoft-entra-authentication)
39+
40+
Microsoft Entra ID supports CSP certificates. Microsoft Entra ID doesn't support CNG certificates.
3741

3842
### Authentication prerequisites
3943

docs/relational-databases/security/authentication-access/azure-ad-authentication-sql-server-setup-tutorial.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Tutorial on how to set up Microsoft Entra authentication for SQL Se
44
author: PratimDasgupta
55
ms.author: prdasgu
66
ms.reviewer: vanto, randolphwest, mikeray
7-
ms.date: 08/28/2025
7+
ms.date: 12/18/2025
88
ms.service: sql
99
ms.subservice: security
1010
ms.topic: tutorial

0 commit comments

Comments
 (0)