Skip to content

Commit 459bc57

Browse files
authored
Update via DavidB
Bookmark "next steps" in top, move Note under item for pre-reqs
1 parent b448533 commit 459bc57

File tree

1 file changed

+16
-17
lines changed

1 file changed

+16
-17
lines changed

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

Lines changed: 16 additions & 17 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,40 +19,38 @@ 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.
2626
2727
## Prerequisites
2828

29-
**Single sign-on is available on session hosts using the following operating systems:**
29+
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.
3434

35-
**Session Hosts must be Azure AD or Hybrid Joined**
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).
3636

37-
**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:**
37+
> [!NOTE]
38+
> Azure Virtual Desktop doesn't support this solution with VMs joined to Azure AD Domain Services or Active Directory only joined session hosts.
39+
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:
3841

3942
- Hybrid Azure AD-joined. Azure AD Kerberos is needed to complete the authentication to the domain controller.
40-
- 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. For information on Azure AD joined Sessions Hosts using FSLogix, see [Create a profile container with Azure Files and Azure Active Directory](create-profile-container-azure-ad.md)
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.
4144

42-
**Connections currently supported:**
45+
Clients currently supported:
4346

44-
- [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.
45-
- [Web client](users/connect-web.md).
46-
47-
> [!NOTE]
48-
> Azure Virtual Desktop doesn't support this solution with VMs joined to Azure AD Domain Services or Active Directory only joined Session Hosts.
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

5050
## 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)