Skip to content

Commit e3215ef

Browse files
Merge pull request #188410 from WilliamDAssafMSFT/20220126-applies-to-asa
20220126 applies to asa
2 parents f7361f1 + ff956be commit e3215ef

File tree

3 files changed

+26
-15
lines changed

3 files changed

+26
-15
lines changed

articles/azure-sql/database/authentication-aad-service-principal.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -6,18 +6,15 @@ ms.subservice: security
66
ms.topic: conceptual
77
author: GithubMirek
88
ms.author: mireks
9-
ms.reviewer: kendralittle, vanto, mathoma
10-
ms.date: 12/15/2021
9+
ms.reviewer: kendralittle, vanto, mathoma, wiassaf
10+
ms.date: 02/14/2022
1111
---
1212

1313
# Azure Active Directory service principal with Azure SQL
1414

15-
[!INCLUDE[appliesto-sqldb-sqlmi](../includes/appliesto-sqldb-sqlmi.md)]
15+
[!INCLUDE[appliesto-sqldb-sqlmi-asa-dedicated-only](../includes/appliesto-sqldb-sqlmi-asa-dedicated-only.md)]
1616

17-
Azure Active Directory (Azure AD) supports user creation in Azure SQL Database (SQL DB) on behalf of Azure AD applications (service principals).
18-
19-
> [!NOTE]
20-
> This functionality is already supported for SQL Managed Instance.
17+
Azure Active Directory (Azure AD) supports user creation in Azure SQL Database (SQL DB) on behalf of Azure AD applications (service principals). This is supported for [Azure SQL Database](sql-database-paas-overview.md) and [Azure SQL Managed Instance](../managed-instance/sql-managed-instance-paas-overview.md), as well as to both dedicated SQL pools in Azure Synapse workspaces and dedicated SQL pools (formerly SQL DW).
2118

2219
## Service principal (Azure AD applications) support
2320

@@ -68,9 +65,11 @@ To enable an Azure AD object creation in SQL Database on behalf of an Azure AD a
6865
> [!NOTE]
6966
> Server identity can be assigned using REST API and CLI commands as well. For more information, see [az sql server create](/cli/azure/sql/server#az_sql_server_create), [az sql server update](/cli/azure/sql/server#az_sql_server_update), and [Servers - REST API](/rest/api/sql/2020-08-01-preview/servers).
7067
68+
7169
2. Grant the Azure AD [**Directory Readers**](../../active-directory/roles/permissions-reference.md#directory-readers) permission to the server identity created or assigned to the server.
7270
- To grant this permission, follow the description used for SQL Managed Instance that is available in the following article: [Provision Azure AD admin (SQL Managed Instance)](authentication-aad-configure.md?tabs=azure-powershell#provision-azure-ad-admin-sql-managed-instance)
7371
- The Azure AD user who is granting this permission must be part of the Azure AD **Global Administrator** or **Privileged Roles Administrator** role.
72+
- For dedicated SQL pools in an Azure Synapse workspace, use the workspace's managed identity instead of the Azure SQL server identity.
7473
7574
> [!IMPORTANT]
7675
> With [Microsoft Graph](/graph/overview) support for Azure SQL, the Directory Readers role can be replaced with using lower level permissions. For more information, see [User-assigned managed identity in Azure AD for Azure SQL](authentication-azure-ad-user-assigned-managed-identity.md)
@@ -81,7 +80,7 @@ To enable an Azure AD object creation in SQL Database on behalf of an Azure AD a
8180
8281
## Troubleshooting and limitations
8382
84-
- When creating Azure AD objects in Azure SQL on behalf of an Azure AD application without enabling server identity and granting **Directory Readers** permission, or lower level permissions discussed in [User-assigned managed identity in Azure AD for Azure SQL](authentication-azure-ad-user-assigned-managed-identity.md), the operation will fail with the following possible errors. The example error below is for a PowerShell command execution to create a SQL Database user `myapp` in the article [Tutorial: Create Azure AD users using Azure AD applications](authentication-aad-service-principal-tutorial.md).
83+
- When creating Azure AD objects in Azure SQL on behalf of an Azure AD application without enabling server identity and granting **Directory Readers** permission, or lower level permissions discussed in [User-assigned managed identity in Azure AD for Azure SQL](authentication-azure-ad-user-assigned-managed-identity.md), the operation will fail with the following possible errors. The following example error is for a PowerShell command execution to create a SQL Database user `myapp` in the article [Tutorial: Create Azure AD users using Azure AD applications](authentication-aad-service-principal-tutorial.md).
8584
- `Exception calling "ExecuteNonQuery" with "0" argument(s): "'myapp' is not a valid login or you do not have permission. Cannot find the user 'myapp', because it does not exist, or you do not have permission."`
8685
- `Exception calling "ExecuteNonQuery" with "0" argument(s): "Principal 'myapp' could not be resolved. Error message:
8786
'Server identity is not configured. Please follow the steps in "Assign an Azure AD identity to your server and add

articles/azure-sql/database/authentication-azure-ad-only-authentication.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,26 @@
11
---
2-
title: Azure Active Directory only authentication
3-
description: This article provides information on the Azure Active Directory (Azure AD) only authentication feature with Azure SQL Database and Azure SQL Managed Instance
2+
title: Azure Active Directory-only authentication
3+
description: This article provides information on the Azure AD-only authentication feature with Azure SQL
44
titleSuffix: Azure SQL Database & Azure SQL Managed Instance
55
ms.service: sql-db-mi
66
ms.subservice: security
77
ms.topic: conceptual
88
author: GithubMirek
99
ms.author: mireks
10-
ms.reviewer: kendralittle, vanto, mathoma
11-
ms.date: 11/03/2021
10+
ms.reviewer: kendralittle, vanto, mathoma, wiassaf
11+
ms.date: 02/14/2022
1212
ms.custom: ignite-fall-2021
1313
---
1414

1515
# Azure AD-only authentication with Azure SQL
1616

17-
[!INCLUDE[appliesto-sqldb-sqlmi](../includes/appliesto-sqldb-sqlmi.md)]
17+
[!INCLUDE[appliesto-sqldb-sqlmi-asa-dedicated-only](../includes/appliesto-sqldb-sqlmi-asa-dedicated-only.md)]
1818

19-
Azure AD-only authentication is a feature within [Azure SQL](../azure-sql-iaas-vs-paas-what-is-overview.md) that allows the service to only support Azure AD authentication, and is supported for [Azure SQL Database](sql-database-paas-overview.md) and [Azure SQL Managed Instance](../managed-instance/sql-managed-instance-paas-overview.md). SQL authentication is disabled when enabling Azure AD-only authentication in the Azure SQL environment, including connections from SQL server administrators, logins, and users. Only users using [Azure AD authentication](authentication-aad-overview.md) are authorized to connect to the server or database.
19+
Azure AD-only authentication is a feature within [Azure SQL](../azure-sql-iaas-vs-paas-what-is-overview.md) that allows the service to only support Azure AD authentication, and is supported for [Azure SQL Database](sql-database-paas-overview.md) and [Azure SQL Managed Instance](../managed-instance/sql-managed-instance-paas-overview.md). Azure AD-only authentication is also available for dedicated SQL pools (formerly SQL DW) in standalone servers, but not yet available for dedicated SQL pools in Azure Synapse workspaces.
2020

21-
Azure AD-only authentication can be enabled or disabled using the Azure portal, Azure CLI, PowerShell, or REST API. Azure AD-only authentication can also be configured during server creation with an ARM template.
21+
SQL authentication is disabled when enabling Azure AD-only authentication in the Azure SQL environment, including connections from SQL server administrators, logins, and users. Only users using [Azure AD authentication](authentication-aad-overview.md) are authorized to connect to the server or database.
22+
23+
Azure AD-only authentication can be enabled or disabled using the Azure portal, Azure CLI, PowerShell, or REST API. Azure AD-only authentication can also be configured during server creation with an Azure Resource Manager (ARM) template.
2224

2325
For more information on Azure SQL authentication, see [Authentication and authorization](logins-create-manage.md#authentication-and-authorization).
2426

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
ms.service: sql-database
3+
ms.topic: include
4+
ms.date: 01/26/2022
5+
author: WilliamDAssafMSFT
6+
ms.author: wiassaf
7+
---
8+
9+
**APPLIES TO:** :::image type="icon" source="../media/applies-to/yes.png" border="false":::Azure SQL Database :::image type="icon" source="../media/applies-to/yes.png" border="false":::Azure SQL Managed Instance :::image type="icon" source="../media/applies-to/yes.png" border="false":::Azure Synapse Analytics (dedicated SQL pools only)
10+

0 commit comments

Comments
 (0)