Commit | Line | Data |
b1ac26c1 |
1 | NAME |
b2cd5ce7 |
2 | Catalyst::Authentication::Credential::HTTP::Proxy - HTTP Proxy |
b1ac26c1 |
3 | authentication for Catlayst. |
4 | |
5 | SYNOPSIS |
6 | use Catalyst qw/ |
7 | Authentication |
8 | Authentication::Store::Moose |
9 | Authentication::Store::Elk |
10 | Authentication::Credential::HTTP::Proxy |
11 | /; |
12 | |
13 | $c->config->{authentication}{http_proxy}= { |
14 | url =>'http://elkland.no/auth', |
15 | store => 'Authentication::Store::Moose' |
16 | }; |
17 | |
18 | sub foo : Local { |
19 | my ( $self, $c ) = @_; |
20 | |
21 | $c->authorization_required( realm => "foo" ); # named after the status code ;-) |
22 | |
23 | # either user gets authenticated or 401 is sent |
24 | |
25 | do_stuff(); |
26 | } |
27 | |
28 | # with ACL plugin |
29 | __PACKAGE__->deny_access_unless("/path", sub { $_[0]->authenticate_http }); |
30 | |
31 | sub end : Private { |
32 | my ( $self, $c ) = @_; |
33 | |
34 | $c->authorization_required_response( realm => "foo" ); |
35 | $c->error(0); |
36 | } |
37 | |
38 | DESCRIPTION |
39 | This moduule lets you use HTTP Proxy authentication with |
40 | Catalyst::Plugin::Authentication. |
41 | |
42 | Currently this module only supports the Basic scheme, but upon request |
43 | Digest will also be added. Patches welcome! |
44 | |
45 | CONFIG |
46 | This module reads config from $c->config->{authentication}{http_proxy}. |
47 | The following settings are supported: |
48 | |
49 | url Required. A url protected with basic authentication to authenticate |
50 | against. |
51 | |
52 | store |
53 | To specify what store to use. will use the default store if not set. |
54 | |
55 | METHODS |
56 | authorization_required |
57 | Tries to "authenticate_http_proxy", and if that fails calls |
58 | "authorization_required_response" and detaches the current action |
59 | call stack. |
60 | |
61 | authenticate_http_proxy |
62 | Looks inside "$c->request->headers" and processes the basic (badly |
63 | named) authorization header. Then authenticates this against the |
64 | provided url. |
65 | |
66 | authorization_required_response |
67 | Sets "$c->response" to the correct status code, and adds the correct |
68 | header to demand authentication data from the user agent. |
69 | |
70 | AUTHORS |
b2cd5ce7 |
71 | Marcus Ramberg <mramberg@cpan.org> |
72 | |
73 | Tomas Doran <bobtfish@bobtfish.net> |
b1ac26c1 |
74 | |
75 | COPYRIGHT & LICENSE |
b2cd5ce7 |
76 | Copyright (c) 2005-2008 the aforementioned authors. All rights |
b1ac26c1 |
77 | reserved. This program is free software; you can redistribute |
78 | it and/or modify it under the same terms as Perl itself. |
79 | |