.. _authentication:

=======================
External authentication
=======================

SMTP, POP3, IMAP and RADIUS/RSA SECURID
========================================

Baruwa supports authentication to external authentication systems. SMTP, POP3, IMAP, RADIUS/RSA SECURID
are supported out of the box. TLS, APOP are also supported to ensure user authentication details are
protected over the wire.

Authentication is setup on a per domain basis.

Configuration
-------------

As the administrator click on the domain name and add an authentication server. The options are
	
	* Address (Either a hostname or IP address)
	* Protocol (POP3, IMAP, SMTP, RADIUS/RSA SECURID)
	* Port 
	* Enabled
	* Split address (usernames with @ split into user and domain parts user part used to authenticate)

RADIUS secret
-------------

The RADIUS secret need to be set in the settings file on a per Address basis::

    RADIUS_SECRET['127.0.0.1'] = 'radius secret'


LDAP
====

Ldap authentication can be enabled by installing the `Django-auth-ldap`_ package. Please refer to
their `documentation`_ on how to configure the package.

.. _`Django-auth-ldap`: http://pypi.python.org/pypi/django-auth-ldap/
.. _`documentation`: http://packages.python.org/django-auth-ldap/

