Skip to content

Commit c46221c

Browse files
authored
Merge pull request #35619 from VanMSFT/20251021_updateURLspec
Reference Microsoft Entra auth URLs
2 parents d0414b6 + 234a513 commit c46221c

4 files changed

Lines changed: 15 additions & 11 deletions

File tree

docs/includes/entra-id-tutorial.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ 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
- [SQL Server Management Studio (SSMS)](../ssms/download-sql-server-management-studio-ssms.md) version 18.0 or higher 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-entra-id-authentication)
34+
- [Network requirements for enabling Entra ID authentication](../sql-server/azure-arc/prerequisites.md#network-requirements-for-enabling-microsoft-entra-authentication)
3535

3636
Microsoft Entra ID supports CSP certificates. Entra ID doesn't support CNG certificates.
3737

@@ -47,7 +47,7 @@ In this tutorial, you learn how to:
4747
> [!WARNING]
4848
> Connections authenticated by Microsoft Entra ID are always encrypted. If SQL Server is using a self-signed certificate, you must add `trust server cert = true` in the connection string. SQL Server and Windows authenticated connections don't require encryption, but it's strongly recommended.
4949
>
50-
> SQL Server connects directly to Microsoft Entra ID for authentication. Either [explicit firewall URLs](../sql-server/azure-arc/prerequisites.md#network-requirements-for-enabling-entra-id-authentication) need to be opened for direct access, or use a proxy server. Microsoft Entra ID doesn't use the Arc Connected Machine Agent proxy for authentication. If the machine requires using a proxy server, Microsoft Entra ID requires that the machine-level WinHTTP proxy is set using the following commands (replace `<http://proxyserver:port>` with the appropriate value):
50+
> SQL Server connects directly to Microsoft Entra ID for authentication. Either [explicit firewall URLs](../sql-server/azure-arc/prerequisites.md#network-requirements-for-enabling-microsoft-entra-authentication) need to be opened for direct access, or use a proxy server. Microsoft Entra ID doesn't use the Arc Connected Machine Agent proxy for authentication. If the machine requires using a proxy server, Microsoft Entra ID requires that the machine-level WinHTTP proxy is set using the following commands (replace `<http://proxyserver:port>` with the appropriate value):
5151
>
5252
> ```console
5353
> netsh winhttp set proxy proxy-server="<http://proxyserver:port>"

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ We'll also go over the updated functionality to set up a Microsoft Entra admin f
3838
- SQL Server is connected to Azure cloud. For more information, see [Connect your SQL Server to Azure Arc](../../../sql-server/azure-arc/connect.md).
3939
- Microsoft Entra ID is configured for authentication in the same tenant as the Azure Arc instance.
4040
- An [Azure Key Vault](/azure/key-vault/general/quick-create-portal) is required.
41-
- [Network requirements for enabling Entra ID authentication](../../../sql-server/azure-arc/prerequisites.md#network-requirements-for-enabling-entra-id-authentication) are met.
41+
- [Network requirements for enabling Entra ID authentication](../../../sql-server/azure-arc/prerequisites.md#network-requirements-for-enabling-microsoft-entra-authentication) are met.
4242

4343
<a name='preparation-before-setting-the-azure-ad-admin'></a>
4444

docs/sql-server/azure-arc/includes/entra-id-authentication-prerequisites.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,12 @@ ms.date: 03/24/2025
55
ms.topic: include
66
---
77

8-
Enabling Entra ID authentication for [!INCLUDE [ssnoversion-md](../../../includes/ssnoversion-md.md)] enabled by Azure Arc requires some URLs to be allowed explicitly if a firewall blocks outbound URLs. Add the following URLs to the allowlist:
8+
Enabling Microsoft Entra authentication for [!INCLUDE [ssnoversion-md](../../../includes/ssnoversion-md.md)] enabled by Azure Arc requires some URLs to be allowed explicitly if a firewall blocks outbound URLs. Add the following URLs to the allowlist:
99

1010
- `https://login.microsoftonline.com/`
11-
- `https://<azure-keyvault-name>.vault.azure.net/`
11+
- `https://login.microsoft.com/`
12+
- `https://enterpriseregistration.windows.net/`
1213
- `https://graph.microsoft.com/`
14+
- `https://<azure-keyvault-name>.vault.azure.net/` (Required only if you're using certificates for Microsoft Entra authentication)
15+
16+
Additionally, you might need to allow [Azure portal authentication URLs](/azure/azure-portal/azure-portal-safelist-urls#azure-portal-authentication).

docs/sql-server/azure-arc/prerequisites.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Describes prerequisites required for SQL Server enabled by Azure Ar
44
author: anosov1960
55
ms.author: sashan
66
ms.reviewer: mikeray, randolphwest
7-
ms.date: 03/25/2025
7+
ms.date: 10/21/2025
88
ms.topic: conceptual
99
ms.custom: references_regions
1010
---
@@ -15,7 +15,7 @@ ms.custom: references_regions
1515

1616
An Azure Arc-enabled instance of [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] is an instance on-premises or in a cloud provider that is connected to Azure Arc. This article explains those prerequisites.
1717

18-
If your SQL Server VMs are on VMware clusters, review [Support on VMware](#support-on-vmware).
18+
If your SQL Server virtual machines are on VMware clusters, review [Support on VMware](#support-on-vmware).
1919

2020
## Before you deploy
2121

@@ -70,7 +70,7 @@ Only databases that are online and updateable are included.
7070

7171
Verify the state of any databases you plan to manage from Azure.
7272

73-
This query lists all databases, their status, and if they are updateable:
73+
This query lists all databases, their status, and if they're updateable:
7474

7575
```sql
7676
SELECT
@@ -98,9 +98,9 @@ For more information about this requirement, review [SQL Server service account]
9898
### Set proxy exclusions
9999

100100
> [!NOTE]
101-
> The exclusion in this section is required for the March, 2024 release and before.
101+
> The exclusion in this section is required for the March 2024 release and before.
102102
>
103-
> Beginning with the release in April, 2024 this exclusion is not required.
103+
> Beginning with the release in April 2024, this exclusion isn't required.
104104
105105
If a proxy server is used, set the `NO_PROXY` environment variable to exclude proxy traffic for:
106106

@@ -121,7 +121,7 @@ If a proxy server is used, set the `NO_PROXY` environment variable to exclude pr
121121
> [!NOTE]
122122
> You can't use Azure Private Link connections to the Azure Arc data processing service. See [Unsupported configurations](#unsupported-configurations).
123123
124-
### Network requirements for enabling Entra ID authentication
124+
### Network requirements for enabling Microsoft Entra authentication
125125

126126
[!INCLUDE [entra-id-authentication-prerequisites](includes/entra-id-authentication-prerequisites.md)]
127127

0 commit comments

Comments
 (0)