###############################################
External Authentication Module
###############################################

Maintainer Contact
-----------------------------------------------
Roel Gloudemans (Nickname: lancer)
roel@quantumfluctuations.nl or roel@gloudemans.info

Contibutors
-----------------------------------------------
Sander van Dragt (Nickname: svandragt)
sander.vandragt@gmail.com


Requirements
-----------------------------------------------
* Silverstripe 3.0.0 or later
* Some PHP modules depending on the driver used like php-imap, php-ldap or
  some specific PEAR and/or PECL modules. The module requirements are 
  documented in the configuration template for that module (see doc directory)


Documentation
-----------------------------------------------
http://doc.silverstripe.com/doku.php?id=modules:external-authentication


Installation Instructions
-----------------------------------------------
* Copy the auth_external directory into your main SilverStripe directory
* Create a proper _config.php file in your auth_external directory. You 
  can start with the annotated examples from the doc directory
* run /dev/build  (like http://www.yourdomain.com/dev/build)

You should now have an "External Account" tab on the admin page.

If things didn't work as expected, enable the debugging in the config file.
The resulting log should point out the configuration mistakes.

Next to the divers included in the official release, some (user maintained)
drivers may be available by visiting the documentation link above.


Usage Overview
-----------------------------------------------
This module enables you to use external authentication sources for password
verification. At the moment this module has 4 drivers. LDAP, FTP, IMAP and
HTTPBASIC. The IMAP driver also supports POP3. All drivers support SSL. TLS
is only supported by the LDAP and IMAP drivers.

When you use this module you will still need to create accounts within
SilverStripe. There will be two extra fields for each account, specifying the
username and the external authentication source it comes from.

If you run your website at your ISP which also hosts your mailbox, you can use
the ISP's IMAP/POP3 server to validate your logon. Other users at the ISP
cannot login when you do that because the accounts also need to be registered
within SilverStripe.


Known issues
-----------------------------------------------
none