[BACK]Return to lonacc.pm CVS log [TXT] [DIR] Up to [LON-CAPA] / loncom / auth

Diff for /loncom/auth/lonacc.pm between versions 1.24 and 1.84

version 1.24, 2001/12/06 21:03:02 version 1.84, 2006/07/07 22:01:52
Line 25 Line 25
 #  #
 # http://www.lon-capa.org/  # http://www.lon-capa.org/
 #  #
 # 5/21/99,5/22,5/29,5/31,6/15,16/11,22/11,  ###
 # 01/06,01/13,05/31,06/01,09/06,09/25,09/28,10/30,11/6,  
 # 12/25,12/26,  
 # 01/06/01,05/28,8/11,9/26,11/29 Gerd Kortemeyer  
   
 package Apache::lonacc;  package Apache::lonacc;
   
Line 36  use strict; Line 33  use strict;
 use Apache::Constants qw(:common :http :methods);  use Apache::Constants qw(:common :http :methods);
 use Apache::File;  use Apache::File;
 use Apache::lonnet;  use Apache::lonnet;
   use Apache::loncommon();
   use Apache::lonlocal;
 use CGI::Cookie();  use CGI::Cookie();
 use Fcntl qw(:flock);  use Fcntl qw(:flock);
   
 sub handler {  sub cleanup {
     my $r = shift;      my ($r)=@_;
     my $requrl=$r->uri;      if (! $r->is_initial_req()) { return DECLINED; }
     my %cookies=CGI::Cookie->parse($r->header_in('Cookie'));      &Apache::lonnet::save_cache();
     my $lonid=$cookies{'lonID'};      return OK;
     my $cookie;  }
     if ($lonid) {  
  my $handle=$lonid->value;  
         $handle=~s/\W//g;  
         my $lonidsdir=$r->dir_config('lonIDsDir');  
         if ((-e "$lonidsdir/$handle.id") && ($handle ne '')) {  
   
 # ------------------------------------------- Transfer profile into environment  sub goodbye {
       my ($r)=@_;
       &Apache::lonnet::goodbye();
       return DONE;
   }
   
             my @profile;  ###############################################
     {  
              my $idf=Apache::File->new("$lonidsdir/$handle.id");  
              flock($idf,LOCK_SH);  
              @profile=<$idf>;  
              $idf->close();  
     }  
             my $envi;  
             for ($envi=0;$envi<=$#profile;$envi++) {  
  chomp($profile[$envi]);  
  my ($envname,$envvalue)=split(/=/,$profile[$envi]);  
                 $ENV{$envname} = $envvalue;  
             }  
             $ENV{'user.environment'} = "$lonidsdir/$handle.id";  
             if ($requrl=~/^\/res\//) {  
                $ENV{'request.state'} = "published";  
     } else {  
        $ENV{'request.state'} = 'unknown';  
             }  
             $ENV{'request.filename'} = $r->filename;  
   
 # -------------------------------------------------------- Load POST parameters  sub get_posted_cgi {
       my ($r) = @_;
   
       my $buffer;
       if ($r->header_in('Content-length')) {
    $r->read($buffer,$r->header_in('Content-length'),0);
       }
       unless ($buffer=~/^(\-+\w+)\s+Content\-Disposition\:\s*form\-data/si) {
    my @pairs=split(/&/,$buffer);
    my $pair;
    foreach $pair (@pairs) {
       my ($name,$value) = split(/=/,$pair);
       $value =~ tr/+/ /;
       $value =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;
       $name  =~ tr/+/ /;
       $name  =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;
       &Apache::loncommon::add_to_env("form.$name",$value);
    }
       } else {
    my $contentsep=$1;
    my @lines = split (/\n/,$buffer);
    my $name='';
    my $value='';
    my $fname='';
    my $fmime='';
    my $i;
    for ($i=0;$i<=$#lines;$i++) {
       if ($lines[$i]=~/^$contentsep/) {
    if ($name) {
       chomp($value);
       if ($fname) {
    $env{"form.$name.filename"}=$fname;
    $env{"form.$name.mimetype"}=$fmime;
       } else {
    $value=~s/\s+$//s;
       }
       &Apache::loncommon::add_to_env("form.$name",$value);
    }
    if ($i<$#lines) {
       $i++;
       $lines[$i]=~
    /Content\-Disposition\:\s*form\-data\;\s*name\=\"([^\"]+)\"/i;
       $name=$1;
       $value='';
       if ($lines[$i]=~/filename\=\"([^\"]+)\"/i) {
    $fname=$1;
    if 
                               ($lines[$i+1]=~/Content\-Type\:\s*([\w\-\/]+)/i) {
    $fmime=$1;
    $i++;
       } else {
    $fmime='';
       }
       } else {
    $fname='';
    $fmime='';
       }
       $i++;
    }
       } else {
    $value.=$lines[$i]."\n";
       }
    }
       }
   #
   # Digested POSTed values
   #
   # Remember the way this was originally done (GET or POST)
   #
       $env{'request.method'}=$ENV{'REQUEST_METHOD'};
   #
   # There may also be stuff in the query string
   # Tell subsequent handlers that this was GET, not POST, so they can access query string.
   # Also, unset POSTed content length to cover all tracks.
   #
   
                  $r->method_number(M_GET);
         my $buffer;  
   
         $r->read($buffer,$r->header_in('Content-length'));      $r->method('GET');
       $r->headers_in->unset('Content-length');
   }
   
  unless ($buffer=~/^(\-+\w+)\s+Content\-Disposition\:\s*form\-data/si) {  sub portfolio_access {
             my @pairs=split(/&/,$buffer);      my ($udom,$unum,$file_name,$group) = @_;
             my $pair;      my $current_perms = &Apache::lonnet::get_portfile_permissions($udom,$unum);
             foreach $pair (@pairs) {      my %access_controls = &Apache::lonnet::get_access_controls(
                my ($name,$value) = split(/=/,$pair);                                               $current_perms,$group,$file_name);
                $value =~ tr/+/ /;      my ($public,$guest,@domains,@users,@courses,@groups);
                $value =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;      my $now = time;
                $name  =~ tr/+/ /;      my $access_hash = $access_controls{$file_name};
                $name  =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;      if (ref($access_hash) eq 'HASH') {
                $ENV{"form.$name"}=$value;          foreach my $key (keys(%{$access_hash})) {
               my ($num,$scope,$end,$start) = ($key =~ /^([^:]+):([a-z]+)_(\d*)_?(\d*)$/);
               if ($start > $now) {
                   next;
               }
               if ($end && $end<$now) {
                   next;
               }
               if ($scope eq 'public') {
                   $public = $key;
                   last;
               } elsif ($scope eq 'guest') {
                   $guest = $key;
               } elsif ($scope eq 'domains') {
                   push(@domains,$key);
               } elsif ($scope eq 'users') {
                   push(@users,$key);
               } elsif ($scope eq 'course') {
                   push(@courses,$key);
               } elsif ($scope eq 'group') {
                   push(@groups,$key);
               }
           }
           if ($public) {
               return 'ok';
           }
           if ($env{'user.name'} eq 'public' && $env{'user.domain'} eq 'public') {
               if ($guest) {
                   return 'guest:'.$guest;
             }              }
         } else {          } else {
     my $contentsep=$1;              if (@domains > 0) {
             my @lines = split (/\n/,$buffer);                  foreach my $domkey (@domains) {
             my $name='';                      my %content = &Apache::lonnet::parse_access_controls($$access_hash{$domkey});
             my $value='';                      if (ref($content{'dom'}) eq 'ARRAY') {
             my $fname='';                          if (grep(/^\Q$env{'user.domain'}\E$/,@{$content{'dom'}})) {
             my $fmime='';                              return 'ok';
             my $i;  
             for ($i=0;$i<=$#lines;$i++) {  
  if ($lines[$i]=~/^$contentsep/) {  
     if ($name) {  
                         chomp($value);  
  if ($fname) {  
     $ENV{"form.$name.filename"}=$fname;  
                             $ENV{"form.$name.mimetype"}=$fmime;  
                         } else {  
                             $value=~s/\s+$//s;  
                         }                          }
                         $ENV{"form.$name"}=$value;  
                     }                      }
                     if ($i<$#lines) {                  }
  $i++;              }
                         $lines[$i]=~              if (@users > 0) {
  /Content\-Disposition\:\s*form\-data\;\s*name\=\"([^\"]+)\"/i;                  foreach my $userkey (@users) {
                         $name=$1;                      my %content = &Apache::lonnet::parse_access_controls($$access_hash{$userkey});
                         $value='';                      if (exists($content{'users'}{$env{'user.name'}.':'.$env{'user.domain'}})) {
                         if ($lines[$i]=~/filename\=\"([^\"]+)\"/i) {                          return 'ok';
    $fname=$1;                      }
                            if                   }
                             ($lines[$i+1]=~/Content\-Type\:\s*([\w\-\/]+)/i) {              }
       $fmime=$1;              my %roleshash;
                               $i++;              my @courses_and_groups = @courses;
    } else {              push(@courses_and_groups,@groups); 
                               $fmime='';              if (@courses_and_groups > 0) {
                            }                  my (%allgroups,%allroles); 
                   my ($start,$end,$role,$sec,$group);
                   foreach my $envkey (%env) {
                       if ($envkey =~ m-^user\.role\.(gr|cc|in|ta|ep|st)\./([^/]+)/([^/]+)/?([^/]*)$-) {
                           my $cid = $2.'_'.$3; 
                           if ($1 eq 'gr') {
                               $group = $4;
                               $allgroups{$cid}{$group} = $env{$envkey};
                           } else {
                               if ($4 eq '') {
                                   $sec = 'none';
                               } else {
                                   $sec = $4;
                               }
                               $allroles{$cid}{$1}{$sec} = $env{$envkey};
                           }
                       } elsif ($envkey =~ m-^user\.role\./cr/(\w+/\w+/\w*)./([^/]+)/([^/]+)/?([^/]*)$-) {
                           my $cid = $2.'_'.$3;
                           if ($4 eq '') {
                               $sec = 'none';
                         } else {                          } else {
     $fname='';                              $sec = $4;
                             $fmime='';                          }
                           $allroles{$cid}{$1}{$sec} = $env{$envkey};
                       }
                   }
                   if (keys(%allroles) == 0) {
                       return;
                   }
                   foreach my $key (@courses_and_groups) {
                       my %content = &Apache::lonnet::parse_access_controls($$access_hash{$key});
                       my $cnum = $content{'number'};
                       my $cdom = $content{'domain'};
                       my $cid = $cdom.'_'.$cnum;
                       if (!exists($allroles{$cid})) {
                           next;
                       }    
                       foreach my $role_id (keys(%{$content{'roles'}})) {
                           my @sections = @{$content{'roles'}{$role_id}{'section'}};
                           my @groups = @{$content{'roles'}{$role_id}{'group'}};
                           my @status = @{$content{'roles'}{$role_id}{'access'}};
                           my @roles = @{$content{'roles'}{$role_id}{'role'}};
                           foreach my $role (keys(%{$allroles{$cid}})) {
                               if ((grep/^all$/,@roles) || (grep/^\Q$role\E$/,@roles)) {
                                   foreach my $sec (keys(%{$allroles{$cid}{$role}})) {
                                       if (&course_group_datechecker($allroles{$cid}{$role}{$sec},$now,\@status) eq 'ok') {
                                           if (grep/^all$/,@sections) {
                                               return 'ok';
                                           } else {
                                               if (grep/^$sec$/,@sections) {
                                                   return 'ok' 
                                               }
                                           }
                                       }
                                   }
                                   if (keys(%{$allgroups{$cid}}) == 0) {
                                       if (grep/^none$/,@groups) {
                                           return 'ok';
                                       }
                                   } else {
                                       if (grep/^all$/,@groups) {
                                           return 'ok';
                                       } 
                                       foreach my $group (keys(%{$allgroups{$cid}})) {
                                           if (grep/^$group$/,@groups) {
                                               return 'ok';
                                           }
                                       }
                                   } 
                               }
                         }                          }
                         $i++;  
                     }                      }
                 } else {  
     $value.=$lines[$i]."\n";  
                 }                  }
             }              }
               if ($guest) {
                   return 'guest:'.$guest;
               }
           }
       }
       return;
   }
   
   sub course_group_datechecker {
       my ($dates,$now,$status) = @_;
       my ($start,$end) = split(/\./,$dates);
       if (!$start && !$end) {
           return 'ok';
       }
       if (grep/^active$/,@{$status}) {
           if (((!$start) || ($start && $start <= $now)) && ((!$end) || ($end && $end >= $now))) {
               return 'ok';
           }
       }
       if (grep/^previous$/,@{$status}) {
           if ($end > $now ) {
               return 'ok';
           }
       }
       if (grep/^future$/,@{$status}) {
           if ($start > $now) {
               return 'ok';
           }
       }
       return; 
   }
   
   sub handler {
       my $r = shift;
       my $requrl=$r->uri;
       my %cookies=CGI::Cookie->parse($r->header_in('Cookie'));
       my $lonid=$cookies{'lonID'};
       my $cookie;
       my $lonidsdir=$r->dir_config('lonIDsDir');
   
       my $handle;
       if ($lonid) {
    $handle=$lonid->value;
           $handle=~s/\W//g;
       }
         
       my ($sso_login);
       if ($r->user 
    && (!$lonid || !-e "$lonidsdir/$handle.id" || $handle eq '') ) {
    $sso_login = 1;
    my $domain = $r->dir_config('lonDefDomain');
    my $home=&Apache::lonnet::homeserver($r->user,$domain);
    if ($home !~ /(con_lost|no_such_host)/) {
       $handle=&Apache::lonauth::success($r,$r->user,$domain,
        $home,'noredirect');
       $r->header_out('Set-cookie',"lonID=$handle; path=/");
  }   }
             $r->method_number(M_GET);      }
     $r->method('GET');  
             $r->headers_in->unset('Content-length');  
   
 # ---------------------------------------------------------------- Check access      if ($sso_login) {
    &Apache::lonnet::appenv('request.sso.login' => 1);
       }
   
       if ($r->dir_config("lonBalancer") eq 'yes') {
    $r->set_handlers('PerlResponseHandler'=>
    [\&Apache::switchserver::handler]);
       }
   
             if ($requrl!~/^\/adm\//) {      if ($handle ne '') {
           if ((-e "$lonidsdir/$handle.id") && ($handle ne '')) {
   
   # ------------------------------------------------------ Initialize Environment
   
               &Apache::lonnet::transfer_profile_to_env($lonidsdir,$handle);
   
   # --------------------------------------------------------- Initialize Language
   
       &Apache::lonlocal::get_language_handle($r);
   
   # -------------------------------------------------------------- Resource State
   
               if ($requrl=~/^\/+(res|uploaded)\//) {
                  $env{'request.state'} = "published";
       } else {
          $env{'request.state'} = 'unknown';
               }
               $env{'request.filename'} = $r->filename;
               $env{'request.noversionuri'} = &Apache::lonnet::deversion($requrl);
   # -------------------------------------------------------- Load POST parameters
   
       &Apache::lonacc::get_posted_cgi($r);
   
   # ---------------------------------------------------------------- Check access
               my $now = time;
               if ($requrl =~ m|/+uploaded/([^/]+)/([^/]+)/portfolio(/.+)$|) {
                   my $result = &portfolio_access($1,$2,$3);
                   if ($result eq 'ok') {
                       return OK;
                   } elsif ($result =~ /^guest:(\w+)$/) {
                       my $guestkey = $1;
                       #FIXME need to cause generation of an intermediate page
                   }
               } elsif ($requrl =~ m|/+uploaded/([^/]+)/([^/]+)/groups/([^/]+)/portfolio/(.+)$|) {
                   my $result = &portfolio_access($1,$2,$3.'/'.$4,$3);
                   if ($result eq 'ok') {
                       return OK;
                   } elsif ($result =~ /^guest:(\w+)$/) {
                       my $guestkey = $1;
                       #FIXME need to cause generation of an intermediate page
   }
               }
               if ($requrl!~/^\/adm|public|prtspool\//) {
  my $access=&Apache::lonnet::allowed('bre',$requrl);   my $access=&Apache::lonnet::allowed('bre',$requrl);
                 if ($access eq '1') {                  if ($access eq '1') {
    $ENV{'user.error.msg'}="$requrl:bre:0:0:Choose Course";     $env{'user.error.msg'}="$requrl:bre:0:0:Choose Course";
            return HTTP_NOT_ACCEPTABLE;              return HTTP_NOT_ACCEPTABLE; 
                 }                  }
                 if (($access ne '2') && ($access ne 'F')) {                  if (($access ne '2') && ($access ne 'F')) {
    $ENV{'user.error.msg'}="$requrl:bre:1:1:Access Denied";     $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
            return HTTP_NOT_ACCEPTABLE;              return HTTP_NOT_ACCEPTABLE; 
                 }                  }
             }              }
       if ($requrl =~ m|^/prtspool/|) {
    my $start='/prtspool/'.$env{'user.name'}.'_'.
       $env{'user.domain'};
    if ($requrl !~ /^\Q$start\E/) {
       $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
       return HTTP_NOT_ACCEPTABLE;
    }
       }
       if ($env{'user.name'} eq 'public' && 
    $env{'user.domain'} eq 'public' &&
    $requrl !~ m{^/+(res|public)/} &&
    $requrl !~ m{^/+adm/(help|logout|randomlabel\.png)}) {
    $env{'request.querystring'}=$r->args;
    $env{'request.firsturl'}=$requrl;
    return FORBIDDEN;
       }
 # ------------------------------------------------------------- This is allowed  # ------------------------------------------------------------- This is allowed
           if ($ENV{'request.course.id'}) {            if ($env{'request.course.id'}) {
     &Apache::lonnet::countacc($requrl);      &Apache::lonnet::countacc($requrl);
             $requrl=~/\.(\w+)$/;              $requrl=~/\.(\w+)$/;
             if (&Apache::lonnet::fileembstyle($1) eq 'ssi') {              if ((&Apache::loncommon::fileembstyle($1) eq 'ssi') ||
    ($requrl=~/^\/adm\/.*\/(aboutme|navmaps|smppg|bulletinboard)(\?|$)/) ||
    ($requrl=~/^\/adm\/wrapper\//) ||
    ($requrl=~m|^/adm/coursedocs/showdoc/|) ||
    ($requrl=~m|\.problem/smpedit$|) ||
    ($requrl=~/^\/public\/.*\/syllabus$/)) {
 # ------------------------------------- This is serious stuff, get symb and log  # ------------------------------------- This is serious stuff, get symb and log
  my $symb=&Apache::lonnet::symbread;   my $query=$r->args;
                 $ENV{'request.symb'}=$symb;                  my $symb;
                   if ($query) {
       &Apache::loncommon::get_unprocessed_cgi($query,['symb']);
                   }
                   if ($env{'form.symb'}) {
       $symb=&Apache::lonnet::symbclean($env{'form.symb'});
                       if ($requrl =~ m|^/adm/wrapper/|
    || $requrl =~ m|^/adm/coursedocs/showdoc/|) {
                           my ($map,$mid,$murl)=&Apache::lonnet::decode_symb($symb);
                           &Apache::lonnet::symblist($map,$murl => [$murl,$mid],
     'last_known' =>[$murl,$mid]);
                       } elsif ((&Apache::lonnet::symbverify($symb,$requrl)) ||
        (($requrl=~m|(.*)/smpedit$|) &&
         &Apache::lonnet::symbverify($symb,$1))) {
                         my ($map,$mid,$murl)=&Apache::lonnet::decode_symb($symb);
         &Apache::lonnet::symblist($map,$murl => [$murl,$mid],
    'last_known' =>[$murl,$mid]);
       } else {
    $r->log_reason('Invalid symb for '.$requrl.': '.
                                          $symb);
           $env{'user.error.msg'}=
                                   "$requrl:bre:1:1:Invalid Access";
                    return HTTP_NOT_ACCEPTABLE; 
                       }
                   } else {
               $symb=&Apache::lonnet::symbread($requrl);
       if (&Apache::lonnet::is_on_map($requrl) && $symb &&
    !&Apache::lonnet::symbverify($symb,$requrl)) {
    $r->log_reason('Invalid symb for '.$requrl.': '.$symb);
           $env{'user.error.msg'}=
                                   "$requrl:bre:1:1:Invalid Access";
                    return HTTP_NOT_ACCEPTABLE; 
       }
       if ($symb) {
    my ($map,$mid,$murl)=
       &Apache::lonnet::decode_symb($symb);
    &Apache::lonnet::symblist($map,$murl =>[$murl,$mid],
    'last_known' =>[$murl,$mid]);
       }
                   }
                   $env{'request.symb'}=$symb;
                 &Apache::lonnet::courseacclog($symb);                  &Apache::lonnet::courseacclog($symb);
             } else {              } else {
 # ------------------------------------------------------- This is other content  # ------------------------------------------------------- This is other content
Line 172  sub handler { Line 470  sub handler {
   }    }
             return OK;               return OK; 
         } else {           } else { 
             $r->log_reason("Cookie $handle not valid", $r->filename)               $r->log_reason("Cookie $handle not valid", $r->filename); 
         };          }
     }      }
   
 # -------------------------------------------- See if this is a public resource  # -------------------------------------------- See if this is a public resource
     if (&Apache::lonnet::metadata($requrl,'copyright') eq 'public') {      if ($requrl=~m|^/public/|
    || (&Apache::lonnet::metadata($requrl,'copyright') eq 'public')) {
         &Apache::lonnet::logthis('Granting public access: '.$requrl);          &Apache::lonnet::logthis('Granting public access: '.$requrl);
  $ENV{'user.name'}='public';          &Apache::lonlocal::get_language_handle($r);
         $ENV{'user.domain'}='public';   my $cookie=
         $ENV{'request.state'} = "published";      &Apache::lonauth::success($r,'public','public','public');
         $ENV{'request.publicaccess'} = 1;          my $lonidsdir=$r->dir_config('lonIDsDir');
         $ENV{'request.filename'} = $r->filename;   &Apache::lonnet::transfer_profile_to_env($lonidsdir,$cookie);
    &Apache::lonacc::get_posted_cgi($r);
           $env{'request.state'} = "published";
           $env{'request.publicaccess'} = 1;
           $env{'request.filename'} = $r->filename;
   
    $r->header_out('Set-cookie',"lonID=$cookie; path=/");
         return OK;          return OK;
     }      }
 # ----------------------------------------------- Store where they wanted to go      if ($requrl=~m|^/+adm/+help/+|) {
        return OK;
     $ENV{'request.firsturl'}=$requrl;      }
     return FORBIDDEN;  # ------------------------------------- See if this is a viewable portfolio file
       if ($requrl =~ m|/+uploaded/([^/]+)/([^/]+)/portfolio(/.+)$|) {
           my $result = &portfolio_access($1,$2,$3);
           if ($result eq 'ok') {
               return OK;
           } elsif ($result =~ /^guest:(\w+)$/) {
               my $guestkey = $1;
               #FIXME need to cause generation of an intermediate page
           }
       } elsif ($requrl =~ m|/+uploaded/([^/]+)/([^/]+)/groups/([^/]+)/portfolio/(.+)$|) {
           my $result = &portfolio_access($1,$2,$3.'/'.$4,$3);
           if ($result eq 'ok') {
               return OK;
           } elsif ($result =~ /^guest:(\w+)$/) {
               my $guestkey = $1;
               #FIXME need to cause generation of an intermediate page
           }
       }
   # -------------------------------------------------------------- Not authorized
       $requrl=~/\.(\w+)$/;
   #    if ((&Apache::loncommon::fileembstyle($1) eq 'ssi') ||
   #        ($requrl=~/^\/adm\/(roles|logout|email|menu|remote)/) ||
   #        ($requrl=~m|^/prtspool/|)) {
   # -------------------------- Store where they wanted to go and get login screen
    $env{'request.querystring'}=$r->args;
    $env{'request.firsturl'}=$requrl;
          return FORBIDDEN;
   #   } else {
   # --------------------------------------------------------------------- Goodbye
   #       return HTTP_BAD_REQUEST;
   #   }
 }  }
   
 1;  1;
 __END__  __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
Removed from v.1.24  
changed lines
  Added in v.1.84

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>