LDAP Authentication

LDAP is a type of software protocol that allows individual users and applications to find and verify whatever information they need within their organization. It would validate whether a user would have access or not, this validation is done by passing user’s credentials. In doing so, IT can point LDAP-enabled systems and applications (for example) to an associated LDAP directory database, which acts as the source of truth for authenticating user access.

In DNIF, users can login to DNIF Console using LDAP authentication and the following authentications are used:

  • NTLM: This type of authentication mode uses LDAP protocol with SSL enabled to communicate with microsoft active directory

  • Secured LDAP: This authentication mode uses the ldaps:// protocol over SSL encrypted port (typically 636) or the one specified in configuration.

  • Unencrypted: This authentication mode uses the ldap:// protocol over unencrypted port (typically 389) or the one specified in configuration.

Prerequisites

  • Connectivity between LDAP Server and DNIF console
  • A user must exist in DNIF and LDAP
  • User email in DNIF and LDAP should match.
  • User must be present in the configured baseDN and matching ldapfilter results

How to Configure LDAP authentication?

  • Navigate to Administration Panel > Organizations, the following screen will be displayed.

image 1-Dec-01-2023-09-00-08-2823-AM

  • Click on the plus sign on the top right corner of the page to add an organization.

image 2-Dec-01-2023-09-00-56-6707-AM

  • Enter an Organization name and click save, the saved organization name will be listed and will display as click to configure LDAP.

An Organization can be deleted only if no users are bound to it.

 image 3-Dec-01-2023-09-03-24-2387-AM

  • Click on the click to configure LDAP, the following screen will be dispalyed.

image 4-Dec-01-2023-09-03-51-2711-AM

  • Enter the following details.
Field Description
Host IP Enter bind IP of the LDAP Server
Host Port Enter bind Port of the LDAP Server
Auth Type Select an Auth Type from dropdown values: Supported Auth Types are [NTLM, Unencrypted, Secure LDAP]
Domain Enter Domain of the LDAP Server, this option is displayed only when auth type NTLM is selected.
Base Distinguished Name Enter Base Distinguished name for LDAP Server
LDAP Query Filter Enter LDAP query filters to search LDAP database
Email Field Enter the field name for email id stored in LDAP database
Account name Field Enter the field name for account name or login name stored in LDAP database
LDAP Username Enter a LDAP Username
Password Enter password for LDAP user enterred in LDAP username field
  • Enter all the above details and click save.

  • Once the configuration is successfully completed, it will be displayed as follows:

    image 5-Dec-01-2023-09-04-31-3956-AM

  • On successful configuration the LDAP users in the organization will be synced to DNIF.

Users should be manually added to the organization 

 image 6-Dec-01-2023-09-05-34-0901-AM
  • By default, sync will occur on 2 am UTC for organizations where LDAP is enabled.
  • On updating any user details, a manual sync should be done from the Organizations page.
  • Password Reset is not allowed for any LDAP users.
  • On the Manage Users page, an icon is added next to the username indicating that the user is an LDAP connected user.

image 7-Dec-01-2023-09-06-03-0309-AM

  • Once LDAP is configured for an organization, it is mandatory for all users belonging to that organization to use LDAP authentication.

 In case of connectivity issues between LDAP server and DNIF console, only a cluster admin user (created before enabling LDAP authentication) will be allowed to login using DNIF credentials.