Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time

Adding OpenLDAP for COmanage Registry

Follow these steps to build and add OpenLDAP slapd as a managed service to an existing COmanage Registry service stack.

  • Build the base image:
pushd comanage-registry-slapd-base
docker build \
  -t comanage-registry-slapd-base:${TAG} .
  • Define the shell variable COMANAGE_REGISTRY_SLAPD_IMAGE_VERSION to be the version of the image you are about to build:
  • Build the slapd image:
pushd comanage-registry-slapd
docker build \
    -t comanage-registry-slapd:$TAG . 
  • Use the slappasswd OpenLDAP password utility to create a hashed password value.

  • Create a secret to store the hashed password value you just created (be sure to use your own value and not the example below):

echo "{SSHA}emcy1JA+mxbHH0PMPcnasE9apBStAMks" | docker secret create olc_root_pw -
  • Create directories on the Docker engine host(s) for state files:
sudo mkdir -p /srv/docker/var/lib/ldap
sudo mkdir -p /srv/docker/etc/slapd.d
  • Define shell variables for the directory suffix and root DN, for example:
export OLC_SUFFIX=dc=my,dc=org
export OLC_ROOT_DN=cn=admin,dc=my,dc=org
  • Edit the Docker Swarm services stack description (compose) file you previously created and add the following service description after the existing services:
    image: comanage-registry-slapd:${COMANAGE_REGISTRY_SLAPD_IMAGE_VERSION}
    command: ["slapd", "-d", "256", "-h", "ldapi:/// ldap:///", "-u", "openldap", "-g", "openldap"]
        - /srv/docker/var/lib/ldap:/var/lib/ldap
        - /srv/docker/etc/slapd.d:/etc/ldap/slapd.d
        - OLC_ROOT_PW_FILE=/run/secrets/olc_root_pw
        - OLC_ROOT_DN=${OLD_ROOT_DN}
        - olc_root_pw
        - default
        replicas: 1

COmanage Registry and OpenLDAP slapd can communicate directly using the default network created by Docker Swarm when the service stack is instantiated. So it is not necessary to expose the slapd port unless required for other services that are not part of the stack to contact slapd. If you need to expose the slapd port also add to the above

      - "389:389"
  • Be sure to also edit the services stack description file and add the olc_root_pw secret to the list of secrets.

  • Deploy the COmanage Registry service stack:

docker stack deploy --compose-file comanage-registry-stack.yml comanage-registry

You may monitor the progress of the slapd container using

docker service logs -f comanage-registry-ldap

The container does not bootstrap any structure in the directory, i.e. it does not create any ou=people or ou=groups branches that are usually used with COmanage Registry. To have the container create the necessary structure for your deployment see Executing LDIF Files.

To use TLS for connections to slapd (either on port 636 using ldaps:// or via START_TLS on port 389) define the environment variables SLAPD_CERT_FILE, SLAPD_CHAIN_FILE, and SLAPD_PRIVKEY_FILE and then change the command above to be

command: ["slapd", "-d", "256", "-h", "ldapi:/// ldap:/// ldaps:///", "-u", "openldap", "-g", "openldap"]

If you need to expose the TLS endpoint in addition to port 389 also edit the configuration of the ports in the services stack description (compose) file to be

      - "389:389"
      - "636:636"