CGI::Application::Plugin::Authentication::Driver 0.11

CGI::Application::Plugin::Authentication::Driver is a Perl base module for building driver clasees for CGI::Application::Plugin::Authentication.

SYNOPSIS

package CGI::Application::Plugin::Authentication::Driver::MyDriver;
use base qw(CGI::Application::Plugin::Authentication::Driver);

sub verify_credentials {
my $self = shift;
my @credentials = @_;

if ( >>> Validate Credentials <<< ) {
return $credentials[0];
}
return;
}

This module is a base class for all driver classes for the CGI::Application::Plugin::Authentication plugin. Each driver class is required to provide only one method to validate the given credentials. Normally only two credentials will be passed in (username and password), but you can configure the plugin to handle any number of credentials (for example you may require the user to enter a group name, or domain name as well as a username and password).

FIELD FILTERS

It is quite common for passwords to be stored using some form of one way encryption. Unix crypt being the old standard in the Unix community, however MD5 or SHA1 hashes are more popular today. In order to simplify the validation routines some methods have been provided to help test these passwords. When configuring a Driver (and if the driver supports it), you can specify which fields are encoded, and which method is used for the encoding by specifying a filter on the field in question.

CREDENTIALS => [authen_username, authen_password],
DRIVERS => [ DBI,
DSN => ...,
TABLE => users,
CONSTRAINTS => {
username => __CREDENTIAL_1__,
MD5:password => __CREDENTIAL_2__,
}
],

Here we are saying that the password field is encoded using an MD5 hash, and should be checked accordingly.