OpenLDAP

Template:Short description {{#invoke:Infobox|infobox}}Template:Template other{{#invoke:Check for unknown parameters | check | showblankpositional=1 | unknown = Template:Main other | preview = Page using Template:Infobox software with unknown parameter "_VALUE_"|ignoreblank=y | AsOf | author | background | bodystyle | caption | collapsetext | collapsible | developer | discontinued | engine | engines | genre | included with | language | language count | language footnote | latest preview date | latest preview version | latest release date | latest release version | latest_preview_date | latest_preview_version | latest_release_date | latest_release_version | licence | license | logo | logo alt | logo caption | logo upright | logo size | logo title | logo_alt | logo_caption | logo_upright | logo_size | logo_title | middleware | module | name | operating system | operating_system | other_names | platform | programming language | programming_language | released | replaced_by | replaces | repo | screenshot | screenshot alt | screenshot upright | screenshot size | screenshot title | screenshot_alt | screenshot_upright | screenshot_size | screenshot_title | service_name | size | standard | title | ver layout | website | qid }}Template:Main other

OpenLDAP is a free, open-source implementation of the Lightweight Directory Access Protocol (LDAP) developed by the OpenLDAP Project. It is released under its own BSD-style license called the OpenLDAP Public License.<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>

LDAP is a platform-independent protocol. Several common Linux distributions include OpenLDAP Software for LDAP support. The software also runs on BSD-variants, as well as AIX, Android, HP-UX, macOS, OpenVMS, Solaris, Microsoft Windows (NT and derivatives, e.g. 2000, XP, Vista, Windows 7, etc.), and z/OS.

History

The OpenLDAP project<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> was started in 1998 by Kurt Zeilenga.<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> The project started by cloning the LDAP reference source from the University of Michigan where a long-running project had supported development and evolution of the LDAP protocol until that project's final release in 1996.

Template:As of, the OpenLDAP project has four core team members: Howard Chu (chief architect),<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> Quanah Gibson-Mount, Hallvard Furuseth, and Kurt Zeilenga. There are numerous other important and active contributors including Ondrej Kuznik, Luke Howard, Ryan Tandy, and Gavin Henry. Past core team members include Pierangelo Masarati.<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>

Components

OpenLDAP has four main components:

• slapd – stand-alone LDAP daemon and associated modules and tools.<ref name="homepage">{{#invoke:citation/CS1|citation

|CitationClass=web }}</ref>

• lloadd - stand-alone LDAP load balancing proxy server<ref name="homepage"/>
• libraries implementing the LDAP protocol and ASN.1 Basic Encoding Rules (BER)<ref name="homepage"/>
• client software: ldapsearch, ldapadd, ldapdelete, and others<ref name="homepage"/>

Additionally, the OpenLDAP Project is home to a number of subprojects:

• JLDAP – LDAP class libraries for Java<ref name="homepage"/>
• JDBC-LDAP – Java JDBC – LDAP Bridge driver<ref name="homepage"/>
• ldapc++ – LDAP class libraries for C++<ref name="homepage"/>
• LMDB – memory-mapped database library<ref name="homepage"/>

Backends

Overall concept

Historically the OpenLDAP server (slapd, the Standalone LDAP Daemon) architecture was split between a frontend that handles network access and protocol processing, and a backend that deals strictly with data storage. This split design was a feature of the original University of Michigan code written in 1996<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> and carried on in all subsequent OpenLDAP releases. The original code included one main database backend and two experimental/demo backends. The architecture is modular and many different backends are now available for interfacing to other technologies, not just traditional databases.

Note: In older (1.x) releases, the terms "backend" and "database" were often used interchangeably. To be precise, a "backend" is a class of storage interface, and a "database" is an instance of a backend. The slapd server can use arbitrarily many backends at once, and can have arbitrarily many instances of each backend (i.e., arbitrarily many databases) active at once.<ref name="backends">{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>

Available backends

Currently 17 different backends are provided in the OpenLDAP distribution, and various third parties are known to maintain other backends independently. The standard backends are loosely organized into three different categories:

• Data storage backends – these actually store data
  • back-bdb: the first transactional backend for OpenLDAP, built on Berkeley DB, removed with OpenLDAP 2.5.<ref>{{#invoke:citation/CS1|citation

|CitationClass=web }}</ref>

• • back-hdb: a variant of back-bdb that is fully hierarchical and supports subtree renames, removed with OpenLDAP 2.5.<ref>{{#invoke:citation/CS1|citation

|CitationClass=web }}</ref>

• • back-ldif: built on plain text LDIF files<ref name="backends" />
  • back-mdb: a transactional backend built on OpenLDAP's Lightning Memory-Mapped Database (LMDB)<ref name="backends" />
  • back-ndb: a transactional backend built on MySQL's NDB cluster engine, removed with OpenLDAP 2.6.<ref>{{#invoke:citation/CS1|citation

|CitationClass=web }}</ref>

• • back-wiredtiger: an experimental transactional backend built on WiredTiger, introduced with OpenLDAP 2.5.<ref name="backends" />
• Proxy backends – these act as gateways to other data storage systems
  • back-asyncmeta: an asynchronous proxy with meta-directory features, introduced with OpenLDAP 2.5.<ref name="backends" />
  • back-ldap: simple proxy to other LDAP servers<ref name="backends" />
  • back-meta: proxy with meta-directory features<ref name="backends" />
  • back-passwd: uses a Unix system's passwd and group data<ref name="backends" />
  • back-relay: internally redirects to other slapd backends<ref name="backends" />
  • back-sql: talks to arbitrary SQL databases, deprecated with OpenLDAP 2.5.<ref name="backends" />
• Dynamic backends – these generate data on the fly
  • back-config: slapd configuration via LDAP<ref name="backends" />
  • back-dnssrv: Locates LDAP servers via DNS<ref name="backends" />
  • back-monitor: slapd statistics via LDAP<ref name="backends" />
  • back-null: a sink/no-op backend, analogous to Unix /dev/null<ref name="backends" />
  • back-perl: invokes arbitrary perl modules in response to LDAP requests, deprecated with OpenLDAP 2.5.<ref name="backends" />
  • back-shell: invokes shell scripts for LDAP requests, removed with OpenLDAP 2.5.<ref>{{#invoke:citation/CS1|citation

|CitationClass=web }}</ref>

• • back-sock: forwards LDAP requests over IPC to arbitrary daemons<ref name="backends" />

Some backends available in older OpenLDAP releases have been retired from use, most notably back-ldbm which was inherited from the original UMich code, and back-tcl which was similar to back-perl and back-shell.<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>

Support for other backends will soon be withdrawn as well. back-ndb is removed now since the partnership with MySQL that led to its development was terminated by Oracle after Oracle acquired MySQL. back-bdb and back-hdb have been removed in favor of back-mdb since back-mdb is superior in all aspects of performance, reliability, and manageability.

In practice, backends like -perl and -sock allow interfacing to any arbitrary programming language, thus providing limitless capabilities for customization and expansion. In effect the slapd server becomes an RPC engine with a compact, well-defined and ubiquitous API.

Overlays

Overall concept

Ordinarily an LDAP request is received by the frontend, decoded, and then passed to a backend for processing. When the backend completes a request, it returns a result to the frontend, which then sends the result to the LDAP client. An overlay is a piece of code that can be inserted between the frontend and the backend. It is thus able to intercept requests and trigger other actions on them before the backend receives them, and it can also likewise act on the backend's results before they reach the frontend. Overlays have complete access to the slapd internal APIs, and so can invoke anything the frontend or other backends could perform. Multiple overlays can be used at once, forming a stack of modules between the frontend and the backend.

Overlays provide a simple means to augment the functionality of a database without requiring that an entirely new backend be written, and allow new functionalities to be added in compact, easily debuggable and maintainable modules. Since the introduction of the overlay feature in OpenLDAP 2.2 many new overlays have been contributed from the OpenLDAP community.

Available overlays

Currently there are 25 overlays in the core OpenLDAP distribution, with another 24 overlays in the user-contributed code section, and more awaiting approval for inclusion.<ref name="overlays">{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>

• The core overlays include:
  • accesslog: log server activity in another LDAP database, for LDAP-accessible logging<ref name="overlays"/>
  • auditlog: log server activity in a flat text file<ref name="overlays"/>
  • autoca: Automatic Certificate Authority (OpenLDAP 2.5)<ref name="overlays"/>
  • chain: intercept referrals and chain them instead; code is part of back-ldap<ref name="overlays"/>
  • collect: implement X.500-style collective attributes (aka Netscape Class Of Service)<ref name="overlays"/>
  • constraint: restrict the acceptable values for particular attributes<ref name="overlays"/>
  • dds: dynamic data service – short-lived, self-expiring entries<ref name="overlays"/>
  • deref: return information about entries referenced in a given search result<ref name="overlays"/>
  • dyngroup: simple dynamic group support<ref name="overlays"/>
  • dynlist: more sophisticated dynamic group support plus more<ref name="overlays"/>
  • homedir: Remote home directory provisioning (OpenLDAP 2.5)<ref name="overlays"/>
  • memberof: support for memberOf and similar backlink attributes<ref name="overlays"/>
  • otp: allows OATH One-Time Passwords to be used in conjunction with the LDAP user password (OpenLDAP 2.5)<ref name="overlays"/>
  • pcache: cache search results, mainly to improve performance for proxied servers<ref name="overlays"/>
  • ppolicy: LDAP Password Policy – password quality, expiration, etc.<ref name="overlays"/>
  • refint: referential integrity<ref name="overlays"/>
  • remoteauth: Allows delegation of authentication requests to remote directories. Works with Active Directory. (OpenLDAP 2.5)<ref name="overlays"/>
  • retcode: set predetermined return codes for various operations; used for client debugging<ref name="overlays"/>
  • rwm: rewrite module, for various alterations of LDAP data<ref name="overlays"/>
  • seqmod: serialize writes to individual entries<ref name="overlays"/>
  • sssvlv: Server Side Sorting and Virtual List Views<ref name="overlays"/>
  • syncprov: Syncrepl Provider, implements the master side of a replication agreement<ref name="overlays"/>
  • translucent: Semi-transparent pass-through, for locally augmenting data on a proxied server<ref name="overlays"/>
  • unique: for enforcing uniqueness of attribute values within a tree<ref name="overlays"/>
  • valsort: maintain various sort orders for values of an attribute<ref name="overlays"/>

• The contrib overlays include:
  • addpartial: receive Add requests and turn them into Modifies if the target entry already exists<ref name="contrib">{{#invoke:citation/CS1|citation

|CitationClass=web }}</ref>

• • adremap: remaps attributes for PAM/NSS MS AD support (OpenLDAP 2.5)<ref name="contrib"/>
  • allop: returns all operational attributes, for clients that don't know how to request them<ref name="contrib"/>
  • authzid: implements RFC 3829 support (OpenLDAP 2.5)<ref name="contrib"/>
  • autogroup: dynamically managed static groups<ref name="contrib"/>
  • cloak: hide attributes unless explicitly requested in a search<ref name="contrib"/>
  • datamorph: stores enumerated values and fixed size integers (OpenLDAP 2.5)<ref name="contrib"/>
  • denyop: reject arbitrarily configured requests<ref name="contrib"/>
  • dupent: return multivalued results as separate entries<ref name="contrib"/>
  • lastbind: record the timestamp of a user's last successful authentication<ref name="contrib"/>
  • lastmod: maintain the timestamp of the last change within a tree<ref name="contrib"/>
  • nops: filter out redundant modifies<ref name="contrib"/>
  • noopsrch: count entries that would be returned by a search<ref name="contrib"/>
  • nssov: Answer NSS and PAM requests directly in slapd, replaces nss-ldap and pam-ldap.<ref name="contrib"/>
  • ppm: adds additional password checking criteria to the slapo-ppolicy overlay (OpenLDAP 2.5)<ref name="contrib"/>
  • proxyOld: support an obsolete encoding of ProxyAuthz used by Sun et al.<ref name="contrib"/>
  • pw-radius: allows bind operations to be passed to the specified radius server(s) (OpenLDAP 2.5)<ref name="contrib"/>
  • rbac: intercepts, decodes and enforces specific RBAC policies per the Apache Fortress RBAC data formats (OpenLDAP 2.5)<ref name="contrib"/>
  • smbk5pwd: Maintain Samba and Kerberos passwords<ref name="contrib"/>
  • trace: Log every LDAP request and response<ref name="contrib"/>
  • totp: provides one time password support (OpenLDAP 2.5)<ref name="contrib"/>
  • usn: Update Sequence Numbers (OpenLDAP 2.5)<ref name="contrib"/>
  • variant: allows attributes/values to be shared between several entries (OpenLDAP 2.5)<ref name="contrib"/>
  • vc: provides the verify credentials extended operation (OpenLDAP 2.5)<ref name="contrib"/>

Other modules

Backends and overlays are the two most commonly used types of modules. Backends were typically built into the slapd binary, but they may also be built as dynamically loaded modules, and overlays are usually built as dynamic modules. In addition, slapd supports dynamic modules for implementing new LDAP syntaxes, matching rules, controls, and extended operations, as well as for implementing custom access control mechanisms and password hashing mechanisms.

OpenLDAP also supports SLAPI, the plugin architecture used by Sun and Netscape/Fedora/Red Hat. In current releases, the SLAPI framework is implemented inside a slapd overlay. While many plugins written for Sun/Netscape/Fedora/Red Hat are compatible with OpenLDAP, very few members of the OpenLDAP community use SLAPI.<ref name="slapi">{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>

Available modules

• Native slapd modules
  • acl/posixgroup – support posixGroup membership in access controls<ref name="contrib"/>
  • comp_match – support component-based matching<ref name="contrib"/>
  • kinit – maintain/refresh a Kerberos TGT for slapd<ref name="contrib"/>
  • passwd/ – additional password hashing mechanisms. Currently includes Kerberos, Netscape, RADIUS, and SHA-2.<ref name="contrib"/>
• SLAPI plugins
  • addrdnvalue – add RDN value to an entry if it was omitted in an Add request<ref name="plugins">{{#invoke:citation/CS1|citation

|CitationClass=web }}</ref>

Release summary

The major (functional) releases of OpenLDAP Software include:

• OpenLDAP Version 1 was a general clean-up of the last release from the University of Michigan project (release 3.3), and consolidation of additional changes.
• OpenLDAP Version 2.0, released in August 2000, included major enhancements including LDAP version 3 (LDAPv3) support, Internet Protocol version 6 (IPv6) support, and numerous other enhancements.
• OpenLDAP Version 2.1, released in June 2002, included the transactional database backend (based on Berkeley Database or BDB), Simple Authentication and Security Layer (SASL) support, and Meta, Monitor, and Virtual experimental backends.
• OpenLDAP Version 2.2, released in December 2003, included the LDAP "sync" Engine with replication support (syncrepl), the overlay interface, and numerous database and RFC-related functional enhancements.
• OpenLDAP Version 2.3, released in June 2005, included the Configuration Backend (dynamic configuration), additional overlays including RFC-compliant Password Policy software, and numerous additional enhancements.
• OpenLDAP Version 2.4, released in October 2007, introduced N-way MultiMaster replication, Stand-by master, and the ability to delete and modify Schema elements on the fly, plus many more.<ref name="announce">{{#invoke:citation/CS1|citation

|CitationClass=web }}</ref>

• OpenLDAP Version 2.5, released in April 2021, introduced the LDAP load balancing proxy server, LDAP transaction support, HA proxy protocol v2 support, plus much more.<ref name="announce25">{{#invoke:citation/CS1|citation

|CitationClass=web }}</ref>

• OpenLDAP Version 2.6, released in October 2021, introduced additional load balancing strategies and additional options to improve coherence with certain LDAP controls and extended operations to the LDAP Load Balancer Daemon and the ability to log directly to a file rather than via syslog for both slapd and lloadd<ref name="announce26">{{#invoke:citation/CS1|citation

|CitationClass=web }}</ref>

Replication

OpenLDAP supports replication using Content Synchronization as specified in RFC 4533.<ref name="rfc4533">{{#invoke:citation/CS1|citation |CitationClass=web }}</ref> This spec is hereafter referred to as "syncrepl". In addition to the base specification, an enhancement known as delta-syncrepl is also supported. Additional enhancements have been implemented to support multi-master replication.<ref name="replication">{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>

syncrepl

The basic synchronization operation is described in RFC 4533.<ref name="rfc4533"/> The protocol is defined such that a persistent database of changes is not required. Rather the set of changes is implied via change sequence number (CSN) information stored in each entry and optimized via an optional session log which is particularly useful to track recent deletes. The model of operation is that a replication client (consumer) sends a "content synchronizing search" to a replication server (provider). The consumer can provide a cookie in this search (especially when it has been in sync with the provider previously). In the OpenLDAP implementation of the RFC 4533, this cookie includes the latest CSN that has been received from the provider (called the contextCSN).

The provider then returns as search results (or, see optimization below, sync info replies) the present (unchanged entry only used in the present phase of the refresh stage) (no attributes), added, modified (represented in the refresh phase as an add with all current attributes), or deleted (no attributes) entries to put the consumer into a synchronized state based on what is known via their cookie. If the cookie is absent or indicates that the consumer is totally out of sync, then the provider will, in the refresh stage, send an add for each entry it has. In the ideal case, the refresh stage of the response contains only a delete phase with just a small set of adds (including those that represent the current result of modifies) and deletes that have occurred since the time the consumer last synchronized with the provider. However, due to limited session log state (also non-persistent) kept in the provider, a present phase may be required, particularly including the presentation of all unchanged entries as a means (inefficient) of implying what has been deleted in the provider since the consumer last synchronized.

The search can be done in either refresh or refreshAndPersist mode, which implies what stages occur. The refresh stage always occurs first. During the refresh stage, two phases may occur: present and delete, where present always occurs before delete. The phases are delimited via a sync info response that specifies which phase is completed. The refresh and persist stages are also delimited via such sync info response. An optional optimization to more compactly represent a group of entries that are to be presented or deleted is to use a sync info response containing a syncIdSet that identifies the list of entryUUID values of those entries.

The present phase is differentiated from the delete phase as follows. Entries that present unchanged entries may only be returned in the present phase. Entries that delete entries may only be provided in the delete phase. In either phase, add entries (including adds that represent all current attributes of modified entries) can be returned. At the end of a present phase, each entry that the consumer has that was not identified in an add entry or present response during the present phase is implicitly no longer in the provider and thus must be deleted at the consumer so as to synchronize the consumer with the provider.

Once the persist stage begins, the provider sends search results that indicate only the add, modify and delete of entries (no present unchanged entry indications) for those entries changed since the refresh stage completed. The persist stage continues indefinitely, meaning that search has no final "done" response. By contrast, in the refresh mode only a refresh stage occurs and such stage completes with a done response that also ends the present or delete phase (whichever phase was currently active).

delta-syncrepl

This protocol keeps a persistent database of write accesses (changes) and can represent each modify precisely (meaning only the attributes that have changed). It is still built on the standard syncrepl specification, which always sends changes as complete entries. But in delta-syncrepl, the transmitted entries are actually sent from a log database, where each change in the main database is recorded as a log entry. The log entries are recorded using the LDAP Log Schema.<ref>{{#invoke:citation/CS1|citation |CitationClass=web }}</ref>

See also

• List of LDAP software

External links

• Template:Official website
• The OpenLDAP Foundation
• Using libldap, A tutorial on the OpenLDAP client API
• An OpenLDAP Update article by Marty Heyman 13 September 2007