phi/openldap/README.md

2.0 KiB

OpenLDAP container

Beware that this is intended for development purposes only and should not be used in production.

Make sure the latest Docker version in installed and the Docker daemon is running.

Building the container image

Before being able to use this container you must build it. Just run make build from within the openldap directory in the root of this project.

The created Docker image should be now present in your library.

% docker images 'unit/slapd'
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
unit/slapd          latest              c04d952b53d3        2 minutes ago       8.92MB

This will also create in the openldap directory in the root of this repository two files containing the private key and the server certificate for the just built docker image.

% ls -l *.pem
-rw-r--r-- 1 crudo users 1265 16 dic 22.25 cert.pem
-rw------- 1 crudo users 1704 16 dic 22.25 key.pem

Running the container image

Just run make run. This will start an OpenLDAP daemon bound to 127.0.0.1 on port 389.

The root user DN is cn=root,dn=unit,dc=macaomilano,dc=org and its password is root.

Sending SIGINT (or pressing Ctrl+C) will stop the daemon and remove the running docker instance..

Issuing client commands

In order to operate LDAP commands you need the ldapsearch and ldapmodify binaries.

Such commands require some environment variables to be set. The make shell command will start a new shell with those variables already set. Currently only Zsh is supported.

Populating the server

The init.ldif file that can be found in the openldap directory in the root of this repository contains a basic structure that can be imported to the OpenLDAP directory server. Just run make populate from withing the same directory.

Inspecting the server

Running the command make inspect from within the openldap directory in the root of this repository will show all the stored information in the OpenLDAP directory server.