view mod_auth_ldap.wiki @ 450:042161223488

mod_auth_ldap: Update configuration section
author Kim Alvefur <zash@zash.se>
date Sun, 27 Apr 2014 03:39:13 +0200
parents 7e5c6a70af1e
children eb771cbbf410
line wrap: on
line source

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

_*Note:* A modified version of this module is available, but is not yet committed here. The plan is to merge them, for more info see [http://groups.google.com/group/prosody-dev/browse_thread/thread/282e876116ae4177/906121492495ad35#906121492495ad35 this thread]._

= 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_filter   || search filter, with $user and $host substituded for user- and hostname || "(uid=$user)"    ||
|| ldap_scope    || search scope. other values: "base" and "subtree"   || "onelevel"       ||
|| 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 ||
|| ldap_mode     || How passwords are validated.                       || "getpasswd" if ldap_rootdn is set, "bind" otherwise ||

= Modes =

The "getpasswd" mode requires plain text access to passwords in LDAP and
feeds them into Prosodys authentication system.  This enables more secure
authentication mechanisms but does not work for all deployments.

The "bind" performs an LDAP bind, does not require plain text access to
passwords but limits you to the PLAIN authentication mechanism.

= Compatibility =

|| 0.8 and above || should work ||