NAME

Catalyst::Plugin::Authentication::Credential::HTTP - HTTP Basic authentication for Catlayst.

SYNOPSIS

use Catalyst qw/
    Authentication
    Authentication::Store::Moose
    Authentication::Credential::HTTP
/;

sub foo : Local {
    my ( $self, $c ) = @_;

    $c->authorization_required( realm => "foo" ); # named after the status code ;-)

    # either user gets authenticated or 401 is sent

    do_stuff();
}

# with ACL plugin
__PACKAGE__->deny_access_unless("/path", sub { $_[0]->authenticate_http });

sub end : Private {
    my ( $self, $c ) = @_;

    $c->authorization_required_response( realm => "foo" );
    $c->error(0);
}

DESCRIPTION

This moduule lets you use HTTP authentication with Catalyst::Plugin::Authentication.

Currently this module only supports the Basic scheme, but upon request Digest will also be added. Patches welcome!

METHODS

authorization_required

Tries to authenticate_http, and if that fails calls authorization_required_response and detaches the current action call stack.

authenticate_http

Looks inside $c->request->headers and processes the basic (badly named) authorization header.

authorization_required_response

Sets $c->response to the correct status code, and adds the correct header to demand authentication data from the user agent.

AUTHORS

Yuval Kogman, nothingmuch@woobling.org

Jess Robinson

Sascha Kiefer esskar@cpan.org

COPYRIGHT & LICENSE

Copyright (c) 2005-2006 the aforementioned authors. All rights
reserved. This program is free software; you can redistribute
it and/or modify it under the same terms as Perl itself.