This is optional but recommended. Skip this article if you don't need users to sign in to Zoho services using their Active Directory credentials in near-real time.
Prerequisites: This requires the Identity Connect Agent to already be installed and configured (see
Install the Identity Connect Agent and
Configure Directory Sync). Critically,
the LDAP account used for Identity Connect must have Domain Admin-level privileges for this step to work, i.e., read access alone (sufficient for base directory sync) is not enough.
How it works
The main Identity Connect Agent, when coupled with your Active Directory details, allows you to deploy multiple Password Sync Agents (one per Domain Controller) to instantly capture any password change made on these Domain Controllers and securely sync those changes to Zoho One.
Prerequisites for Password Sync Agent specifically
- Domain Admin-level LDAP account. The same account credentials provided during Identity Connect setup will be used for this installation.
- PowerShell remoting (WinRM) must be enabled on every Domain Controller where you plan to install the Password Sync Agent. You don't need to enable WinRM on Domain Controllers where the agent won't be installed. Learn how to enable WinRM
- SMB (Server Message Block) must be enabled on both the machine initiating the installation and the target Domain Controller, and ensure it is allowed through the firewall (SMB typically uses port 445). Learn how to detect and enable SMB
- The machine with the Identity Connect Agent must be bound to the Active Directory domain.
How installation works
The Zoho Directory Identity Connect agent transfers the Password Sync Agent installer file (ZohoDirectory_PasswordSynchronizer.msi) from the machine where the Zoho Directory Identity Connect Agent is installed to the selected Domain Controller over SMB. If SMB is disabled or blocked, the file transfer will fail and the installation cannot proceed. SMB is only required during this file transfer stage; once installation is complete, SMB is no longer required.
Steps to enable
- Enable the toggle to sync user passwords securely from Active Directory to Zoho One. (Domain Name is auto-filled based on the info entered during Identity Connect Agent installation.)
- Select the Domain Controllers where password sync is needed, and make sure all of them meet the exclusive requirements above.
- Select whether you want to auto-restart the Domain Controllers after installation. Regardless of your choice, the Password Sync Agent will only take effect after a Domain Controller restart.
If installation fails
If installation fails, the installer will only display "Installation failed." This is most commonly because one or more prerequisites are not met:
- The provided account doesn't have Domain Admin rights.
- WinRM is not enabled on the Domain Controller.
- The agent file could not be transferred to the Domain Controller because the SMB service is disabled on one of the machines or blocked by the firewall (port 445).
Fixing insufficient-privilege failures specifically
- Open the Identity Connect Agent (tray app) on the machine it's installed on.
- Update the directory credentials to an account with Domain Admin privileges.
- Save the changes and retry installing the Password Sync Agent from the Admin Panel.
- Updating the credentials does not require reinstalling the Identity Connect Agent. If installation continues to fail after verifying permissions, WinRM, and SMB availability, contact Zoho One Support for further assistance.
If a directory-synced user is deleted from Zoho One, password changes for that user in Active Directory will not sync unless the user is re-provisioned in Zoho One.
Once installed on multiple Domain Controllers, the Password Sync Agents work together under the same Identity Connect configuration, keeping all password updates in sync without extra manual steps.