Skip to content

Commit bc0cefb

Browse files
Merge pull request #176423 from VanMSFT/MIAADOnlyauthupdate
Adding support for MI AAD-only auth server create
2 parents ae0b070 + 27a952a commit bc0cefb

6 files changed

+61
-22
lines changed

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

Lines changed: 22 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.topic: how-to
88
author: GithubMirek
99
ms.author: mireks
1010
ms.reviewer: vanto
11-
ms.date: 10/04/2021
11+
ms.date: 10/19/2021
1212
---
1313

1414
# Create server with Azure AD-only authentication enabled in Azure SQL
@@ -293,7 +293,27 @@ You can also use the following template. Use a [Custom deployment in the Azure p
293293

294294
# [Portal](#tab/azure-portal)
295295

296-
Managing or deploying a managed instance with Azure AD-only authentication using the Azure portal is currently not supported. You can deploy a managed instance with Azure AD-only authentication using the Azure CLI, PowerShell, Rest API, or with an ARM template.
296+
1. Browse to the [Select SQL deployment](https://portal.azure.com/#create/Microsoft.AzureSQL) option page in the Azure portal.
297+
298+
1. If you aren't already signed in to Azure portal, sign in when prompted.
299+
300+
1. Under **SQL managed instances**, leave **Resource type** set to **Single instance**, and select **Create**.
301+
302+
1. Fill out the mandatory information required on the **Basics** tab for **Project details** and **Managed Instance details**. This is a minimum set of information required to provision a SQL Managed Instance.
303+
304+
:::image type="content" source="media/authentication-azure-ad-only-authentication/azure-ad-only-managed-instance-create-basic.png" alt-text="Azure portal screenshot of the create Managed Instance basic tab ":::
305+
306+
For more information on the configuration options, see [Quickstart: Create an Azure SQL Managed Instance](/azure/azure-sql/managed-instance/instance-create-quickstart).
307+
308+
1. Under **Authentication**, select **Use only Azure Active Directory (Azure AD) authentication** for the **Authentication method**.
309+
310+
1. Select **Set admin**, which brings up a menu to select an Azure AD principal as your managed instance Azure AD administrator. When you're finished, use the **Select** button to set your admin.
311+
312+
:::image type="content" source="media/authentication-azure-ad-only-authentication/azure-ad-only-managed-instance-create-basic-choose-authentication.png" alt-text="Azure portal screenshot of the create Managed Instance basic tab and choosing Azure AD only authentication":::
313+
314+
1. You can leave the rest of the settings default. For more information on the **Networking**, **Security**, or other tabs and settings, follow the guide in the article [Quickstart: Create an Azure SQL Managed Instance](/azure/azure-sql/managed-instance/instance-create-quickstart).
315+
316+
1. Once you are done with configuring your settings, select **Review + create** to proceed. Select **Create** to start provisioning the managed instance.
297317

298318
# [The Azure CLI](#tab/azure-cli)
299319

@@ -705,7 +725,6 @@ Once the deployment is complete for your managed instance, you may notice that t
705725

706726
## Limitations
707727

708-
- Creating a managed instance using the Azure portal with Azure AD-only authentication enabled during provisioning is currently not supported.
709728
- To reset the server administrator password, Azure AD-only authentication must be disabled.
710729
- If Azure AD-only authentication is disabled, you must create a server with a server admin and password when using all APIs.
711730

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

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.topic: conceptual
88
author: GithubMirek
99
ms.author: mireks
1010
ms.reviewer: vanto
11-
ms.date: 09/22/2021
11+
ms.date: 10/19/2021
1212
---
1313

1414
# Azure Policy for Azure Active Directory only authentication with Azure SQL
@@ -72,7 +72,6 @@ The Azure Policy can prevent a new logical server or managed instance from being
7272

7373
## Limitations
7474

75-
- Currently, you can't create a logical server or managed instance in the Azure portal with Azure AD-only authentication enabled. You can create a logical server or managed instance with Azure AD-only authentication enabled using the Azure CLI, PowerShell, Rest API, or with an ARM template. For more information, see [Create server with Azure AD-only authentication enabled in Azure SQL](authentication-azure-ad-only-authentication-create-server.md).
7675
- Azure Policy enforces Azure AD-only authentication during logical server or managed instance creation. Once the server is created, authorized Azure AD users with special roles (for example, SQL Security Manager) can disable the Azure AD-only authentication feature. The Azure Policy allows it, but in this case, the server or managed instance will be listed in the compliance report as `Non-compliant` and the report will indicate the server or managed instance name.
7776
- For more remarks, known issues, and permissions needed, see [Azure AD-only authentication](authentication-azure-ad-only-authentication.md).
7877

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

Lines changed: 29 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.topic: tutorial
88
author: GithubMirek
99
ms.author: mireks
1010
ms.reviewer: vanto
11-
ms.date: 08/31/2021
11+
ms.date: 10/19/2021
1212
---
1313

1414
# Tutorial: Enable Azure Active Directory only authentication with Azure SQL
@@ -18,7 +18,7 @@ ms.date: 08/31/2021
1818
> [!NOTE]
1919
> The **Azure AD-only authentication** feature discussed in this article is in **public preview**.
2020
21-
This article guides you through enabling the [Azure AD-only authentication](authentication-azure-ad-only-authentication.md) feature within Azure SQL Database and Azure SQL Managed Instance. If you are looking to provision a SQL Database or Managed Instance with Azure AD-only authentication enabled, see [Create server with Azure AD-only authentication enabled in Azure SQL](authentication-azure-ad-only-authentication-create-server.md).
21+
This article guides you through enabling the [Azure AD-only authentication](authentication-azure-ad-only-authentication.md) feature within Azure SQL Database and Azure SQL Managed Instance. If you are looking to provision a SQL Database or SQL Managed Instance with Azure AD-only authentication enabled, see [Create server with Azure AD-only authentication enabled in Azure SQL](authentication-azure-ad-only-authentication-create-server.md).
2222

2323
In this tutorial, you learn how to:
2424

@@ -71,9 +71,16 @@ To enable Azure AD-only authentication auth in the Azure portal, see the steps b
7171
1. Select the **Support only Azure Active Directory authentication for this server** checkbox.
7272
1. The **Enable Azure AD authentication only** popup will show. Click **Yes** to enable the feature and **Save** the setting.
7373

74-
## Azure SQL Managed Instance
74+
## Enable in SQL Managed Instance using Azure portal
7575

76-
Managing Azure AD-only authentication for SQL Managed Instance in the portal is currently not supported.
76+
To enable Azure AD-only authentication auth in the Azure portal, see the steps below.
77+
78+
1. Using the user with the [SQL Security Manager](../../role-based-access-control/built-in-roles.md#sql-security-manager) role, go to the [Azure portal](https://portal.azure.com/).
79+
1. Go to your **SQL managed instance** resource, and select **Active Directory admin** under the **Settings** menu.
80+
81+
1. If you haven't added an **Azure Active Directory admin**, you'll need to set this before you can enable Azure AD-only authentication.
82+
1. Select the **Support only Azure Active Directory authentication for this managed instance** checkbox.
83+
1. The **Enable Azure AD authentication only** popup will show. Click **Yes** to enable the feature and **Save** the setting.
7784

7885
# [The Azure CLI](#tab/azure-cli)
7986

@@ -162,7 +169,7 @@ For more information on managing Azure AD-only authentication using APIs, see [M
162169
Connect-AzAccount
163170
```
164171

165-
1. Run the following command, replacing `<myinstance>` with your SQL Managed Instance name, and `<myresource>` with your Azure Resource that holds the SQL managed instance.
172+
1. Run the following command, replacing `<myinstance>` with your SQL Managed Instance name, and `<myresource>` with your Azure Resource that holds the **SQL managed instance**.
166173

167174
```powershell
168175
Enable-AzSqlInstanceActiveDirectoryOnlyAuthentication -InstanceName <myinstance> -ResourceGroupName <myresource>
@@ -176,7 +183,13 @@ Check whether Azure AD-only authentication is enabled for your server or instanc
176183

177184
# [Portal](#tab/azure-portal)
178185

179-
Go to your **SQL server** resource in the [Azure portal](https://portal.azure.com/). Select **Azure Active Directory** under the **Settings** menu. Portal support for Azure AD-only authentication is only available for Azure SQL Database.
186+
## Check status in SQL Database
187+
188+
Go to your **SQL server** resource in the [Azure portal](https://portal.azure.com/). Select **Azure Active Directory** under the **Settings** menu.
189+
190+
## Check status in SQL Managed Instance
191+
192+
Go to your **SQL managed instance** resource in the [Azure portal](https://portal.azure.com/). Select **Active Directory admin** under the **Settings** menu.
180193

181194
# [The Azure CLI](#tab/azure-cli)
182195

@@ -262,7 +275,7 @@ The status will return **True** if the feature is enabled, and **False** if disa
262275
Connect-AzAccount
263276
```
264277

265-
1. Run the following command, replacing `<myinstance>` with your SQL Managed Instance name, and `<myresource>` with your Azure Resource that holds the SQL managed instance.
278+
1. Run the following command, replacing `<myinstance>` with your SQL Managed Instance name, and `<myresource>` with your Azure Resource that holds the **SQL managed instance**.
266279

267280
```powershell
268281
Get-AzSqlInstanceActiveDirectoryOnlyAuthentication -InstanceName <myinstance> -ResourceGroupName <myresource>
@@ -272,7 +285,7 @@ The status will return **True** if the feature is enabled, and **False** if disa
272285

273286
## Test SQL authentication with connection failure
274287

275-
After enabling Azure AD-only authentication, test with [SQL Server Management Studio (SSMS)](/sql/ssms/download-sql-server-management-studio-ssms) to [connect to your SQL Database or Managed Instance](connect-query-ssms.md). Use SQL authentication for the connection.
288+
After enabling Azure AD-only authentication, test with [SQL Server Management Studio (SSMS)](/sql/ssms/download-sql-server-management-studio-ssms) to [connect to your SQL Database or SQL Managed Instance](connect-query-ssms.md). Use SQL authentication for the connection.
276289

277290
You should see a login failed message similar to the following output:
278291

@@ -289,11 +302,17 @@ By disabling the Azure AD-only authentication feature, you allow both SQL authen
289302

290303
# [Portal](#tab/azure-portal)
291304

305+
## Disable in SQL Database using Azure portal
306+
292307
1. Using the user with the [SQL Security Manager](../../role-based-access-control/built-in-roles.md#sql-security-manager) role, go to the [Azure portal](https://portal.azure.com/).
293308
1. Go to your SQL server resource, and select **Azure Active Directory** under the **Settings** menu.
294309
1. To disable the Azure AD-only authentication feature, uncheck the **Support only Azure Active Directory authentication for this server** checkbox and **Save** the setting.
295310

296-
Managing Azure AD-only authentication for SQL Managed Instance in the portal is currently not supported.
311+
## Disable in SQL Managed Instance using Azure portal
312+
313+
1. Using the user with the [SQL Security Manager](../../role-based-access-control/built-in-roles.md#sql-security-manager) role, go to the [Azure portal](https://portal.azure.com/).
314+
1. Go to your **SQL managed instance** resource, and select **Active Directory admin** under the **Settings** menu.
315+
1. To disable the Azure AD-only authentication feature, uncheck the **Support only Azure Active Directory authentication for this managed instance** checkbox and **Save** the setting.
297316

298317
# [The Azure CLI](#tab/azure-cli)
299318

@@ -381,7 +400,7 @@ To disable Azure AD-only authentication in Azure SQL Managed Instance using Powe
381400
Connect-AzAccount
382401
```
383402

384-
1. Run the following command, replacing `<myinstance>` with your SQL Managed Instance name, and `<myresource>` with your Azure Resource that holds the SQL managed instance.
403+
1. Run the following command, replacing `<myinstance>` with your SQL Managed Instance name, and `<myresource>` with your Azure Resource that holds the managed instance.
385404

386405
```powershell
387406
Disable-AzSqlInstanceActiveDirectoryOnlyAuthentication -InstanceName <myinstance> -ResourceGroupName <myresource>

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

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.topic: conceptual
88
author: GithubMirek
99
ms.author: mireks
1010
ms.reviewer: vanto
11-
ms.date: 08/31/2021
11+
ms.date: 10/19/2021
1212
---
1313

1414
# Azure AD-only authentication with Azure SQL
@@ -24,12 +24,9 @@ Azure AD-only authentication can be enabled or disabled using the Azure portal,
2424

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

27-
> [!IMPORTANT]
28-
> Currently, you cannot manage Azure AD-only authentication in the Azure portal for Azure SQL Managed Instance. For a tutorial on different methods to enable Azure AD-only authentication, see [Tutorial: Enable Azure Active Directory only authentication with Azure SQL](authentication-azure-ad-only-authentication-tutorial.md).
29-
3027
## Feature description
3128

32-
When enabling Azure AD-only authentication, [SQL authentication](logins-create-manage.md#authentication-and-authorization) is disabled at the server level and prevents any authentication based on any SQL authentication credentials. SQL authentication users won't be able to connect to the [logical server](logical-servers.md) for Azure SQL Database, including all of its databases. Although SQL authentication is disabled, new SQL authentication logins and users can still be created by Azure AD accounts with proper permissions. Newly created SQL authentication accounts won't be allowed to connect to the server. Enabling Azure AD-only authentication doesn't remove existing SQL authentication login and user accounts. The feature only prevents these accounts from connecting to the server, and any database created for this server.
29+
When enabling Azure AD-only authentication, [SQL authentication](logins-create-manage.md#authentication-and-authorization) is disabled at the server or managed instance level and prevents any authentication based on any SQL authentication credentials. SQL authentication users won't be able to connect to the [logical server](logical-servers.md) for Azure SQL Database or managed instance, including all of its databases. Although SQL authentication is disabled, new SQL authentication logins and users can still be created by Azure AD accounts with proper permissions. Newly created SQL authentication accounts won't be allowed to connect to the server. Enabling Azure AD-only authentication doesn't remove existing SQL authentication login and user accounts. The feature only prevents these accounts from connecting to the server, and any database created for this server.
3330

3431
You can also force servers to be created with Azure AD-only authentication enabled using Azure Policy. For more information, see [Azure Policy for Azure AD-only authentication](authentication-azure-ad-only-authentication-policy.md).
3532

@@ -395,10 +392,15 @@ SELECT SERVERPROPERTY('IsExternalAuthenticationOnly')
395392
- Azure AD users with proper permissions can impersonate existing SQL users.
396393
- Impersonation continues working between SQL authentication users even when the Azure AD-only authentication feature is enabled.
397394

398-
## Known issues
395+
### Limitations for Azure AD-only authentication in managed instance
396+
397+
When Azure AD-only authentication is enabled for managed instance, the following features aren't supported:
399398

400-
- When Azure AD-only authentication is enabled, the server administrator password cannot be reset. Currently, the password resent operation succeeds in portal but fails in the SQL engine. The failure is indicated in the server activity log. In order to reset the server admin password, the Azure AD-only authentication feature must be disabled.
399+
- Transactional replication
400+
- EXEC AS statement for Azure AD group member accounts
401+
- [SQL Agent Jobs in Managed Instance](/azure/azure-sql/managed-instance/job-automation-managed-instance) supports Azure AD-only authentication. However, the Azure AD user who is a member of an Azure AD group that has access to the managed instance cannot own SQL Agent Jobs.
401402

403+
For more limitations, see [T-SQL differences between SQL Server & Azure SQL Managed Instance](/azure/azure-sql/managed-instance/transact-sql-tsql-differences-sql-server#logins-and-users).
402404

403405
## Next steps
404406

Loading
Loading

0 commit comments

Comments
 (0)