Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Build Status Coverage Status Maven Central for GitHub GitHub Analytics

A JUnit Rule for running an embedded LDAP server in your JUnit test based on the wonderful UnboundID LDAP SDK. Inspired by the Embedded Database JUnit Rule.


  • you want to test your LDAP integration code without affecting your LDAP server
  • you are working with LDAP schema changes that you would like to test without changing the schema at the shared LDAP server
  • you are refactoring legacy code where LDAP calls are tightly coupled with your business logic and wants to start by testing the legacy code from the "outside" (as suggested by Michael Feathers)
    • for this exact reason most instances returned from the EmbeddedLdapRule is instrumented to suppress "close" calls so that your legacy code will not destroy the current Context/DirContext or LdapInterface
    • note: if you used the new unsharedLdapConnection() method, the returned instance will not have this guarantee as it returns a instance of UnboundID LDAPConnection which is declared 'final'.


This library is distributed through the Sonatype OSS repo and should thus be widely available. Java 8 or higher is required. It has proven pretty useful for several users and should be considered safe for running tests for all kinds of LDAP integrating code.


  • version 0.8.1: switched license to MIT (was Apache v2) changelog
  • version 0.8: changelog
  • version 0.7: changelog
  • version 0.6: changelog
  • version 0.5.2: changelog
  • version 0.5.1: changelog
  • version 0.5: changelog
  • version 0.4: changelog
  • version 0.3: solves issue #1 - give access to the LDAPConnection object from the UnboundID LDAP SDK
  • version 0.2:
    • support for defining schema definitions using the "withSchema(String...)" method on the EmbeddedLdapRuleBuilder
    • added the possibility to define multiple root DSNs
  • version 0.1: support for both UnboundID LDAP SDK and traditional JNDI LDAP integrations


Add dependency




libraryDependencies += "org.zapodot" % "embedded-ldap-junit" % "0.8.1"

Add to Junit test

import com.unboundid.ldap.sdk.LDAPInterface;
import javax.naming.Context;
import javax.naming.NamingEnumeration;

public EmbeddedLdapRule embeddedLdapRule = EmbeddedLdapRuleBuilder

public void testLdapInteface() throws Exception {
    // Test using the UnboundID LDAP SDK directly
    final LdapInterface ldapConnection = embeddedLdapRule.ldapConnection();
    final SearchResult searchResult =, SearchScope.SUB, "(objectClass=person)");
    assertEquals(1, searchResult.getEntryCount());

public void testUnsharedLdapConnection() throws Exception {
    // Test using the UnboundID LDAP SDK directly by using the UnboundID LDAPConnection type
    final LDAPConnection ldapConnection = embeddedLdapRule.unsharedLdapConnection();
    final SearchResult searchResult =, SearchScope.SUB, "(objectClass=person)");
    assertEquals(1, searchResult.getEntryCount());

public void testDirContext() throws Exception {

    // Test using the good ol' JDNI-LDAP integration
    final DirContext dirContext = embeddedLdapRule.dirContext();
    final SearchControls searchControls = new SearchControls();
    final NamingEnumeration<> resultNamingEnumeration =
  , "(objectClass=person)", searchControls);
    assertEquals(1, Iterators.size(Iterators.forEnumeration(resultNamingEnumeration)));
public void testContext() throws Exception {

    // Another test using the good ol' JDNI-LDAP integration, this time with the Context interface
    final Context context = embeddedLdapRule.context();
    final Object user = context.lookup("cn=John Doe,ou=people,dc=example,dc=com");