Skip to content

Commit 228103a

Browse files
author
RoseHJM
committed
Added create section
1 parent 4980a58 commit 228103a

File tree

2 files changed

+20
-4
lines changed

2 files changed

+20
-4
lines changed

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

Lines changed: 20 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,25 @@ Single sign-on is enabled at the pool level. Dev Box supports single sign-on for
2828

2929
When you enable SSO for a pool, all new dev boxes created from that pool use SSO. Existing dev boxes continue to use the existing sign-on method. You can enable single sign-on for dev boxes as you create a pool, or an existing pool.
3030

31-
To enable SSO for dev boxes in a pool, follow these steps:
31+
### Enable SSO when creating a new pool
32+
33+
To enable SSO for dev boxes in an existing pool, follow these steps:
34+
35+
1. Sign in to the [Azure portal](https://portal.azure.com).
36+
1. In the search box, enter *projects*.
37+
1. In the list of results, select **Projects**.
38+
1. Select the project in which you want to create the pool.
39+
1. In the left menu, under **Manage**, select **Dev box pools**.
40+
1. In the toolbar, select **Create**
41+
1. On the **Create pool** page, under **Management**, select **Enable single sign-on**.
42+
43+
:::image type="content" source="./media/how-to-enable-single-sign-on/create-pool-single-sign-on.png" alt-text="Screenshot that shows the Create pool page in Microsoft Dev Box.":::
44+
45+
1. Enter the remaining details for your new pool, and then select **Create**.
46+
47+
### Enable SSO for an existing pool
48+
49+
To enable SSO for dev boxes in an existing pool, follow these steps:
3250

3351
1. Sign in to the [Azure portal](https://portal.azure.com).
3452
1. In the search box, enter *projects*.
@@ -44,15 +62,13 @@ To enable SSO for dev boxes in a pool, follow these steps:
4462

4563
:::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 Microsoft Dev Box.":::
4664

47-
When single sign-on is enabled for a pool, new dev boxes created from that pool use SSO. Existing dev boxes continue to use the existing sign-on method.
48-
4965
## Disable SSO for dev boxes
5066

5167
You can disable SSO for a pool at any time by deselecting the **Enable single sign-on** option on the **Edit pool** page.
5268

5369
If you disable single sign-on for a pool, new dev boxes created from that pool prompt the user for credentials. Existing dev boxes continue to use SSO.
5470

55-
## Understand the user experience
71+
## Understand the SSO user experience
5672

5773
When single sign-on is enabled for a pool, your sign-on experience is as follows:
5874

51.9 KB
Loading

0 commit comments

Comments
 (0)