Configure Drupal login using LDAP / Active Directory

Overview

The Drupal LDAP Login module allows your LDAP / Window Active Directory users to login to Drupal using their LDAP / Active Directory (AD) credentials. This module also supports Windows auto-login based on currently logged-in Windows users using the NTLM and Kerberos authentication protocol. We provide a Drupal LDAP / Active Directory Integration module compatible with Drupal 7, Drupal 8, Drupal 9, and Drupal 10.

The user’s LDAP Authentication can be performed on various LDAP servers like Microsoft Active Directory, OpenLDAP, Azure AD, JumpCloud, OpenDS, FreeIPA, Synology, and other Directory systems. Here we will go through the steps required to configure the LDAP Integration on your Drupal site. By the end of this guide your users can login to Drupal using their LDAP server credentials.

Installation Steps

• Using Composer
• Using Drush
• Manual Installation

• Download the module:

  composer require 'drupal/ldap_auth'

• Navigate to Extend menu on your Drupal admin console and search for miniOrange Active Directory / LDAP Integration using the search box.
• Enable the module by checking the checkbox and click on the Install button.
• You can configure the module at:

  {BaseURL}/admin/config/people/ldap_auth/ldap_config

• Install the module:

  drush en ldap_auth

• Clear the cache:

   drush cr

• You can configure the module at:

  {BaseURL}/admin/config/people/ldap_auth/ldap_config

• Navigate to Extend menu on your Drupal admin console and click on Install new module.
• Install the miniOrange Active Directory / LDAP Integration module either by downloading the zip or from the URL of the package (tar/zip).
• Click on Enable newly added modules.
• Enable this module by checking the checkbox and click on install button.
• You can configure the module at:

  {BaseURL}/admin/config/people/ldap_auth/ldap_config

Configuration Steps

Steps to Configure Drupal LDAP / Active Directory Integration module

• Once you enabled the module, navigate to Configuration ➔ miniOrange Active Directory / LDAP Integration as shown in the below image.

• Enter your LDAP Server URL, Bind Account DN and password, and click the Test Connection & Proceed button to test the connection. If you encounter any errors, please check the troubleshooting section.

• Select the appropriate search base from the Search Base(s) dropdown. Users located within this search base will be able to log in to your Drupal site using their LDAP credentials.
• Select the username attribute from the LDAP Username Attribute / Search Filter dropdown. This is the LDAP attribute that your LDAP users will use to log in to your Drupal website.
• Select the LDAP Email Attribute in which you get the email address of your LDAP users.

• Check the Enable login with LDAP checkbox to enable LDAP authentication on your site.
• Click the Save & Next button.

Test User LDAP Authentication

• After successfully saving the configuration, click on the Test Authentication button.

• Enter your LDAP user’s username and password, then click the Test Authentication button. Remember, the username should match the LDAP attribute value you selected in the search filter dropdown.
• For example, if you selected 'uid' in the search filter, enter the 'uid' of your LDAP user as the username.

• After successful authentication, you will receive a list of all LDAP attribute values associated with your user.

How to login to Drupal using LDAP credentials?

• Open a private/incognito window and go to your Drupal site login page.
• Enter the user's LDAP credentials. Remember, the username should match the LDAP attribute value you chose from the search filter dropdown.

After successful LDAP authentication, you will be able to access your Drupal site. If you face any error check the troubleshooting or reach out to us at drupalsupport@xecurify.com

Additional Features

 How to import users from LDAP / Active Directory to Drupal?

 Windows Authentication / Auto login - LDAP SSO - Kerberos Authentication

 Mapping user’s LDAP Groups to Drupal Roles

 LDAP Groups to Drupal Group Mapping

 Mapping LDAP attributes to Drupal user’s fields.