Skip to content

Commit 07e2aff

Browse files
authored
Merge pull request #220501 from JCoreMS/JCore-AVD-SSOUpdatev2
AVD SSO Updates v2 - Per discussion with DavidB
2 parents 4804127 + 459bc57 commit 07e2aff

File tree

1 file changed

+17
-18
lines changed

1 file changed

+17
-18
lines changed

articles/virtual-desktop/configure-single-sign-on.md

Lines changed: 17 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ manager: femila
77

88
ms.service: virtual-desktop
99
ms.topic: how-to
10-
ms.date: 09/22/2022
10+
ms.date: 12/06/2022
1111
ms.author: helohr
1212
---
1313
# Configure single sign-on for Azure Virtual Desktop using Azure AD Authentication
@@ -19,7 +19,7 @@ ms.author: helohr
1919
2020
This article will walk you through the process of configuring single sign-on (SSO) using Azure Active Directory (Azure AD) authentication for Azure Virtual Desktop (preview). When you enable SSO, you can use passwordless authentication and third-party Identity Providers that federate with Azure AD to sign in to your Azure Virtual Desktop and Remote Applications.
2121

22-
For additional passwordless functionality within the session, see the **Next Steps** section for configuring in-session passwordless authentication below.
22+
For additional passwordless functionality within the session, see the [**Next Steps**](#next-steps) section for configuring in-session passwordless authentication below.
2323

2424
> [!NOTE]
2525
> Azure Virtual Desktop (classic) doesn't support this feature.
@@ -28,31 +28,29 @@ For additional passwordless functionality within the session, see the **Next Ste
2828

2929
Single sign-on is available on session hosts using the following operating systems:
3030

31-
- Windows 11 Enterprise single or multi-session with the [2022-09 Cumulative Updates for Windows 11 Preview (KB5017383)](https://support.microsoft.com/kb/KB5017383) or later installed.
32-
- Windows 10 Enterprise single or multi-session, versions 20H2 or later with the [2022-09 Cumulative Updates for Windows 10 Preview (KB5017380)](https://support.microsoft.com/kb/KB5017380) or later installed.
33-
- Windows Server 2022 with the [2022-09 Cumulative Update for Microsoft server operating system preview (KB5017381)](https://support.microsoft.com/kb/KB5017381) or later installed.
31+
- Windows 11 Enterprise single or multi-session with the [2022-09 Cumulative Updates for Windows 11 Preview (KB5017383)](https://support.microsoft.com/kb/KB5017383) or later installed.
32+
- Windows 10 Enterprise single or multi-session, versions 20H2 or later with the [2022-09 Cumulative Updates for Windows 10 Preview (KB5017380)](https://support.microsoft.com/kb/KB5017380) or later installed.
33+
- Windows Server 2022 with the [2022-09 Cumulative Update for Microsoft server operating system preview (KB5017381)](https://support.microsoft.com/kb/KB5017381) or later installed.
34+
35+
Session hosts must be Azure AD-joined or [Hybrid Azure AD-Joined](https://learn.microsoft.com/azure/active-directory/devices/hybrid-azuread-join-plan).
3436

35-
Session Hosts must be Azure AD or Hybrid Joined:
36-
- You can enable SSO for connections to Azure Active Directory (AD)-joined VMs. If session hosts need access to SMB shares for FSLogix profiles, you will also need to enable [Kerberos for Azure AD.](../storage/files/storage-files-identity-auth-azure-active-directory-enable.md)
37-
- You can also use SSO to access Hybrid Azure AD-joined VMs, but only after [creating a Kerberos Server object within your Active Directory.](../active-directory/authentication/howto-authentication-passwordless-security-key-on-premises.md#create-a-kerberos-server-object)
3837
> [!NOTE]
39-
> Azure Virtual Desktop doesn't support this solution with VMs joined to Azure AD Domain Services.
38+
> Azure Virtual Desktop doesn't support this solution with VMs joined to Azure AD Domain Services or Active Directory only joined session hosts.
4039
41-
Connections currently supported:
42-
- [Windows Desktop client](users/connect-windows.md) on local PCs running Windows 10 or later. There's no requirement for the local PC to be joined to a domain or Azure AD.
43-
- [Web client](users/connect-web.md).
40+
You must [Create a Kerberos Server object](../active-directory/authentication/howto-authentication-passwordless-security-key-on-premises.md#create-a-kerberos-server-object) when your session host is:
4441

45-
> [!IMPORTANT]
46-
> SSO is currently only supported in the Azure Public cloud.
42+
- Hybrid Azure AD-joined. Azure AD Kerberos is needed to complete the authentication to the domain controller.
43+
- Azure AD-joined and your environment contains Active Directory Domain Controllers. Azure AD Kerberos is required in this case for users to access on-premises resources, like SMB shares, and Windows-integrated authentication to websites.
44+
45+
Clients currently supported:
4746

48-
## Enable single sign-on
47+
- [Windows Desktop client](users/connect-windows.md) on local PCs running Windows 10 or later. There's no requirement for the local PC to be joined to a domain or Azure AD.
48+
- [Web client](users/connect-web.md).
4949

50-
If your host pool contains Hybrid Azure AD-joined session hosts, you must first enable Azure AD Kerberos in your environment by creating a Kerberos Server object. Azure AD Kerberos enables the authentication needed with the domain controller. We recommended you also enable Azure AD Kerberos for Azure AD-joined session hosts if you have a Domain Controller (DC). Azure AD Kerberos provides a single sign-on experience when accessing legacy Kerberos-based applications or network shares. To enable Azure AD Kerberos in your environment, follow the steps to [Create a Kerberos Server object](../active-directory/authentication/howto-authentication-passwordless-security-key-on-premises.md#create-a-kerberos-server-object) on your DC.
50+
## Enable single sign-on
5151

5252
To enable SSO on your host pool, you must [customize an RDP property](customize-rdp-properties.md). You can find the **Azure AD Authentication** property under the **Connection information** tab in the Azure portal or set the **enablerdsaadauth** property to **1** using PowerShell.
5353

54-
For additional reference: [Deep dive: How Azure AD Kerberos works](https://techcommunity.microsoft.com/t5/itops-talk-blog/deep-dive-how-azure-ad-kerberos-works/ba-p/3070889)
55-
5654
> [!IMPORTANT]
5755
> If you enable SSO on your Hybrid Azure AD-joined VMs before you create the Kerberos server object, you won't be able to connect to the VMs, and you'll see an error message saying the specific log on session doesn't exist.
5856
@@ -63,6 +61,7 @@ When enabling single sign-on, you'll currently be prompted to authenticate to Az
6361
## Next steps
6462

6563
- Check out [In-session passwordless authentication (preview)](authentication.md#in-session-passwordless-authentication-preview) to learn how to enable passwordless authentication.
64+
- For more information about Azure AD Kerberos, see [Deep dive: How Azure AD Kerberos works](https://techcommunity.microsoft.com/t5/itops-talk-blog/deep-dive-how-azure-ad-kerberos-works/ba-p/3070889)
6665
- If you're accessing Azure Virtual Desktop from our Windows Desktop client, see [Connect with the Windows Desktop client](./users/connect-windows.md).
6766
- If you're accessing Azure Virtual Desktop from our web client, see [Connect with the web client](./users/connect-web.md).
6867
- If you encounter any issues, go to [Troubleshoot connections to Azure AD-joined VMs](troubleshoot-azure-ad-connections.md).

0 commit comments

Comments
 (0)