Skip to content

Commit 49a7fa0

Browse files
committed
[AzureAD-SSPR] Add clean-up steps, formatting updates
1 parent d257e64 commit 49a7fa0

File tree

1 file changed

+50
-24
lines changed

1 file changed

+50
-24
lines changed

articles/active-directory/authentication/tutorial-enable-sspr-writeback.md

Lines changed: 50 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,9 @@ ms.collection: M365-identity-device-management
1818
---
1919
# Tutorial: Enable Azure Active Directory self-service password reset writeback to an on-premises environment
2020

21-
With Azure Active Directory (Azure AD) self-service password reset (SSPR), users can update their password or unlock their account using a web browser. In a hybrid environment where Azure AD is connected to an on-premises Active Directory Domain Services (AD DS) environment, this scenario can cause passwords to be different between the two directories. Password writeback can be used to synchronize password changes in Azure AD back to your on-premises AD DS environment. Azure AD Connect provides a secure mechanism to send these password changes back to an existing on-premises directory from Azure AD.
21+
With Azure Active Directory (Azure AD) self-service password reset (SSPR), users can update their password or unlock their account using a web browser. In a hybrid environment where Azure AD is connected to an on-premises Active Directory Domain Services (AD DS) environment, this scenario can cause passwords to be different between the two directories.
22+
23+
Password writeback can be used to synchronize password changes in Azure AD back to your on-premises AD DS environment. Azure AD Connect provides a secure mechanism to send these password changes back to an existing on-premises directory from Azure AD.
2224

2325
In this tutorial, you learn how to:
2426

@@ -42,7 +44,9 @@ To complete this tutorial, you need the following resources and privileges:
4244

4345
## Configure account permissions for Azure AD Connect
4446

45-
Azure AD Connect lets you synchronize users, groups, and credential between an on-premises AD DS environment and Azure AD. You typically install Azure AD Connect on a Windows Server 2012 or later computer that's joined to the on-premises AD DS domain. The account specified in the Azure AD Connect utility must have the following items set to correctly work with SSPR writeback. If you're not sure which account is currently in use, open Azure AD Connect and select the **View current configuration** option. The account that you need to add permission to is listed under **Synchronized Directories**.
47+
Azure AD Connect lets you synchronize users, groups, and credential between an on-premises AD DS environment and Azure AD. You typically install Azure AD Connect on a Windows Server 2012 or later computer that's joined to the on-premises AD DS domain.
48+
49+
To correctly work with SSPR writeback, the account specified in Azure AD Connect must have the following permissions and options set. If you're not sure which account is currently in use, open Azure AD Connect and select the **View current configuration** option. The account that you need to add permissions to is listed under **Synchronized Directories**.
4650

4751
* **Reset password**
4852
* **Change password**
@@ -57,40 +61,42 @@ If don't assign these permissions, writeback appears to be configured correctly,
5761
To set up the appropriate permissions for password writeback to occur, complete the following steps:
5862

5963
1. In your on-premises AD DS environment, open **Active Directory Users and Computers** with an account that has the appropriate *domain administrator* permissions.
60-
2. From the **View** menu, make sure that **Advanced features** are turned on.
61-
3. In the left panel, right-select the object that represents the root of the domain and select **Properties** > **Security** > **Advanced**.
62-
4. From the **Permissions** tab, select **Add**.
63-
5. Pick the account that permissions should be applied to (the account used by Azure AD Connect).
64-
6. In the **Applies to** drop-down list, select **Descendant User objects**.
65-
7. Under **Permissions**, select the boxes for the following options:
64+
1. From the **View** menu, make sure that **Advanced features** are turned on.
65+
1. In the left panel, right-select the object that represents the root of the domain and select **Properties** > **Security** > **Advanced**.
66+
1. From the **Permissions** tab, select **Add**.
67+
1. Pick the account that permissions should be applied to (the account used by Azure AD Connect).
68+
1. In the **Applies to** drop-down list, select **Descendant User objects**.
69+
1. Under **Permissions**, select the boxes for the following options:
6670
* **Change password**
6771
* **Reset password**
68-
8. Under **Properties**, select the boxes for the following options:
72+
1. Under **Properties**, select the boxes for the following options:
6973
* **Write lockoutTime**
7074
* **Write pwdLastSet**
71-
9. Select **Apply/OK** to apply the changes and exit any open dialog boxes.
75+
1. Select **Apply/OK** to apply the changes and exit any open dialog boxes.
7276

7377
When you update permissions, it might take up to an hour or more for these permissions to replicate to all the objects in your directory.
7478

75-
Password policies in the on-premises AD DS environment may prevent password resets from being correctly processed. For password writeback to work correctly, group policy for *Minimum password age* must be set to 0. This setting can be found under **Computer Configuration > Policies > Windows Settings > Security Settings > Account Policies** within `gpedit.msc`. If you update the group policy, wait for the updated policy to replicate, or use the `gpupdate /force` command.
79+
Password policies in the on-premises AD DS environment may prevent password resets from being correctly processed. For password writeback to work correctly, group policy for *Minimum password age* must be set to 0. This setting can be found under **Computer Configuration > Policies > Windows Settings > Security Settings > Account Policies** within `gpedit.msc`.
80+
81+
If you update the group policy, wait for the updated policy to replicate, or use the `gpupdate /force` command.
7682

7783
## Enable password writeback in Azure AD Connect
7884

79-
One of the configuration options in Azure AD Connect is for password writeback. When this option is enabled, self-service password reset events cause Azure AD Connect to synchronize the updated credentials back to the on-premises AD DS environment.
85+
One of the configuration options in Azure AD Connect is for password writeback. When this option is enabled, password change events cause Azure AD Connect to synchronize the updated credentials back to the on-premises AD DS environment.
8086

81-
To enable self-service password reset writeback, enable the writeback in Azure AD Connect. From your Azure AD Connect server, complete the following steps:
87+
To enable self-service password reset writeback, first enable the writeback option in Azure AD Connect. From your Azure AD Connect server, complete the following steps:
8288

8389
1. Sign in to your Azure AD Connect server and start the **Azure AD Connect** configuration wizard.
84-
2. On the **Welcome** page, select **Configure**.
85-
3. On the **Additional tasks** page, select **Customize synchronization options**, and then select **Next**.
86-
4. On the **Connect to Azure AD** page, enter a global administrator credential for your Azure tenant, and then select **Next**.
87-
5. On the **Connect directories** and **Domain/OU** filtering pages, select **Next**.
88-
6. On the **Optional features** page, select the box next to **Password writeback** and select **Next**.
90+
1. On the **Welcome** page, select **Configure**.
91+
1. On the **Additional tasks** page, select **Customize synchronization options**, and then select **Next**.
92+
1. On the **Connect to Azure AD** page, enter a global administrator credential for your Azure tenant, and then select **Next**.
93+
1. On the **Connect directories** and **Domain/OU** filtering pages, select **Next**.
94+
1. On the **Optional features** page, select the box next to **Password writeback** and select **Next**.
8995

9096
![Configure Azure AD Connect for password writeback](media/tutorial-enable-sspr-writeback/enable-password-writeback.png)
9197

92-
7. On the **Ready to configure** page, select **Configure** and wait for the process to finish.
93-
8. When you see the configuration finish, select **Exit**.
98+
1. On the **Ready to configure** page, select **Configure** and wait for the process to finish.
99+
1. When you see the configuration finish, select **Exit**.
94100

95101
## Enable password writeback for SSPR
96102

@@ -99,13 +105,33 @@ With password writeback enabled in Azure AD Connect, now configure Azure AD SSPR
99105
To enable password writeback in SSPR, complete the following steps:
100106

101107
1. Sign in to the [Azure portal](https://portal.azure.com) using a global administrator account.
102-
2. Search for and select **Azure Active Directory**, select **Password reset**, then choose **On-premises integration**.
103-
3. Set the option for **Write back passwords to your on-premises directory?** to *Yes*.
104-
4. Set the option for **Allow users to unlock accounts without resetting their password?** to *Yes*.
108+
1. Search for and select **Azure Active Directory**, select **Password reset**, then choose **On-premises integration**.
109+
1. Set the option for **Write back passwords to your on-premises directory?** to *Yes*.
110+
1. Set the option for **Allow users to unlock accounts without resetting their password?** to *Yes*.
105111

106112
![Enable Azure AD self-service password reset for password writeback](media/tutorial-enable-sspr-writeback/enable-sspr-writeback.png)
107113

108-
5. When ready, select **Save**.
114+
1. When ready, select **Save**.
115+
116+
## Clean up resources
117+
118+
If you no longer want to use the SSPR writeback functionality you have configured as part of this tutorial, complete the following steps:
119+
120+
1. Sign in to the [Azure portal](https://portal.azure.com).
121+
1. Search for and select **Azure Active Directory**, select **Password reset**, then choose **On-premises integration**.
122+
1. Set the option for **Write back passwords to your on-premises directory?** to *No*.
123+
1. Set the option for **Allow users to unlock accounts without resetting their password?** to *No*.
124+
125+
If you no longer want to use any password functionality, complete the following steps from your Azure AD Connect server:
126+
127+
1. Sign in to your Azure AD Connect server and start the **Azure AD Connect** configuration wizard.
128+
1. On the **Welcome** page, select **Configure**.
129+
1. On the **Additional tasks** page, select **Customize synchronization options**, and then select **Next**.
130+
1. On the **Connect to Azure AD** page, enter a global administrator credential for your Azure tenant, and then select **Next**.
131+
1. On the **Connect directories** and **Domain/OU** filtering pages, select **Next**.
132+
1. On the **Optional features** page, deselect the box next to **Password writeback** and select **Next**.
133+
1. On the **Ready to configure** page, select **Configure** and wait for the process to finish.
134+
1. When you see the configuration finish, select **Exit**.
109135

110136
## Next steps
111137

0 commit comments

Comments
 (0)