LDAP

LDAP integration

LDAP stands for Lightweight Directory Access Protocol. It is an application protocol used over an IP network to manage and access the distributed directory information service. The primary purpose of a directory service is to provide a systematic set of records, usually organized in a hierarchical structure.

How can you use it?

• Import agents from LDAP directory structure
• Login agents using authentication against LDAP service (using agent email and password from LDAP)
• Fallback authentication - If LDAP service is not available, LiveAgent will use its own default auth method.

Note: Only agents with filled email fields can be imported into LiveAgent.

How to activate LDAP plugin

To activate your LDAP plugin, please follow the instructions below:

1. Activate the LDAP extension inside LiveAgent. Go to Configuration → System → Plugins and activate the plugin named “LDAP.”

2. LiveAgent will restart, and you will see a new options menu → Configuration → LDAP. The configuration window will look like this:

3. Fill in all the required fields (except ‘LDAP server port’ which is optional):

   • LDAP server URL: This is your LDAP service URL.
   • LDAP server port: Optional, determine LDAP service custom port
   • Base DN: Your base directory. Example: dc=example,dc=com
   • User ID field: Name of the field that uniquely identifies every user in LDAP structure. Usually, this can be cn or uid.
   • User email field: This is the name of the field which contains email for the user in LDAP structure. Example: mail

   Note: The mail field must contain valid email, otherwise users cannot be imported into LiveAgent as agents. If the user has more than one email, only the first email is used as an identifier in LiveAgent.

4. Save your settings. New options will appear just under the save button.

Benefits of LDAP Integration

• Streamlined agent management - Import agents directly from your LDAP directory
• Centralized authentication - Agents can log in using their LDAP credentials
• Reduced manual work - Avoid manual agent creation and data entry errors
• Enterprise-ready - Perfect for organizations with existing LDAP infrastructure
• Flexible configuration - Customize field mappings to match your directory structure