NAME
Dancer2::Plugin::Auth::Extensible::Provider::DBIC - authenticate via the
Dancer2::Plugin::DBIC plugin
DESCRIPTION
This class is an authentication provider designed to authenticate users
against a database, using Dancer2::Plugin::DBIC to access a database.
See Dancer2::Plugin::DBIC for how to configure a database connection
appropriately; see the "CONFIGURATION" section below for how to
configure this authentication provider with database details.
See Dancer2::Plugin::Auth::Extensible for details on how to use the
authentication framework.
CONFIGURATION
This provider tries to use sensible defaults, in the same manner as
Dancer2::Plugin::Auth::Extensible::Provider::Database, so you may not
need to provide much configuration if your database tables look similar
to those.
The most basic configuration, assuming defaults for all options, and
defining a single authentication realm named 'users':
You would still need to have provided suitable database connection
details to Dancer2::Plugin::DBIC, of course; see the docs for that
plugin for full details, but it could be as simple as, e.g.:
# optionally specify names of tables if they're not the defaults
# (defaults are 'users', 'roles' and 'user_roles')
users_table: 'users'
roles_table: 'roles'
user_roles_table: 'user_roles'
# optionally set the column names
users_username_column: 'username'
users_password_column: 'password'
roles_role_column: 'role'
See the main Dancer2::Plugin::Auth::Extensible documentation for how to
configure multiple authentication realms.
SUGGESTED SCHEMA
See the Dancer2::Plugin::Auth::Extensible::Provider::Database
documentation for an example schema.