Download from WordPress Marketplace:

• From your WordPress dashboard click on Plugins >> Add New

• Search for "miniOrange LDAP". Install the Active Directory Integration / LDAP Integration plugin.

• Once the installation is done, click on the Activate button to activate the plugin.

Install using ZIP file:

• From WordPress.org Download Active Directory Integration / LDAP Integration.

• Go to the Plugins section in the Dashboard and click on the Add New button.

• Click on the Upload Plugin.

• Click on the Choose File button and select the downloaded plugin ZIP file.

• Click on the Install Now button.

• Click on the Activate Plugin button.

• Now the Active Directory Integration / LDAP Integration plugin is installed and activated.

LDAP Connection Information

• Select Your Directory Server : Select your directory server from the dropdown.
• LDAP Server : Select the directory server protocol (LDAP/LDAPS) from the dropdown then enter the hostname or IP address of the directory server and select the server port number (389/636).
• Username : Enter the service account username.
• Password : Enter the password of the service account username.
• Click on the Test Connection & Save button to establish the connection with your LDAP server.

• Once the connection has successfully been made with your LDAP server, you can proceed with scrolling down to the LDAP User Mapping Configuration section.



LDAP User Mapping Configuration

• Search Base : Click on the Possible Search Bases / Base DNs button to see the list of possible search base(s) DNs and select the preferred search base from the list. You can also manually enter the search base if you want.
• Username Attribute : Select the LDAP Username Attribute from the dropdown. This will be the username for the LDAP users that log in to the WordPress website. You can also enter a custom LDAP Username Attribute by selecting the last option (Provide custom LDAP Attribute name).
• Click on the Save User Mapping button.



Test Authentication

• Test Authentication : Enter the username & password of any ldap user that exists in the configured serach base and test the ldap configuration.
• Click on the Test Authentication button.

• After successfully testing the authentication, proceed to the Role Mapping tab.

Default Role Mapping

• Select the default role from the dropdown list.
• Click on the Save Configuration button.
• Click on the Enable Role Mapping button.
• If you do not wish to override the current roles of the users present in your WordPress website, click on the Keep existing roles of users button.



Fetch Groups Information, LDAP Groups to WP User Role Mapping and Test Role Mapping Configuration these features are available in the premium version of our plugin.

• To configure the attributes click on the Attribute Mapping Tab.

Attribute Configuration

• The email attribute is the default configuration present in our Free plugin. The premium version of our plugin allows you to additionally configure different custom attributes. Enter the Email Attribute.
• In the Email domain, enter the email domain you would like to assign to the users whose email attribute is not already set in the Active Directory.
• Click on the Save Configuration button.



Adding Custom Attributes is a feature that is available in the premium version of our plugin.




Test Attribute Configuration

• To test the attribute configuration, you can enter a username of any user present in the Active directory. And click on the Test Configuration Button.

• After successfully configuring the attributes, proceed to the Sign-In Settings Tab.

Enable Login Using LDAP

• Simply click on the Enable LDAP login button. This will enable the users who are present in your Active Directory to log in to your WordPress website using their LDAP credentials.

• Enable Auto Registering users if they do not exist in WordPress: Enabling this button will allow you to auto-register the users present in your active directory into your WordPress database after they log in.

In the premium version of this plugin, You can authenticate WordPress users from both LDAP and WordPress.

Export Configuration

• Keep configuration upon uninstall : By clicking on this button, you will be able to export your plugin's configuration when you reinstall the plugin. This will save you the time of reconfiguring the plugin if you move it to another WordPress instance.
• Export Service Account password : Enabling this option will export the service account password in an encrypted fashion to the exported file.
• Click on Export configuration button to export the plugin configuration.


Import Configuration feature is available in the premium version of the plugin.

User Report

• The Authentication Report will inform you about the failed login attempts that have been made while users are trying to log in to your WordPress website. This is a useful security feature and will inform you if there have been any malicious attempts at logging into your WordPress website.
• Click on Log Authentication Requests button.

• You can export the failed login attempts report in a .csv file format.