NAME

SQCAS::Apache::Authorization - Apache handler for authorizing users.

SYNOPSIS

  use SQCAS::Apache::Authorization;
  blah blah blah

ABSTRACT

  This should be the abstract for SQCAS::Apache::Authorization.
  The abstract is used when making PPD (Perl Package Description) files.
  If you don't want an ABSTRACT you should also edit Makefile.PL to
  remove the ABSTRACT_FROM option.

DESCRIPTION

Stub documentation for SQCAS::Apache::Authorization, created by h2xs. It looks like the author of the extension was negligent enough to leave the stub unedited.

Blah blah blah.

EXPORT

None by default.

METHODS

handler

This is the function that actually controls the per request access. It first tries to get the value of the cookie for the access region. If no cookie is found it returns AUTH_REQUIRED. If it does find a value associated with the cookie, it then checks to see if the session has timed out. If it has, it returns AUTH_REQUIRED. If not, it updates the request timestamp (resetting the timer) and returns OK. Current timeout period is 15 minutes.

If an AUTH_REQUIRED value is returned, custom_response is also set to point the browser to the login page. The reason authorization was not granted and the originally requested URI are also passed to the login page.

This function takes no input arguments.

## NEW

OK, since this will be the same - server version we can continue to use custom_response. It's worth noting however that the remote check version needs to return just the AUTH_REQUIRED response & let the caller handle redirects.

%CONFIG comes from base class

IP: The IP the user connected from. If an IP is found in the Session table (which it will if it was provided during authentication) than this argument is required and must match.

##

HISTORY

0.01

Original version; created by h2xs 1.22 with options

  -AXC
        -n
        SQCAS::Apache::Authorization

0.4

First prototype, adapted from concepts in the functional MGH::Auth module.

SEE ALSO

Mention other useful documentation such as the documentation of related modules or operating system documentation (such as man pages in UNIX), or any relevant external documentation such as RFCs or standards.

If you have a mailing list set up for your module, mention it here.

If you have a web site set up for your module, mention it here.

AUTHOR

Sean Quinlan, <seanq@darwin.bu.edu>

COPYRIGHT AND LICENSE

Copyright 2004 by Sean Quinlan, Trustees of Boston University

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