The authentication handling plugins can be used by the Session class to provide authentication.

Each authenticate hook needs to:

• Accept a username / password
• Confirm the username / password are correct
• Create (or update) a 'usr' record in our database
• Return the 'usr' record as an object
• Return === false when authentication fails

It can expect that:

• Configuration data will be in $c->authenticate_hook['config'], which might be an array, or whatever is needed.

In order to be called:

• This file should be included
• $c->authenticate_hook['call'] should be set to the name of the plugin
• $c->authenticate_hook['config'] should be set up with any configuration data for the plugin

• author: Andrew McMillan <andrew@catalyst.net.nz>
• copyright: Catalyst IT Ltd
• license: GNU GPL v2