--- loncom/auth/lonacc.pm 2008/11/16 02:46:19 1.118 +++ loncom/auth/lonacc.pm 2008/11/18 19:14:34 1.119 @@ -1,7 +1,7 @@ # The LearningOnline Network # Cookie Based Access Handler # -# $Id: lonacc.pm,v 1.118 2008/11/16 02:46:19 raeburn Exp $ +# $Id: lonacc.pm,v 1.119 2008/11/18 19:14:34 jms Exp $ # # Copyright Michigan State University Board of Trustees # @@ -27,6 +27,69 @@ # ### +=head1 NAME + +Apache::lonacc - Cookie Based Access Handler + +=head1 SYNOPSIS + +Invoked (for various locations) by /etc/httpd/conf/srm.conf: + + PerlAccessHandler Apache::lonacc + +=head1 INTRODUCTION + +This module enables cookie based authentication and is used +to control access for many different LON-CAPA URIs. + +Whenever the client sends the cookie back to the server, +this cookie is handled by either lonacc.pm or loncacc.pm +(see srm.conf for what is invoked when). If +the cookie is missing or invalid, the user is re-challenged +for login information. + +This is part of the LearningOnline Network with CAPA project +described at http://www.lon-capa.org. + +=head1 HANDLER SUBROUTINE + +This routine is called by Apache and mod_perl. + +=over 4 + +=item * + +transfer profile into environment + +=item * + +load POST parameters + +=item * + +check access + +=item * + +if allowed, get symb, log, generate course statistics if applicable + +=item * + +otherwise return error + +=item * + +see if public resource + +=item * + +store attempted access + +=back + +=cut + + package Apache::lonacc; use strict; @@ -459,65 +522,3 @@ sub handler { 1; __END__ - -=head1 NAME - -Apache::lonacc - Cookie Based Access Handler - -=head1 SYNOPSIS - -Invoked (for various locations) by /etc/httpd/conf/srm.conf: - - PerlAccessHandler Apache::lonacc - -=head1 INTRODUCTION - -This module enables cookie based authentication and is used -to control access for many different LON-CAPA URIs. - -Whenever the client sends the cookie back to the server, -this cookie is handled by either lonacc.pm or loncacc.pm -(see srm.conf for what is invoked when). If -the cookie is missing or invalid, the user is re-challenged -for login information. - -This is part of the LearningOnline Network with CAPA project -described at http://www.lon-capa.org. - -=head1 HANDLER SUBROUTINE - -This routine is called by Apache and mod_perl. - -=over 4 - -=item * - -transfer profile into environment - -=item * - -load POST parameters - -=item * - -check access - -=item * - -if allowed, get symb, log, generate course statistics if applicable - -=item * - -otherwise return error - -=item * - -see if public resource - -=item * - -store attempted access - -=back - -=cut