[[PageOutline(2-5,Contents,pullout)]]

= Apache User Info plugin =

== Description ==

If you're using Apache with `mod_auth_ldap` then you can use multiple attributes in `AuthLDAPURL`, all of them being exposed as variables with the default prefix `AUTHENTICATE_`.

With this plugin you can fill the missing values or override the name and the email address of the user during the login.

== Bugs/Feature Requests == 

==== Trac Hacks ====
Existing bugs and feature requests for ApacheUserInfoPlugin are 
[report:9?COMPONENT=ApacheUserInfoPlugin here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=ApacheUserInfoPlugin&owner=alexandrul new ticket].

==== Bitbucket ====

You can also report bugs and feature requests on [https://bitbucket.org/alexandrul/trac-apacheuserinfo-plugin/issues?status=new&status=open Bitbucket].

== Download ==

You can download the latest version of `ApacheUserInfo.py` from [https://bitbucket.org/alexandrul/trac-apacheuserinfo-plugin/src/ here].

== Source ==

You can clone ApacheUserInfoPlugin from [https://bitbucket.org/alexandrul/trac-apacheuserinfo-plugin/ here] using Mercurial, or [https://bitbucket.org/alexandrul/trac-apacheuserinfo-plugin/src browse the source] directly at Bitbucket.

== Installation ==

The plugin consists of a single file that must be placed directly into either the project's or the shared plugins directory.

== Example ==

Enable it in trac.ini:

{{{
#!ini
[components]
apacheuserinfo.* = enabled

[apacheuserinfo]
email_override = true
email_var = AUTHENTICATE_MAIL
name_override = true
name_var = AUTHENTICATE_DISPLAYNAME
}}}

The attributes used for mapping must be present in AuthLDAPURL, e.g.:

{{{
#!apache
ldap://host:port/basedn?sAMAccountName,displayName,mail?scope?filter
}}}

== Recent Changes ==

[[ChangeLog(apacheuserinfoplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:alexandrul] [[BR]]
'''Maintainer:''' [wiki:alexandrul] [[BR]]
'''Contributors:'''