Step By Step Guide To Configure miniOrange Directory Sync Add-On For WordPress

Step 1: Install miniOrange Directory Sync Add-on

From your WordPress dashboard

• Go to PluginsAdd New.

• Click on Upload Plugin and choose the downloaded plugin zip.





• After installing the Directory Sync Add-on, Activate the Add-on from your Plugins page.

Step 2: Setup miniOrange Directory Sync Add-on

• Once the add-on is activated, follow the steps mentioned below to configure Directory Sync Add-on:

Sync Options: In Directory Sync Add-on go to Sync options tab  to configure following Synchronization Options.

• RDN: Relative Distinguished Names(RDN) refers to the top-level component of an entry's Distinguished Name(DN).
  e.g. “uid=joy,ou=People,dc=example,dc=com”, the component “uid=joy” is often referred to as the RDN for that entry.

• Value of RDN: You can specify the value for Relative Distinguished Names(RDN) among Username, Email, First Name, Last Name, Full Name.

• Select Timezone: Select the timezone to run the sync according to your timezone.

• User Base: This is the LDAP Tree under which Directory Sync Add-on will search for the users. Provide the distinguished name(DN) of the User Base object.
  eg. cn=Users,dc=domain,dc=com.

• Object Class: Specify "user" as the type of the object present in directory system schema.

• Username Attribute: Specify which attribute will be mapped to wordpress username.
  e.g. samaccountname, mail, cn

• Delete User in LDAP when deleted in WordPess: This option is disabled by default. When you enable this option, if you delete any user from WordPress it will also get deleted from the LDAP.

• Unsync Wordpress Users not present in LDAP: By enabling this option, users which do not exist in LDAP, will be deleted from WordPress. It is recommended to keep this option disable unless the users in WordPress and LDAP are in perfect sync. Also when you click on save button, you will see the following options:

  1. Delete user from wordpress

  2. Change the role of the user

• LDAP to WP Sync Frequency: The LDAP to WP sync can be scheduled on Hourly, Daily or Twice Daily basis.

• Sync Interval: Delay between sync of two users. This is in milliseconds and the minimum value should be 10ms.

• Password Hash Algorithm: Algorithm used by directory system to hash the plaintext password.



WP to LDAP Sync: Sync the existing WordPress users to LDAP.

• In WP to LDAP Sync tab enter the range of id's of WordPress users and click on Sync Users.



• A list of users within selected range will be displayed where you can select the users you want to Sync from WordPress to LDAP and click on Sync Users. The Selected users will be synced to the configured Search Base.



LDAP to WP Scheduled Sync: The users present in LDAP Search Base will be Synced from LDAP to WordPress and the existing users will be updated.

• To enable Scheduled Sync, go to LDAP to WP Scheduled Sync tab and Enable Enable Scheduled sync and click on save setting after that click on Sync. To stop sync click on Stop Sync button.



WP to LDAP Sync Reports: This report shows the status of the last sync from WordPress to LDAP.