NAME

Catalyst::Authentication::Store::DBI - Storage class for Catalyst Authentication using DBI

SYNOPSIS

  use Catalyst qw(Authentication);

  __PACKAGE__->config->{'authentication'} = {
    'default_realm' => 'default',
    'realms' => {
      'default' => {
        'credential' => {
          'class'               => 'Password',
          'password_field'      => 'password',
          'password_type'       => 'hashed',
          'password_hash_type'  => 'SHA-1',
        },
        'store' => {
          'class'              => 'DBI',
          'user_table'         => 'login',
          'user_key'           => 'id',
          'user_name'          => 'name',
          'role_table'         => 'authority',
          'role_key'           => 'id',
          'role_name'          => 'name',
          'user_role_table'    => 'competence',
          'user_role_user_key' => 'login',
          'user_role_role_key' => 'authority',
        },
      },
    },
  };

  sub login :Global
  {
    my ($self, $c) = @_;
    my $req = $c->request();

    # catch login failures
    unless ($c->authenticate({
      'name'     => $req->param('name'),
      'password' => $req->param('password'),
      })) {
      ...
    }

    ...
  }

  sub something :Path
  {
    my ($self, $c) = @_;

    # handle missing role case
    unless ($c->check_user_roles('editor')) {
      ...
    }

    ...
  }

DESCRIPTION

This module implements the Catalyst::Authentication API using Catalyst::Model::DBI.

It uses DBI to let your application authenticate users against a database and it provides support for Catalyst::Plugin::Authorization::Roles.

METHODS

new

find_user

for_session

from_session

user_supports

SEE ALSO

Catalyst::Plugin::Authentication

Catalyst::Model::DBI

Catalyst::Plugin::Authorization::Roles

AUTHOR

Simon Bertrang, <simon.bertrang@puzzworks.com>

COPYRIGHT

Copyright (c) 2008 PuzzWorks OHG, http://puzzworks.com/

LICENSE

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