LDAP Properties


Defines if the LDAP authentication is enabled.

Default value: true


Defines a list of roles that will be assigned to every user after successful authentication.

Example: jmix.ldap.default-roles = ui-minimal, ui-filter


Defines a source of the UserDetails objects returned after successful authentication.

Possible values:

  • app - UserDetails obtained from the primary UserDetailsService of the application, typically from the database.

  • ldap - standard LdapUserDetails objects created by Spring Security.

Default value: app


Spesifies LDAP server URLs. LDAP URLs (SSL-secured) may be used as well, considering that Spring Security can connect to the server. Note that these URLs must not include the base DN. Multiple URLs can be specified in the comma-separated list. In this case, a connection will be established to any of the provided LDAP server URLs.

Example: ldap://ldap.company.com:389


Defines a base DN. If configured, all LDAP operations on contexts retrieved from this ContextSource relate to this DN. The default value is an empty distinguished name, that is, all operations relate to the directory root.


Indicates a DN used for authentication. This is normally the distinguished name of the "manager" user.


Defines a password for the "manager" user.


Defines search base for user searches. Used with jmix.ldap.user-search-filter.


An LDAP filter used to search for users. The substituted parameter is the user’s login name.

Example: (uid={0})


An LDAP attribute corresponding to the username. It is used during user synchronization to assign the correct username for the user.

Default value: uid


An attribute of the LDAP group corresponding to the authority name.

Default value: cn


Defines a search base for group searches.

The default value is an empty string.


If set to true, a subtree scope search will be performed. If false, a single-level search is used.

Default value: false


An LDAP filter used to search for user’s groups (optional). The substituted parameter is the user’s login name.

Default value: (uniqueMember={0})


Defines if Active Directory specific security configuration should be used instead of the default one.

Default value: false


Used only with the ActiveDirectory configuration. Specifies the Active Directory domain name.

Example: mydomain.com


A DN of the group containing users to be synchronized in the application.


Defines whether to save role assignments during user synchronization or not.

Default value: true


Defines a list of users that should always be authenticated with the standard authentication.

Default value: admin, system

Example: jmix.ldap.standard-authentication-users = admin, operator


Defines whether users are synchronized on every login. For example, if you want to load users from LDAP beforehand and synchronize them once a day on a scheduled task, set the property to false.

Default value: true


An LDAP group attribute to specify a group member.

Default value: uniqueMember