POE::Component::Server::HTTPServer::BasicAuthenHandler(3)

NAME
POE::Component::Server::HTTPServer::BasicAuthenHandler - Basic HTTP Basic Authentication

SYNOPSIS
    use POE::Component::Server::HTTPServer;

    my $server = POE::Component::Server::HTTPServer->new();
    $server->handlers( [
        '/protected' => new_handler( 'BasicAuthenHandler', 'realm' ),
        '/protected' => MyAuthorizationHandler->new(),
        '/protected' => new_handler( 'StaticHandler', './secretdox' ),
    ] );

DESCRIPTION
BasicAuthenHandler performs the necessary processing on requests to support HTTP Basic authentication. If the user-agent making the request supplies authentication information (via the "WWW-Authenticate" header), this handler extracts the supplied user name and password and sets the context attributes "basic_username" and "basic_password" respectively. If no authentication is given, the handler generates and returns an appropriate "403 Unauthorized" response.

Note that this handler performs authentication only, it does not perform authorization. You will need to supply logic to check the user name and password for your own purposes.

SEE ALSO
POE::Component::Server::HTTPServer::Handler

AUTHOR
Greg Fast <gdf@speakeasy.net>

COPYRIGHT
Copyright 2003 Greg Fast.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.