$ifost: README,v 1.8 2003/02/19 22:52:06 peterw Exp $
$Id: README,v 1.3 2007/10/25 11:43:31 merdely Exp $

This is a BSD authentication module for authenticating users against an
LDAP server. It was originally written by
Peter Werner <peterw@ifost.org.au>.  login-ldap is currently
maintained by Michael Erdely <merdely@openbsd.org>.

James R. Phillips <jamesp@webdaemons.org> wrote the man page and provided
invaluble advice.

Markus Friedl <Markus_Friedl@genua.de> sent changes to make it work on BSD/OS
and Microsoft Active Directory as well as some general improvements

Some other people who have made contributions include:
Shaun O'Meara
Francis Potter 
Sebastian Stark
Chris Maxwell

It requires the OpenLDAP libraries installed, these are available in the
OpenBSD ports tree. If you install the OpenLDAP server or just the clients
these will be installed.

As of version 3.3, login_ldap no longer installs setuid root, if this causes
problems, please let Michael Erdely or Peter Werner know. It is believed the
suid bit is not required to be set, but local settings may require it.

It should work with any LDAP server. It is know to work with the following
servers:
OpenLDAP 2.0.x 
OpenLDAP 2.1.x
Active Directory

If you use it successfully with a different LDAP server please mail  
merdely@openbsd.org so I can update the list in this file.

Kerberos and SASL support is not present, mainly due to issues with the
underlying libraries.

Please see the INSTALL section below for directions of installation

Please visit http://sourceforge.net/projects/login-ldap/
For general questions mail merdely@openbsd.org
For information on commercial support please mail gregb@ifost.org.au

INSTALL
-------

# make
# make install
# man login_ldap
# more /usr/local/share/examples/login_ldap/login_ldap.conf

- Peter Werner <peterw@ifost.org.au> 2002/06/27
- Michael Erdely <merdely@openbsd.org> 2007/10/25
