Return to lonuploadedacc.pm CVS log

Up to [LON-CAPA] / loncom / auth

Moved POD comments to bottom of file

    1: # The LearningOnline Network
    2: # Access Handler for User Files
    3: #
    4: # $Id: lonuploadedacc.pm,v 1.15 2008/11/20 15:19:22 jms Exp $
    5: #
    6: # Copyright Michigan State University Board of Trustees
    7: #
    8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
    9: #
   10: # LON-CAPA is free software; you can redistribute it and/or modify
   11: # it under the terms of the GNU General Public License as published by
   12: # the Free Software Foundation; either version 2 of the License, or
   13: # (at your option) any later version.
   14: #
   15: # LON-CAPA is distributed in the hope that it will be useful,
   16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
   17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   18: # GNU General Public License for more details.
   19: #
   20: # You should have received a copy of the GNU General Public License
   21: # along with LON-CAPA; if not, write to the Free Software
   22: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
   23: #
   24: # /home/httpd/html/adm/gpl.txt
   25: #
   26: # http://www.lon-capa.org/
   27: #
   28: 
   29: 
   30: 
   31: package Apache::lonuploadedacc;
   32: 
   33: 
   34: use strict;
   35: use Apache::Constants qw(:common :http);
   36: use Apache::lonnet;
   37: 
   38: sub handler {
   39:     my $r = shift;
   40:     my $args=$r->args;
   41:     &Apache::loncommon::get_unprocessed_cgi($args,['token','tokenissued']); 
   42:     my (undef,undef,$udom,$uname,$ufile)=split(/\//,$r->uri,5);
   43:     $ufile=~s/^[\~\.]+//;
   44:     my $remoteserver=$env{'form.tokenissued'};
   45:     my $reply=&Apache::lonnet::reply('tokenauthuserfile:'.
   46:                  $udom.'/'.$uname.'/'.$ufile.':'.$env{'form.token'},
   47: 				     $remoteserver);
   48:     if ($reply eq 'ok') {
   49:        return OK;
   50:    } elsif ($reply eq 'con_lost' || $reply eq 'no_such_host') {
   51:        &Apache::lonnet::logthis("Server unavailable for userfile access $uname at $udom for $ufile with $remoteserver token $env{'form.token'}: $reply");
   52:        return HTTP_SERVICE_UNAVAILABLE;
   53:    } else {
   54:        &Apache::lonnet::logthis("Refused userfile access $uname at $udom for $ufile with $remoteserver token $env{'form.token'}: $reply");
   55:        return FORBIDDEN;
   56:    }
   57: }
   58: 
   59: sub skip_phase {
   60:     return OK;
   61: }
   62: 
   63: 1;
   64: __END__
   65: 
   66: 
   67: 
   68: =head1 NAME
   69: 
   70: Apache::lonuploadedacc
   71: 
   72: =head1 SYNOPSIS
   73: 
   74: The way this is supposed to work:
   75: 
   76:  User A has client machine C 
   77:  User A is logged into LON-CAPA server S
   78:  needs file from user B
   79:  homeserver for user B is H
   80: 
   81: This is part of the LearningOnline Network with CAPA project
   82: described at http://www.lon-capa.org.
   83: 
   84: =head1 HANDLER SUBROUTINE
   85: 
   86: This handler runs on H
   87: To access a userfile:
   88: Server S generates a token and puts it into the query string of URL for H
   89: Client box C asks H for file with token issued by C
   90: H now must ask S if token is valid, uses S's lond-command tokenauthuserfile
   91: 
   92: =cut
   93: 
   94: 
   95: