Lightweight Directory Access Protocol (LDAP) is commonly used protocols in organizations to centralize user information, authentication, and authorization. Rocket.Chat supports LDAP integration, allowing seamless connection with Active Directory (AD) or other identity management systems, while ensuring secure transmission of sensitive data.
This section explains LDAP features and guides you through setup and configuration.
Key features of LDAP integration
Data Accessibility: Provides a gateway to access and sync user data across systems, ensuring consistent and up-to-date information.
Background Sync: Keeps user data synchronized automatically; changes in LDAP are reflected in Rocket.Chat without manual intervention.
Role Mapping from Groups: Automatically assigns roles in Rocket.Chat based on LDAP group memberships, simplifying permission management.
Auto-Logout: Enhances security by logging out users automatically when specific LDAP conditions are met.
Advanced User Data Sync: Synchronizes additional user attributes and settings for consistent integration.
For an overview of LDAP features available by plan, see Authentication Across Plans guide.
Configure LDAP authentication
To configure LDAP, go to Administration > Workspace > Settings > LDAP, enable LDAP, and add the required configurations to connect with your LDAP server.
LDAP quick actions
At the top of the LDAP settings page, you can access the following quick actions:
Test Connection: Tests authentication and encryption using the values you provided. This does not test syncing.
Test LDAP Search: Searches for a user based on your configured search parameters and notifies you if a match is found.
Sync Now: Immediately syncs LDAP data according to your Data Sync configurations.
LDAP Documentation: Opens the official Rocket.Chat LDAP documentation for additional reference.
These quick actions are available only on Rocket.Chat premium plans.
If no alert appears after running an action, check the Reports log to confirm success or troubleshoot errors.
LDAP integration with Rocket.Chat simplifies user management, strengthens security, and ensures consistent data across your ecosystem. The following sections provide step-by-step instructions to help you configure LDAP in your workspace.