Skip to content

Commit 21ee4b1

Browse files
Merge pull request #24630 from VanMSFT/aadServerupdate
Changes according to Bob and Mirek
2 parents 755c037 + 94c8f4d commit 21ee4b1

3 files changed

Lines changed: 17 additions & 9 deletions

File tree

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

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Tutorial on how to set up Azure Active Directory authentication tha
44
author: GithubMirek
55
ms.author: mireks
66
ms.reviewer: vanto, randolphwest
7-
ms.date: 08/25/2022
7+
ms.date: 10/20/2022
88
ms.prod: sql
99
ms.technology: security
1010
ms.topic: tutorial
@@ -25,13 +25,12 @@ In this article, we'll go over how to set up the Azure Active Directory (Azure A
2525
We'll also go over the updated functionality to set up an Azure AD admin for SQL Server in the Azure portal that would allow for automated certificate creation and application registration. Previously, setting up [Azure AD authentication for SQL server required manual setup of Azure AD admin with an Azure certificate and application registration](azure-ad-authentication-sql-server-setup-tutorial.md).
2626

2727
> [!NOTE]
28-
> This feature is available in [!INCLUDE [sssql22-md](../../../includes/sssql22-md.md)] or later versions, and is only supported for SQL Server on-premises, for Windows and Linux hosts. Azure Virtual Machines aren't supported.
28+
> This feature is available in [!INCLUDE [sssql22-md](../../../includes/sssql22-md.md)] or later versions, and is only supported for SQL Server on-premises, for Windows and Linux hosts.
2929
3030
## Prerequisites
3131

3232
- [!INCLUDE [sssql22-md](../../../includes/sssql22-md.md)] or later is installed.
3333
- SQL Server is connected to Azure cloud. For more information, see [Connect your SQL Server to Azure Arc](../../../sql-server/azure-arc/connect.md).
34-
- Azure extension for SQL Server version 1.1.1795.50 or higher for Windows, or version 1.0.2018.1 or higher for Linux, is installed.
3534
- Access to Azure Active Directory is available for authentication purpose. For more information, see [Azure Active Directory authentication for SQL Server](azure-ad-authentication-sql-server-overview.md).
3635
- An [Azure Key Vault](/azure/key-vault/general/quick-create-portal) is required.
3736

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn about Azure Active Directory authentication support for SQL S
44
author: GithubMirek
55
ms.author: mireks
66
ms.reviewer: vanto, randolphwest
7-
ms.date: 08/23/2022
7+
ms.date: 10/20/2022
88
ms.prod: sql
99
ms.technology: security
1010
ms.topic: conceptual
@@ -61,7 +61,7 @@ Some non-GUI clients such as [Invoke-sqlcmd](/powershell/module/sqlserver/invoke
6161

6262
## Remarks
6363

64-
- Only [!INCLUDE [sssql22-md](../../../includes/sssql22-md.md)] on-premises with a supported Windows or Linux operating system is supported for Azure AD authentication. SQL Servers on Azure Virtual Machines aren't supported for Azure AD authentication.
64+
- Only [!INCLUDE [sssql22-md](../../../includes/sssql22-md.md)] on-premises with a supported Windows or Linux operating system is supported for Azure AD authentication.
6565
- To connect SQL Server to Azure Arc, the Azure AD account needs the following permissions:
6666
- Member of the *Azure Connected Machine Onboarding* group or *Contributor* role in the resource group.
6767
- Member of the *Azure Connected Machine Resource Administrator* role in the resource group.

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

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Tutorial on how to set up Azure Active Directory Authentication for
44
author: GithubMirek
55
ms.author: mireks
66
ms.reviewer: vanto, randolphwest
7-
ms.date: 09/12/2022
7+
ms.date: 10/25/2022
88
ms.prod: sql
99
ms.technology: security
1010
ms.topic: tutorial
@@ -16,7 +16,7 @@ monikerRange: ">=sql-server-ver16||>= sql-server-linux-ver16"
1616

1717
[!INCLUDE [SQL Server 2022](../../../includes/applies-to-version/sqlserver2022.md)]
1818

19-
This document describes a step-by-step process on how to set up Azure Active Directory (Azure AD) authentication for SQL Server, and how to use different Azure AD authentication methods. This feature is available in [!INCLUDE [sssql22-md](../../../includes/sssql22-md.md)] and later versions, and is only supported for SQL Server on-premises, for Windows and Linux hosts. Azure Virtual Machines aren't supported.
19+
This document describes a step-by-step process on how to set up Azure Active Directory (Azure AD) authentication for SQL Server, and how to use different Azure AD authentication methods. This feature is available in [!INCLUDE [sssql22-md](../../../includes/sssql22-md.md)] and later versions, and is only supported for SQL Server on-premises, for Windows and Linux hosts.
2020

2121
In this tutorial, you learn how to:
2222

@@ -33,7 +33,6 @@ In this tutorial, you learn how to:
3333

3434
- [!INCLUDE [sssql22-md](../../../includes/sssql22-md.md)] is installed.
3535
- SQL Server is connected to Azure cloud. For more information, see [Connect your SQL Server to Azure Arc](../../../sql-server/azure-arc/connect.md).
36-
- Azure extension for SQL Server version 1.1.1795.50 or higher for Windows, or version 1.0.2018.1 or higher for Linux, is installed.
3736
- Access to Azure Active Directory is available for authentication purpose. For more information, see [Azure Active Directory authentication for SQL Server](azure-ad-authentication-sql-server-overview.md).
3837
- [SQL Server Management Studio (SSMS)](../../../ssms/download-sql-server-management-studio-ssms.md) version 18.0 or higher is installed on the client machine. Or download the latest [Azure Data Studio](../../../azure-data-studio/download-azure-data-studio.md).
3938

@@ -156,7 +155,17 @@ Select the newly created application, and on the left side menu, select **API Pe
156155

157156
The Azure Arc server agent can only update once the previous action has completed. This means that saving a new Azure AD configuration before the last one has finalized can cause a failure. If you see the message **Extended call failed** when you select **Save**, wait 5 minutes and then try again.
158157

159-
The admin login specified in the portal will be added as a `sysadmin` to the SQL Server instance, but it will not be listed in `syslogins` or `sys.server_principals`.
158+
The Azure AD admin login is listed in `sys.server_principals`, but is not part of the `sysadmin` role. To grant the Azure AD admin the `sysadmin` role, use the [sp_addsrvrolemember](/sql/relational-databases/system-stored-procedures/sp-addsrvrolemember-transact-sql) stored procedure.
159+
160+
```sql
161+
EXEC sp_addsrvrolemember @loginame='aadadmin@contoso.com', @rolename='sysadmin';
162+
GO
163+
```
164+
165+
> [!NOTE]
166+
> Once the Azure AD admin login is granted the `sysadmin` role, changing the Azure AD admin in the Azure portal does not remove the previous login that remains as a `sysadmin`. To remove the login, it must be dropped manually.
167+
>
168+
> The Azure AD admin change for the SQL Server instance takes place without a server restart, once the process is completed with the SQL Server's Azure Arc agent. For the new admin to display in `sys.server_principals`, the SQL Server instance must be restarted, and until then, the old admin is displayed. The current Azure AD admin can be checked in the Azure portal.
160169
161170
## Create logins and users
162171

0 commit comments

Comments
 (0)