--- title: "LDAP provider settings" slug: "ldap-settings-v7-0" description: "Configure your LDAP server for secure communication with SSL, manage user accounts, and set password warnings for enhanced security and performance." tags: ["IdP Configuration", "LDAP Provider", "Identity Providers"] updated: 2026-10-05T19:18:14Z published: 2026-10-05T19:18:14Z canonical: "support.appgate.com/ldap-settings-v7-0" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.appgate.com/llms.txt > Use this file to discover all available pages before exploring further. # LDAP provider settings > [!NOTE] > NOTE > > Ensure that your LDAP server is configured for encrypted communication. If SSL is enabled and the LDAP server has a valid certificate, the Controller automatically establishes an encrypted session with the directory server. Complete the following fields in the **LDAP Configuration** section of the **Add/Edit Identity Provider** page: - ***Hostnames or IP Addresses.*** Enter one or more hosts. If more then one host is entered, AppGate ZTNA choose one at random. This provides load balancing and failover. All remaining settings are assumed to be the same for all LDAP hosts. - ***Port.*** Enter 389 for LDAP or 636 for LDAP over SSL. - ***Enable SSL.*** SSL (LDAPS) is recommended. To use SSL, upload an X.509 public key certificate to **Trusted Certificates** (System > Trusted Certificates). - ***Service Account DN.*** The Service account must have the minimum rights required to read the tree below the base DN. For example: "CN=Administrator, OU=Admins, OU=Users, DC=corp, DC=yourdomain, DC=com" - ***Service Account Password.*** Password for the service account user. - ***Base DN.*** Distinguished Name of the user search base. This limits the scope of the user search to improve performance by avoiding searches across the entire directory. - ***User Filter.*** Include or exclude groups of user accounts. For example, “All disabled user objects” or “All users with ‘Password Never Expires’ set”. The following page provides more examples: [https://social.technet.microsoft.com](https://social.technet.microsoft.com) - ***Username Attribute.*** Attribute name of the username field. Defaults to `sAMAccountName` in Active Directory. - ***Membership Filter.*** Filter used when retrieving the user’s nested groups in Active Directory. Defaults to `(objectCategory=group)`. - ***Membership Base DN.*** Distinguished Name of the group search base in Active Directory. This limits the scope of the membership query to improve performance. Defaults to the *Base DN* setting. - ***Enable password warning.*** For Active Directory, enable this to warn users when their passwords are about to expire. - *Threshold (days).* Number of days before expiration to display the warning. - *Message.* Message displayed to the user. Use this field to tell users how to change their passwords. The expiration time is displayed in the client in a separate section. The Password Warning Message supports HTML. For example: `Your Company Domain password is about to expire </br><a href="https://iam-passwd.corp.company.com">Click here to update it.</a>` A system user claim (`ag.passwordWarning`) is provided. Use this claim in a condition to allow extra network access while the warning is active. This can give remote users sufficient access rights to reset their passwords without coming in to the office. Two possible methods for password renewals are: - WebAccess expired password reset option (Windows Server 2012R2 or Server 2016): [Windows Server 2012 RDS: Enabling the RD WebAccess Expired password reset option](https://social.technet.microsoft.com/wiki/contents/articles/10755.windows-server-2012-rds-enabling-the-rd-webaccess-expired-password-reset-option.aspx) - On Windows, if sufficient network access rights are allowed (see [Allowing full, network-like access for users](/v1/docs/allowing-full-network-like-access-for-users-v7-0)), the reset password option should work when a user presses CTRL + ALT + DEL.