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

COPYRIGHT & LICENSE
            Copyright (c) 2005 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.