--- title: "Register LDAP servers" slug: "register-ldap-servers" tags: ["Product Usage", "ePolicy Orchestrator – On-prem", "ePO 5.10.x", "ePO 5.10.0"] updated: 2026-09-08T10:19:40Z published: 2026-09-08T10:19:40Z canonical: "docs.trellix.com/register-ldap-servers" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Register LDAP servers You must have a registered LDAP (Lightweight Directory Access Protocol) server to use Policy Assignment Rules, to enable dynamically assigned permission sets, and to enable Active Directory User Login. > [!WARNING] > Important > > ePO - On-prem only supports Microsoft Active Directory to synchronize and import systems into the **System Tree**, apply policies on those systems, and apply user-based policies based on LDAP users and groups. No other LDAP server types are supported. For details about product features, usage, and best practices, click ? or Help. 1. Select **Menu** → **Configuration** → **Registered Servers**, then click **New Server**. 2. From the **Server type** menu on the **Description** page, select **LDAP Server**, specify a unique name and any details, then click **Next**. 3. Choose whether you are registering an OpenLDAP or Active Directory server in the **LDAP server type** list. > [!NOTE] > Note > > The rest of these instructions assume that an Active Directory server is being configured. OpenLDAP-specific information is included where required. 4. Choose if you are specifying a Domain name or a specific server name in the **Server name** section. Use DNS-style domain names. For example, `internaldomain.com` and fully qualified domain names or IP addresses for servers, and `server1.internaldomain.com` or 192.168.75.101. Using domain names gives failover support, and allows you to choose only servers from a specific site if wanted. > [!NOTE] > Note > > You must use server names with OpenLDAP servers. You can't use domain names with OpenLDAP servers. 5. Choose if you want to **Use Global Catalog**. This option is deselected by default. Selecting **Use Global Catalog** can provide significant performance benefits. Only select this option if the registered domain is the parent of only local domains. If non-local domains are included, chasing referrals could cause significant non-local network traffic, possibly severely impacting performance. > [!NOTE] > Note > > **Use Global Catalog** is not available for OpenLDAP servers. 6. If you have chosen to not use the Global Catalog, choose whether to **Chase referrals** or not. Chasing referrals can cause performance problems if it leads to non-local network traffic, whether a Global Catalog is used. 7. Choose whether to **Use SSL** when communicating with this server or not. 8. If you are configuring an OpenLDAP server, enter the **Port**. 9. Enter the **User name** and **Password**. A Domain Admin account is recommended as it covers all required permissions. To assign specific access rights instead of full Domain Admin privileges, see [KB79316](https://support.trellix.com/s/article/KB79316). - **Active Directory**: Use `domain\username` format. - **OpenLDAP**: Use `cn=User,dc=realm,dc=com` format. 10. Either enter a **Site name** for the server, or select it by clicking **Browse** and navigating to it. 11. Click **Test Connection** to verify communication with the server as specified. Change information as needed. 12. Click **Save** to register the server.