Apache::AuthPerLDAP 0.5

Apache::AuthPerLDAP is a mod_perl PerLDAP Authentication Module.

SYNOPSIS

< Directory /foo/bar >
# Authentication Realm and Type (only Basic supported)
AuthName "Foo Bar Authentication"
AuthType Basic

# Any of the following variables can be set.
# Defaults are listed to the right.
PerlSetVar BaseDN o=Foo,c=Bar # Default: "" (empty String)
PerlSetVar LDAPServer ldap.foo.com # Default: localhost
PerlSetVar LDAPPort 389 # Default: 389 (standard LDAP port)
PerlSetVar UIDAttr uid # Default: uid
require valid-user

PerlAuthenHandler Apache::AuthPerLDAP

< /Directory >

These directives can also be used in a .htaccess file.

AuthPerLDAP provides Basic Authentication, with username/password lookups against an LDAP server, using Netscapes PerLDAP kit.

It is heavily based on Clayton Donleys Apache::AuthLDAP module, but uses the newer Netscape PerLDAP (Mozilla::LDAP), which in turn uses the Netscape Directory SDK for C. Thus Donleys original Net::LDAPapi module and library is no longer required.

It requires mod_perl and PerLDAP (v1.2 or later). Building mod_perl with:

perl Makefile.PL PERL_AUTHEN=1 PERL_STACKED_HANDLERS=1 PERL_GET_SET_HANDLERS

works for me. If this module is the only Apache/Perl module you are going to use, you probably dont need anything but the PERL_AUTHEN hook enabled.

Unlike Donleys Apache::AuthLDAP module, AuthPerLDAP is only used for authentication, and thus only supports the require-user directive. If a user enters the correct username and password, the authentication is considered to be OK.