NAME

Mojolicious::Plugin::HttpBasicAuth - Http-Basic-Authentication implementation

SYNOPSIS

# in your startup
$self->plugin(
    'http_basic_auth', {
        validate => sub {
            my $c         = shift;
            my $loginname = shift;
            my $password  = shift;
            return 1 if($loginname eq 'Homer' && $password eq 'Marge');
            return 0;
        },
        realm => 'Homers Home'
    }
);

# in your routes
sub index {
    my $self = shift;
    return unless $self->basic_auth(\%options);
    $self->render();
}

DESCRIPTION

Mojolicious::Plugin::HttpBasicAuth is a implemntation of the Http-Basic-Authentication

OPTIONS

Mojolicious::Plugin::HttpBasicAuth supports the following options.

realm

$self->plugin('http_basic_auth', {realm => 'My Castle!'});

HTTP-Realm, defaults to 'WWW'

validate

$self->plugin('http_basic_auth', {
    validate => sub {
          my $c          = shift;
          my $loginname  = shift;
          my $password   = shift;
          return 1 if($loginname eq 'Homer' && $password eq 'Marge');
          return 0;
    }
});

Validation callback to verify user. This option is mandatory.

invalid

$self->plugin('http_basic_auth', {
    invalid => sub {
        my $controller = shift;
        return (
            json => { json     => { error => 'HTTP 401: Unauthorized' } },
            html => { template => 'auth/basic' },
            any  => { data     => 'HTTP 401: Unauthorized' }
        );
    }
});

Callback vor invalid requests, default can be seen here. Return values are dispatched to "respond_to" in Mojolicious::Controller

HELPERS

Mojolicious::Plugin::HttpBasicAuth implements the following helpers.

basic_auth

return unless $self->basic_auth({realm => 'Marges Kitchen'});

All default options can be overwritten in every call.

METHODS

Mojolicious::Plugin::HttpBasicAuth inherits all methods from Mojolicious::Plugin and implements the following new ones.

register

my $route = $plugin->register(Mojolicious->new);
my $route = $plugin->register(Mojolicious->new, {realm => 'Fort Knox'});

Register renderer and helper in Mojolicious application.

SEE ALSO

Mojolicious, Mojolicious::Guides, http://mojolicio.us.

AUTHOR

Patrick Grämer, http://graemer.org.

cpanm Mojolicious::Plugin::HttpBasicAuth

perl -MCPAN -e shell
install Mojolicious::Plugin::HttpBasicAuth