1NAME
2    Authen::Simple::HTTP - Simple HTTP authentication
3
4SYNOPSIS
5        use Authen::Simple::HTTP;
6
7        my $http = Authen::Simple::HTTP->new(
8            url => 'http://www.host.com/protected'
9        );
10
11        if ( $http->authenticate( $username, $password ) ) {
12            # successfull authentication
13        }
14
15        # or as a mod_perl Authen handler
16
17        PerlModule Authen::Simple::Apache
18        PerlModule Authen::Simple::HTTP
19
20        PerlSetVar AuthenSimpleHTTP_url "http://www.host.com/protected"
21
22        <Location /protected>
23          PerlAuthenHandler Authen::Simple::HTTP
24          AuthType          Basic
25          AuthName          "Protected Area"
26          Require           valid-user
27        </Location>
28
29DESCRIPTION
30    Authenticate against an HTTP server.
31
32METHODS
33    * new
34        This method takes a hash of parameters. The following options are
35        valid:
36
37        * url   Url to authenticate against. Required.
38
39                    url => 'http://www.host.com/protected'
40
41        * agent Any object that is a subclass of LWP::UserAgent.
42
43                    agent => LWP::UserAgent->new;
44
45        * log   Any object that supports "debug", "info", "error" and
46                "warn".
47
48                    log => Log::Log4perl->get_logger('Authen::Simple::HTTP')
49
50    * authenticate( $username, $password )
51        Returns true on success and false on failure.
52
53SEE ALSO
54    Authen::Simple.
55
56    LWP::UserAgent.
57
58    LWPx::ParanoidAgent.
59
60AUTHOR
61    Christian Hansen "ch@ngmedia.com"
62
63COPYRIGHT
64    This program is free software, you can redistribute it and/or modify it
65    under the same terms as Perl itself.
66
67