Merge pull request #304860 from GitHubber17/476230-d

Freshness Edit - Dev Box

Author: JillGrant615

articles/dev-box/how-to-enable-single-sign-on.md

@@ -1,15 +1,15 @@
 ---
 title: Enable Single Sign-On for Dev Boxes
 titleSuffix: Microsoft Dev Box
-description: Learn how to enable single sign-on for dev boxes. Edit an existing pool to configure single sign-on for new dev boxes.
+description: Learn how to enable single sign-on for dev boxes and edit an existing pool to configure single sign-on for new dev boxes.
 services: dev-box
 ms.service: dev-box
 author: RoseHJM
 ms.author: rosemalcolm
-ms.date: 04/24/2024
+ms.date: 08/29/2025
 ms.topic: how-to
 
-#customer intent: As a platform engineer, I want to enable single sign-on for dev boxes so that my dev box users have a smoother sign-in experience.
+#customer intent: As a platform engineer, I want to enable single sign-on for dev boxes so I can support my dev box users with a smoother sign-in experience.
 ---
 
 # Enable single sign-on for dev boxes
@@ -20,7 +20,7 @@ By using SSO, you can skip the credential prompt when you connect to a dev box a
 
 ## Prerequisites
 
-To enable SSO for dev boxes, you must configure SSO for your organization. For more information, see [Configure single sign-on for Azure Virtual Desktop by using Microsoft Entra ID authentication](/azure/virtual-desktop/configure-single-sign-on).
+To enable SSO for dev boxes, you must configure SSO for your organization. For more information, see [Configure single sign-on for Azure Virtual Desktop by using Microsoft Entra ID](/azure/virtual-desktop/configure-single-sign-on) authentication.
 
 ## Enable SSO for dev boxes
 
@@ -33,34 +33,48 @@ When you enable SSO for a pool, all new dev boxes created from that pool use SSO
 To enable SSO for dev boxes when you create a pool, follow these steps:
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
-1. In the search box, enter **projects**.
+
+1. In the search box, enter _projects_.
+
 1. In the list of results, select **Projects**.
+
 1. Select the project for which you want to create the pool.
+
 1. On the left menu, under **Manage**, select **Dev box pools**.
+
 1. On the toolbar, select **Create**.
-1. On the **Create pool** page, under **Management**, select **Enable single sign-on**.
 
-    :::image type="content" source="./media/how-to-enable-single-sign-on/create-pool-single-sign-on.png" alt-text="Screenshot that shows the Create a dev box pool page in Dev Box." lightbox="./media/how-to-enable-single-sign-on/create-pool-single-sign-on.png":::
+1. On the **Create a dev box pool** page, configure the required settings on the **Basics** tab and the **Management** tab.
 
-1. Enter the remaining details for your new pool, and select **Create**.
+1. On the **Management** tab, under **Access**, select the **Enable single sign-on** option:
+
+   :::image type="content" source="./media/how-to-enable-single-sign-on/create-pool-single-sign-on.png" alt-text="Screenshot of the Management tab on the Create a dev box pool page with the Enable single sign-on option selected.":::
+
+1. Select **Create**.
 
 ### Enable SSO for an existing pool
 
 To enable SSO for dev boxes in an existing pool, follow these steps:
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
-1. In the search box, enter **projects**.
+
+1. In the search box, enter _projects_.
+
 1. In the list of results, select **Projects**.
+
 1. Select the project that contains the pool for which you want to enable SSO.
+
 1. On the left menu, under **Manage**, select **Dev box pools**.
-1. Select the pool for which you want to enable SSO.
-1. On the line for the pool, select the ellipsis (**...**) and then select **Edit**.
+
+1. Select the pool for which you want to disable SSO, select **More actions** (**...**), and then select **Edit**:
 
-   :::image type="content" source="media/how-to-enable-single-sign-on/azure-portal-pool-edit.png" alt-text="Screenshot that shows the Azure portal with the list of pools in a project with the menu and Edit option highlighted." lightbox="media/how-to-enable-single-sign-on/azure-portal-pool-edit.png":::
+   :::image type="content" source="media/how-to-enable-single-sign-on/azure-portal-pool-edit.png" alt-text="Screenshot that shows the list of pools in a project with the Edit (pencil) option highlighted." lightbox="media/how-to-enable-single-sign-on/azure-portal-pool-edit.png":::
+
+1. On the **Edit pool** page, on the **Management** tab, select the **Enable single sign-on** option:
 
-1. On the **Edit pool** page, under **Management**, select **Enable single sign-on** and then select **Save**.
+   :::image type="content" source="./media/how-to-enable-single-sign-on/edit-pool-single-sign-on.png" alt-text="Screenshot that shows the Edit pool page in Dev Box with Enable single sign-on highlighted.":::
 
-    :::image type="content" source="./media/how-to-enable-single-sign-on/edit-pool-single-sign-on.png" alt-text="Screenshot that shows the Edit pool page in Dev Box with Enable single sign-on highlighted." lightbox="./media/how-to-enable-single-sign-on/edit-pool-single-sign-on.png":::
+1. Select **Save**.
 
 ## Disable SSO for dev boxes
 
@@ -69,30 +83,37 @@ You can disable SSO for a pool at any time by clearing the **Enable single sign-
 To disable SSO for dev boxes in an existing pool, follow these steps:
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
-1. In the search box, enter **projects**.
+
+1. In the search box, enter _projects_.
+
 1. In the list of results, select **Projects**.
+
 1. Select the project that contains the pool for which you want to disable SSO.
+
 1. On the left menu, under **Manage**, select **Dev box pools**.
-1. Select the pool for which you want to disable SSO.
-1. On the line for the pool, select the ellipsis (**...**) and then select **Edit**.
 
-   :::image type="content" source="media/how-to-enable-single-sign-on/azure-portal-pool-edit.png" alt-text="Screenshot that shows the Azure portal with the list of pools in a project with the menu and Edit option highlighted." lightbox="media/how-to-enable-single-sign-on/azure-portal-pool-edit.png":::
+1. Select the pool for which you want to disable SSO, select **More actions** (**...**), and then select **Edit**:
+
+   :::image type="content" source="media/how-to-enable-single-sign-on/azure-portal-pool-edit.png" alt-text="Screenshot that shows the pools in a project with the Edit (pencil) option highlighted." lightbox="media/how-to-enable-single-sign-on/azure-portal-pool-edit.png":::
 
-1. On the **Edit pool** page, under **Management**, clear **Enable single sign-on** and select **Save**.
+1. On the **Edit pool** page, on the **Management** tab, clear the **Enable single sign-on** option:
 
-    :::image type="content" source="./media/how-to-enable-single-sign-on/edit-pool-single-sign-on.png" alt-text="Screenshot that shows the Edit pool page in Dev Box, with Enable single sign-on highlighted." lightbox="./media/how-to-enable-single-sign-on/edit-pool-single-sign-on.png":::
+   :::image type="content" source="./media/how-to-enable-single-sign-on/clear-pool-single-sign-on.png" alt-text="Screenshot that shows the Edit pool page with the Enable single sign-on option cleared.":::
+
+1. Select **Save**.
 
 If you disable SSO for a pool, new dev boxes created from that pool prompt the user for credentials. Existing dev boxes continue to use SSO.
 
 ## Understand the SSO user experience
 
-When SSO is enabled for a pool, your sign-on experience is:
+When SSO is enabled for a pool, here's a summary of your sign-on experience:
 
 - The first time you connect to a dev box with SSO enabled, you sign in to your physical machine. Then you connect to your dev box from the developer portal. When the dev box starts up, you must enter your credentials to access the dev box.
+
 - The next time you connect to your dev box, you don't have to enter your credentials.
 
-If your connection to your dev box is interrupted because your client machine goes to sleep, a message appears that explains the issue. To reconnect, select **Reconnect**. You don't have to reenter your credentials.
+- If your connection to your dev box is interrupted because your client machine goes to sleep, a message appears that explains the issue. To reconnect, select **Reconnect**. You don't have to reenter your credentials.
 
 ## Related content
 
-- [Configure single sign-on for Windows 365 by using Microsoft Entra authentication](/windows-365/enterprise/configure-single-sign-on)
+- [Configure SSO for Windows 365 with Microsoft Entra authentication](/windows-365/enterprise/configure-single-sign-on)