INSTALL

INSTALLATION
============

Build dependencies
------------------
OpenLDAP sources must be available. For an easier build, copy all ppm module
into contrib/slapd-modules.

Build
-----
Be sure to have copied ppm module into contrib/slapd-modules OpenLDAP source
directory.

Adapt the Makefile command to indicate:
CONFIG: where the ppm.conf configuration file will finally stand
LIBDIR: where the library will be installed
DEBUG: If defined, ppm logs its actions with syslog

then type:

make clean
make CONFIG=/etc/openldap/ppm.conf LIBDIR=/usr/lib/openldap
make install CONFIG=/etc/openldap/ppm.conf LIBDIR=/usr/lib/openldap


USAGE
=====

Create a password policy entry and indicate the fresh compiled
library ppm.so:

dn: cn=default,ou=policies,dc=my-domain,dc=com
objectClass: pwdPolicy
objectClass: pwdPolicyChecker
objectClass: person
objectClass: top
cn: default
sn: default
pwdAttribute: userPassword
pwdCheckQuality: 2
...
pwdCheckModule: /path/to/new/ppm.so


See slapo-ppolicy for more information, but to sum up:
- add ppolicy schema to your directory
- enable ppolicy overlay
- define a default ppolicy in OpenLDAP configuration or use pwdPolicySubentry
attribute to point to the previous policy.