NAME

Dancer::Plugin::Authorize::Credentials::PostgreSQL - Dancer::Plugin::Authorize authentication via PostgreSQL!

VERSION

version 1.110720

SYNOPSIS

            

              
              
# in your app code
my $auth = auth($login, $password);
if ($auth) {
    # login successful
}
# use your own encryption (if the user account password is encrypted)
my $auth = auth($login, encrypt($password));
if ($auth) {
    # login successful
}
            
          

DESCRIPTION

Dancer::Plugin::Authorize::Credentials::PostgreSQL uses your PostgreSQL database connection as the application's user management system.

METHODS

authorize

The authorize method (found in every authentication class) validates a user against the defined datastore using the supplied arguments and configuration file options.

CONFIGURATION

            

              
              
plugins:
  Database:
    driver: 'Pg'
    database: 'test'
    username: 'root'
    password: '****'
  Authorize:
    credentials:
      class: PostgreSQL
            
          

Sometime you might define multiple connections for the Database plugin, make sure you tell the Authorize plugin about it... e.g.

            

              
              
plugins:
  Database:
    foo:
      driver: 'sqlite'
      database: 'example1.db'
    bar:
      driver: 'Pg'
      database: 'test'
      username: 'root'
      password: '****'
  Authorize:
    credentials:
      class: PostgreSQL
      options:
        handle: bar
            
          

Please see Dancer::Plugin::Database for a list of all available connection options and arguments.

DATABASE SETUP

            

              
              
# users table (feel free to add more columns as you see fit)
CREATE TABLE "users" (
"id" SERIAL NOT NULL PRIMARY KEY,
"name" TEXT,
"login" TEXT NOT NULL,
"password" TEXT NOT NULL,
"roles" TEXT
);
# create an initial adminstrative user (should probably encrypt the password)
# Note! this module is not responsible for creating user accounts, it simply
# provides a consistant authentication framework
INSERT INTO users (name, login, password, roles)
VALUES ('Administrator', 'admin', '*****', 'guest, user, admin');
            
          

AUTHOR

            

              
              
Al Newkirk <awncorp@cpan.org>
            
          

COPYRIGHT AND LICENSE

This software is copyright (c) 2010 by awncorp.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.