LDAP server, client and utilities, using Twisted Python
Latest commit d16f7f4 Jan 24, 2017 @cwaldbieser cwaldbieser committed on GitHub Merge pull request #71 from tonich-sh/fix-extensible-match
fixes #70 Assign correct types to LDAPMatchingRuleAssertion members.



Ldaptor is a pure-Python library that implements:

  • LDAP client logic
  • separately-accessible LDAP and BER protocol message generation/parsing
  • ASCII-format LDAP filter generation and parsing
  • LDIF format data generation
  • Samba password changing logic

Also included is a set of LDAP utilities for use from the command line.

Verbose documentation can be found on ReadTheDocs.

Quick Usage Example

from twisted.internet import reactor, defer
from ldaptor.protocols.ldap import ldapclient, ldapsyntax, ldapconnector

def example():
   serverip = ''
   basedn = 'dc=example,dc=com'
   binddn = 'bjensen@example.com'
   bindpw = 'secret'
   query = '(cn=Babs*)'
   c = ldapconnector.LDAPClientCreator(reactor, ldapclient.LDAPClient)
   overrides = {basedn: (serverip, 389)}
   client = yield c.connect(basedn, overrides=overrides)
   yield client.bind(binddn, bindpw)
   o = ldapsyntax.LDAPEntry(client, basedn)
   results = yield o.search(filterText=query)
   for entry in results:
      print entry

if __name__ == '__main__':
   df = example()
   df.addErrback(lambda err: err.printTraceback())
   df.addCallback(lambda _: reactor.stop())


Ldaptor can be installed using the standard command line method:

python setup.py install

or using pip from PyPI:

pip install ldaptor

Linux distributions may also have ready packaged versions of Ldaptor and Twisted. Debian and Ubuntu have quality Ldaptor packages that can be installed e.g., by:

apt-get install python-ldaptor

To run the LDAP server (runs on port 38942):

twistd -ny --pidfile=ldapserver.pid --logfile=ldapserver.log \