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.