Introduction

Cautions And Warnings

Do not lock yourself out when you are configuring any Directory Manager plugin. Keep your browser session open and perform actual test in other machine/browser so that in case of any wrong configurations used, you can still continue to make amends.

User license determines how many eventual users (sorted alphabetically by username in ascending order) from your LDAP/AD who can login to the systemJoget. Make sure that you configure the plugin accordingly.

In case you have a misconfiguration and cannot login, you can make use of the credential set above ( Admin Username (Principal) & Admin Password (Credential) ) to login as the administrator.

The LDAP Directory Manager has a Debug Mode (option in the last tab) which is highly recommended to be turned on when configuring the LDAP plugin for the first time or when you are having issues. When debug mode is on, you can find all the search queries performed by the directory manager. They will all be logged into the joget.log files. From there, you can observe the search filter string and improve the accuracy and performance of the lookup. You can remove the debug checkbox once everything is running well.

LDAP Directory Manager Properties

Configure LDAP Directory Manager

Image Added
Figure 1: Configure LDAP Directory Manager

Users

Image Added
Figure 2: Users Properties

DC=joget,DC=org

DC=HR,DC=joget,DC=org
DC=Product Department,DC=joget,DC=org
DC=Operation,DC=joget,DC=org
DC=Users,DC=joget,DC=org

(&(objectClass=person)(|(cn=admin)(cn=cat)(cn=jack)(cn=john)(cn=jackie)))

Employment

Image AddedUser

Figure 3: Employment Properties

Image Removed

Figure 3: Employment Properties

Name	Value	Screen (Click to view)
Attribute Mapping - Employee Code
Attribute Mapping - Job Title
Attribute Mapping - Report To
Map To "Report To" Entry Attribute
Attribute Mapping - Groups
Map To LDAP Group Entry Primary Attribute	dn Info title DN A distinguished name (usually just shortened to “DN”) uniquely identifies an entry and describes its position in the DIT. ... DNs are comprised of zero or more comma-separated components called relative distinguished names, or RDNs. Directory Service DN Entity Name OpenLDAP entryDN Microsoft AD distinguishedName
Attribute Mapping - Departments
Map To LDAP Department Entry Primary Attribute	dn
Attribute Mapping - Grade
Map To LDAP Grade Entry Primary Attribute	dn

...

Attribute Mapping - Metas

Additional attributes to retrieve using #user.USERNAME.meta.KEY# or #currentUser.meta.KEY# Name

ValueScreen (Click to view)

Group Base DN

Image Removed

Description Key Key name Attribute Attribute name in LDAP

Group

Image Added
Figure 4: Group Properties

Department

Image Added
Figure 5: Department Properties

Image RemovedFigure 5: Properties

Name	Value	Screen (Click to view)
Department Base DN
Department	Department Import Search Filter	(objectClass=groupOfNames) Please refer to other LDAP Search Filter syntax.
Attribute Mapping - ID	cn
Attribute Mapping - Name	description
Attribute Mapping - Description	description
Attribute Mapping - HOD	owner
Attribute Mapping - Users	member Info title Tips If the department object itself contains the users that belong to the department, define the attribute name here. For example, in the figure below, we can define "member" as the value here. There's no need to define anything else in "Employment" tab earlier for this case. Image Modified
Map To LDAP User Entry Primary Attribute	dn

Grade

Image Added
Figure 6: Grade Properties

Admin Role

Image Added
Figure 7: Admin Role Properties

Advanced

Image Added
Figure 8: Advance Properties

Configuring The User Import Search Filter

The following articles might be useful to you to understand how to filter users based on the groups in LDAP:

• https://flylib.com/books/en/1.434.1/optimizing_search_performance.html
• https://stackoverflow.com/questions/9890049/ldap-query-to-list-all-users-of-a-certain-group
• https://stackoverflow.com/questions/17664101/ldap-list-all-users-in-specific-groups
• https://stackoverflow.com/questions/48361525/ldap-query-to-retrieve-members-of-a-group
• LDAP Search Filter Syntax: https://docs.microsoft.com/en-us/windows/desktop/adsi/search-filter-syntax

You can use the pipe symbol '|' to denotes 'OR' and include a second (or more) search parameters, for example:

(|(objectClass=person)(objectClass=user))

Related Documentation

Sync LDAP User Directory Manager