NAME

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

SYNOPSIS

    use Catalyst qw/
        Authentication
    /;

    $c->config( authentication => {
        realms => {
            example => {
                credential => {
                    class => 'HTTP::Proxy',
                    type => 'basic', # Only basic supported
                    url => 'http://elkland.no/auth',
                },
            },
            store => {
                class => 'Minimal',
                users => {
                    Mufasa => { },
                },
            },
        },
    });
    
    sub foo : Local { 
        my ( $self, $c ) = @_;

        $c->authenticate(); 
        
        # either user gets authenticated or 401 is sent

        do_stuff();
    }

DESCRIPTION

This module 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

All configuration is stored in YourApp->config(authentication => { yourrealm => { credential => { class => 'HTTP::Proxy', %config } } }.

This should be a hash, and it can contain the following entries:

url

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

type

Must be either basic or not present (then it defaults to basic).

This will be used to support digest authentication in future.

METHODS

init

Initializes the configuration.

authenticate_basic

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

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.