#summary LDAP authentication module
#labels Stage-Alpha,Type-Auth

= Introduction =

This is a Prosody authentication plugin which uses LDAP as the backend.

= Configuration =

Copy the module to the prosody modules/plugins directory.

In Prosody's configuration file, under the desired host section, add:
{{{
    authentication = "ldap"
}}}

LDAP options are:
|| *Name*        || *Description*                                      || *Default value*  ||
|| ldap_server   || space-separated list of hostnames or IPs           || "localhost"      ||
|| ldap_rootdn   || the distinguished name to auth against             || "" (anonymous)   ||
|| ldap_password || the password                                       || ""               ||
|| ldap_tls      || Use TLS to connect to LDAP? (can be true or false) || false            ||
|| ldap_base     || LDAP base directory which stores user accounts     || this is required ||

= Compatibility =

|| trunk || Untested, but should work ||