Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A Pure-Python Twisted library for LDAP

Project Description

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 = ''
   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
   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 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 --logfile=ldapserver.log \


Release History

This version
History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(164.0 kB) Copy SHA256 Hash SHA256
Wheel py2.py3 Jun 7, 2016
(273.4 kB) Copy SHA256 Hash SHA256
Source None Jun 7, 2016

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers