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.