Using the Built in LDAP Authentication Service

When LDAP authentication is enabled, FTL server delegates authentication requests to the LDAP server.

To enable LDAP authentication, ensure that the "auth.providers" parameter in the FTL server configuration file contains an LDAP URL. The URL can be either ldap://<host>:<port>, or ldaps://<host>:<port>.

In addition, configure the ldap.config parameter in the FTL server yaml configuration file. This file contains configuration for connecting to the LDAP server.

For details, see FTL Server Configuration Parameters.

For an example, see samples/yaml/ldap in the FTL installation directory.

Table here shows various ldap authentication service related parameters to be specified in the file specified in ldap.config

LDAP Configuration name Type Examples Description
ldap.user.basedn String ou=People,dc=ftl Based DN used to search for ldap users
ldap.user.scope String ldap_user_scope

The scope of the search. Valid values include:

  • onelevel

  • subtree

  • object

The default is to use a one level search.

ldap.user.class String ldap_user_class Criteria used for user search. What class indicates a user, what attribute contains a user's unique identifier Unless ldap.group.filter is specified, default search filter is auto generated from relevant configuration parameters
ldap.user.attribute String uid The attribute that is compared to the user name for the search. The default is uid.
ldap.user.filter String  

The filter used when searching for a user.

 

If a more complex filter is needed, use this property to override the default.

Any occurrence of {0} in the search string is the user attribute, and {1} is replaced with the user name.

The default is {0}={1}

ldap.group.basedn String ou=Groups,dc=ftl The base path for the LDAP static group search. If null or not set, static groups are not searched.
ldap.group.scope String subtree

The scope of the static group search. Valid values include onelevel, subtree, and object.

Default is to use a subtree search.

ldap.group.filter String   Criteria used for static group search, similar to that used for user search Unless ldap.group.filter is specified, default search filter is autogenerated from relevant configuration parameters

ldap.group.static.class

String groupofuniquenames  
ldap.group.static.attribute String cn The attribute of a static LDAP group that contains the group name. Default is cn.
ldap.group.static.member.attribute String uniqueMember The attribute ID of a dynamic LDAP group object that specifies the name of members of the group. Default is uniqueMember.