NAME
    Catalyst::Authentication::Credential::HTTP::Proxy - HTTP Proxy
    authentication for Catlayst.

SYNOPSIS
        use Catalyst qw/
            Authentication
            Authentication::Store::Moose
            Authentication::Store::Elk
            Authentication::Credential::HTTP::Proxy
        /;

        $c->config->{authentication}{http_proxy}= {
            url  =>'http://elkland.no/auth',
            store => 'Authentication::Store::Moose'
        };
    
        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 Proxy authentication with
    Catalyst::Plugin::Authentication.

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

CONFIG
    This module reads config from $c->config->{authentication}{http_proxy}.
    The following settings are supported:

    url Required. A url protected with basic authentication to authenticate
        against.

    store
        To specify what store to use. will use the default store if not set.

METHODS
    authorization_required
        Tries to "authenticate_http_proxy", and if that fails calls
        "authorization_required_response" and detaches the current action
        call stack.

    authenticate_http_proxy
        Looks inside "$c->request->headers" and processes the basic (badly
        named) authorization header. Then authenticates this against the
        provided url.

    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
    Marcus Ramberg <mramberg@cpan.org>
    
    Tomas Doran <bobtfish@bobtfish.net>

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

