Skip to main content
Skip table of contents

LDAP Configuration

The LDAP configuration is stored in the Centro database. Users edit the LDAP configuration(s) from the Centro UI within the Admin Area and allows testing of a configuration with a push of a button.


A new permission, Can access LDAP administration, exists that allows a user or role to see the LDAP tab within the Admin area. This is disabled for all roles and users by default so this must be enabled for a user(s) or roll(s) to use LDAP.

LDAP Instance

Organize and manage your LDAP configurations (esp in a multi-location environment) by creating separate instances.

To create an instance,

  1. Click Create a new instance to start a new LDAP instance.

  2. Select the directory type.

  3. Enter a name and description for the instance.

LDAP Configuration

Create a configuration to connect to your user directory.

To create an LDAP configuration,

  1. Click Add new configuration for this instance.

  2. Fill out parameters based on your "Directory" settings

NOTE: Take into account case sensitivity

Example: ldap:// may fail, but LDAP:// may work

Specifying a Port

Your organization may use a port for LDAP that differs from the default (389). To specify an LDAP port,

  1. Find the Root URL field.

  2. Add a colon + port number behind the domain name.

Note: when a port number is not specified, the default port 389 is used.

Testing Configurations

Validate your LDAP configuration easier by clicking the Test button to immediately detect if Centro connects correctly.

When creating or editing an LDAP configuration, click Test configuration.

If successful, the button will indicate so and turn green.

Otherwise the test fails. Review your values and test again.

Be sure to click the "Save" button.

Disabling Configurations

Disable a configuration to disable all users for that configuration quickly and easily.

A user attempting to login under a disabled LDAP configuration receives the following error.

Tip: For multiple configurations in the same domain that have imported separate group of users, keep the configurations in separate LDAP instances.

Deleting Configurations

Remove unnecessary configurations to clear any clutter. Deleting a configuration permanently removes it so use with caution.

Te delete an LDAP configuration,

  1. Click on the associated Remove button.

  2. Click Yes to confirm the deletion.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.