Introduction
The Sync LDAP User Directory Manager is a hybrid solution that allows you to make use of the user objects from your organization's LDAP server and maintaining organization structure (organization / department / group) locally inside Joget Workflow.
This plugin allows you to import user objects from LDAP server on demand into Joget Workflow's built in user directory manager to reduce its dependency on the LDAP server for improved performance.
The built in user directory manager is still the primary handler when this plugin is activated. Once you have synchronized the users to the local directory manager, you can assign the users to your organization/department/group/grade which created locally.
You can set the sync LDAP to run on a schedule, read Automatically synchronize LDAP based on schedule.
Sync Users
With the use of this plugin, we will be able to reduce the conventional load and dependency on the LDAP server and to only use it for authentication purpose.
The administrator of Joget Workflow will hit on the Sync Users button when required to perform synchronization with the LDAP server.
Sync LDAP Properties
Configuring Sync LDAP
| Name | Description / Sample Value | |
|---|---|---|
| URL |
Figure 1: Configure Sync LDAP | |
Admin Username (Principal) | cn=admin,dc=joget,dc=org | |
Admin Password (Credential) | admin | |
| Root DN | Set the root DB, for example "eg. DC=Joget,DC=org". | |
| Sync Organization | Clicking this checkbox to only sync a specific organization, will display additional options as follows:
| |
| Auto schedule sync? | Clicking this checkbox to automatically sync your LDAP on a schedule, will display additional options as follows:
|
User
| Name | Description / Sample Value | |
|---|---|---|
| User Base DN | Set the user base DN property. Tips If you set the "User Base DN" to your LDAP Root DN, it means that the search will start from the Root DN until it finds all the results that matched the search filter. So, setting the "User Base DN" precisely is very important as it will decide where the search is starting from. It will save all the unnecessary search between the Root DN to your "User Base DN". Root DN DC=joget,DC=org Under the Root DN, you have the following DN: 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 If your users are all under "DC=Users, DC=joget,DC=org", you should set this to "User Base DN". | |
| User Import Search Filter | (objectClass=person) Tips Value (&(objectClass=person)(|(cn=admin)(cn=cat)(cn=jack)(cn=john)(cn=jackie))) This mean all the LDAP entries which have "objectClass" attribute equals to "person" and "cn" attribute equals to either "admin", "cat", "jack", "john" or "jackie" are Joget users. So, when a login is performed by "admin", the search filter will add additional filter and become "(&(&(objectClass=person)(|(cn=admin)(cn=cat)(cn=jack)(cn=john)(cn=jackie)))(cn=admin))". You will notice an extra (cn=admin) is added to the search filter to make sure it return only the "admin" user. User License User license determines on how many eventual users (sorted alphabetically) from your LDAP/AD can log in into the system. You can make use of this attribute to control amount of users returned from your LDAP. More details below. | |
Attribute Mapping - Username | cn |
Figure 2: User Properties |
Attribute Mapping - First Name | givenName | |
Attribute Mapping - Last Name | sn | |
Attribute Mapping - Email | ||
Attribute Mapping - Status | status | |
Attribute Mapping - Time Zone | 8 | |
Attribute Mapping - Locale | en_US | |
| Attribute Mapping - Employee Code | employeeCode | |
| Attribute Mapping - Job Title | jobTitle |
Employment
| Name | Description / Sample Value | |
|---|---|---|
Result Size Per Paged Search | 100 |
Figure 3: Employment Properties |
| Debug Mode | Checked Tips The Debug Mode is highly recommended to be turned on when configuring the LDAP plugin for the first time. |
Related Documentation
Automatically synchronize LDAP based on schedule
Security Enhanced Directory Manager