Skip to content
A thin wrapper over ldapjs to give a promise interface and authentication helpers.
Branch: master
Clone or download
Stewart MacKenzie-Leigh
Stewart MacKenzie-Leigh Update ldapjs version
Latest commit f9eb1bc Mar 2, 2016
Type Name Latest commit message Commit time
Failed to load latest commit information.


This library is a quick-n-dirty shim over ldapjs to add promises and easier authentication. It currently only supports the client interface.


To create a new client:

var LdapClient = require('promised-ldap');
var client = new LdapClient({url: 'ldap://'});

The options argument to the constructor is identical to the options argument used in ldapjs for ldap.createClient. Please see the docs here.

It supports the other methods documented there as well, except that instead of taking a callback, the methods return a promise. E.g.:

client.bind('username', 'password').then(function () { ... });

The search method in ldapjs is now accessible (in promisified form) by client._search. I have provided a method with similar behaviour as the original but an arguably easier API. E.g.:, options).then(function (result) {
  /* result is:
    entries: [...],
    references: [...]
  no messing about with EventEmitters!

Let's face it, the reason why you're messing about with LDAP is probably to add LDAP authentication to your app, so I've added a couple of helper method for this:

client.authenticate(base, cn, password).then(function (result) {
  // if the authentication succeeded, then result is the LDAP user object
  // otherwise, it is null

This basically does a bind using the supplied credentials, and if successful, does a search for the specified user and returns that.

If all you really wanted was the user's name, email address, and list of unqualified groups, we can do that too:

client.authenticateUser(base, cn, password).then(function (result) {
  if the authentication succeeded, then result is:
    name: <the user's DisplayName>,
    email: <the user's PrincipalName>,
    groups: <an array of the CNs of groups which are in the base CN>
  otherwise, result is null

Pull requests and suggestions are welcome!

You can’t perform that action at this time.