Install the Identity Connect Agent
Prerequisites: Confirm your machine, account, and network meet the requirements in Prerequisites and Network Requirements before starting.
Step 1: Download the agent
- Sign in to Zoho Directory. Click Admin Panel from the left menu.
- Go to the Directory Stores tab. Click Add Directory.
- Find Active Directory and click Add.
- On the Download Agent screen:
- Review the prerequisites.
- Copy the Installation Key displayed there. You'll need this in Step 2.
- Click Download Agent and wait for the download to complete.
Step 2: Install the agent
- Execute the downloaded file ZohoDirectory_IdentityConnect.msi to start installation.
- Paste the Installation Key. Upon successful validation, you'll be taken automatically to the setup wizard.
- On the Welcome screen, choose your language.
- Read the software license agreement carefully, then accept the terms. Click Continue.
Note: Clicking the URL will not auto-redirect you to the page on some legacy systems. In this case, click 🔗 to copy the URL, then paste it into your browser to read the license agreement.
- Open the provided Login URL from a browser.
- Sign in to your Zoho Directory admin account if you haven't already.
- Enter the Verification Code shown in the installer.
- Upon successfully signing in, a confirmation screen with your Zoho account email and display name will appear. Click Continue.
- Once the agent is installed, continue to step 3.
Common errors at this step
Error | Fix |
The verification code is time-bound and becomes invalid after 5 minutes. | Click Retry to generate a new code, then sign in and proceed to configuring your LDAP settings. |
The agent can't contact the Zoho server due to a network issue or restrictive firewall policy. | Click Retry. If the error persists, contact support. |
Step 3: Configure LDAP connection details
This is a crucial step where the agent is allowed to connect with Active Directory to fetch user and group data for sync.
- Enter your directory info: Domain Name, Domain Controllers, User's Distinguished Name (DN), Password. Make sure they're all valid.
- Enable SSL for a secure connection (recommended because it safeguards sensitive directory data during transmission). Now, to use SSL:
- Your Domain Controller must have a valid SSL certificate issued to its domain.
- You must use the fully qualified domain name (FQDN) in the Domain Controller field (e.g., ldap-server-1.zylker.com). Using only the hostname will cause SSL failure.
- Click Next to review the LDAP configurations.
If you see the error "LDAP server goes unreachable," click Retry to attempt the connection again. Make sure there's no connectivity issue between the agent machine and LDAP server.Step 4: Complete installation
- Click Install to finish setting up the agent. Upon successful installation, the agent will be running.
Note: Ensure the agent machine maintains continuous network connectivity according to your organization's power-saving or login-based policies. - After installation, click
(the tray icon) to perform the following actions:
- Change ownership - Switch the Zoho Directory admin account linked to the agent in case the original admin leaves your organization or loses LDAP access.
- Change LDAP settings - Modify your LDAP server details here. After making changes, click Update to save them.
- Go back to the Zoho Directory Admin Panel to complete the remaining setup below.
Next: Configure Directory Sync
Access your files securely from anywhere
Zoho CRM Training Programs
Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.
Zoho DataPrep Personalized Demo
If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
Zoho FSM Video Tutorials
Centralize Knowledge. Transform Learning.
All-in-one knowledge management and training platform for your employees and customers.
New to Zoho Writer?
Create. Review. Publish.
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.
New to Zoho Survey?
Zoho Sheet Resources
Zoho Forms Resources
New to Zoho Sign?
Zoho Sign Resources
Sign, Paperless!
New to Zoho TeamInbox?
Zoho TeamInbox Resources
New to Zoho ZeptoMail?
Design. Discuss. Deliver.
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
New to Bigin?
Related Articles
Integrate Your On-premises LDAP Directory with Zoho Directory Identity Connect
Roles required to perform this action Organization admin Organization owner Zoho Directory Identity Connect (ZDIC) is an on-premises agent that connects your organization’s on-premises LDAP-based directories to Zoho Directory. It automates ...Integrate Your Active Directory with Zoho Directory Identity Connect - Overview
Roles required: Organization admin, Organization owner What is Zoho Directory Identity Connect? Zoho Directory Identity Connect is an on-premises agent that connects your organization's Active Directory to Zoho Directory. It enables automated ...Configure Password Sync Agent
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 ...Configure Directory Sync
Prerequisites: The Identity Connect Agent must already be installed - See Install the Identity Connect Agent. This article covers choosing what to sync and mapping fields correctly. Step 1: Select Organizational Units (OUs) From the Admin Panel, ...Zoho Directory Agent - Automatic Installation
Prerequisites Roles required to perform this action: Organization Owner Organization Admin Device Admin Admin in Endpoint Central account Overview The Zoho Directory agent connects each device to the organization's directory, ensuring that the device ...
New to Zoho LandingPage?
Zoho LandingPage Resources