Apache2::AuthenMSAD 0.02

Apache2::AuthenMSAD is a Perl module with Microsoft Active Directory authentication for Apache.

SYNOPSIS

< Directory /foo/bar >
# Authentication Realm and Type (only Basic supported)

AuthName "Microsoft Active Directory Authentication"
AuthType Basic

# Authentication method/handler

PerlAuthenHandler Apache2::AuthenMSAD

# The Microsoft Active Directory Domain Name must be set
# The Active Directory Server Name will default to the domain.

PerlSetVar MSADDomain ads.foo.com
PerlSetVar MSADServer dc.ads.foo.com

# Require lines can be any of the following -- any user, one of a list

require valid-user
require user joe mary tom
< /Directory >

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

This perl module is designed to work with mod_perl2 and Net::LDAP. It will authenticate users in a Windows 2000 or later Microsoft Active Directory -- hence the acronym MSAD. Configuration parameters give the DNS name used for the cluster of Microsoft Domain Controllers and the Microsoft Domain name used within the Active Directory.

This relies on a surprising feature first brought to our attention by Yvan Rodrigues here at the University of Waterloo. You can authenticate with a Distinguished Name like "reggers@ads.foo.com" (ie. the userPrincipalName in the Active Directory) and you don't need to resort to the X509 Distinguished Name. Most LDAP authentication methods require a guest account where you can login to find the user's Distinguished Name and then login again as that name. Active Directory has this extra feature which makes life much simpler.

At our site the domain mentioned in the userPrincipalName is "ads.uwaterloo.ca" -- that is also the name we use for our collection of Domain Controllers. You might not implement that convention. If you do the MSADServer parameter is optional -- it defaults to the MSADDomain.This version is patched to use mod_per2 (>=2.0x) and apache2. It was tested in an production environment to work perfectly.

Product's homepage

Requirements:

· Perl