Return to CrGrant.pl CVS log

Up to [LON-CAPA] / loncom

Block out top level logic.

    1: #!/usr/bin/perl
    2: # The LearningOnline Network
    3: # CrGrant.pl  - Grant a loncapa SSL certificate.
    4: #
    5: # $Id: CrGrant.pl,v 1.1 2004/07/02 10:51:18 foxr Exp $
    6: #
    7: # Copyright Michigan State University Board of Trustees
    8: #
    9: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
   10: #
   11: # LON-CAPA is free software; you can redistribute it and/or modify
   12: # it under the terms of the GNU General Public License as published by
   13: # the Free Software Foundation; either version 2 of the License, or 
   14: # (at your option) any later version.
   15: #
   16: # LON-CAPA is distributed in the hope that it will be useful,
   17: # but WITHOUT ANY WARRANTY; without even the implied warranty of
   18: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   19: # GNU General Public License for more details.
   20: #
   21: # You should have received a copy of the GNU General Public License
   22: # along with LON-CAPA; if not, write to the Free Software
   23: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
   24: #
   25: # /home/httpd/html/adm/gpl.txt
   26: #
   27: 
   28: 
   29: # http://www.lon-capa.org/
   30: #
   31: # This script operates on a certificate request that has been
   32: # extracted from the attachment sent to the loncapa certificate 
   33: # administrator and:
   34: #
   35: #  1. Creates an ssl certificate corresponding to the request.
   36: #  2. Constructs an installation script that will install
   37: #     the certificate along with the certificate authority's
   38: #     certificate in a loncapa system.
   39: #  3. Constructs an email which contains a cover letter 
   40: #     describing what to do with the attachment, and an
   41: #     attachment that consists of the installation script
   42: #     created in step 2.
   43: #  4. Emails the message to the email address in the certificate
   44: #     request.
   45: #
   46: #  There are some assumptions we need to make in order to
   47: #  get this all to work:
   48: #    - The certificate authority is installed on a 
   49: #      loncapa system with configuration files that specify
   50: #      the same certificate directory and certificate filenames
   51: #      as the target system (otherwise we can't generate the
   52: #      installation script).
   53: #    - The loncapa certificate authority configuration file is
   54: #      $SSLDir/loncapaca.cnf and that it specifies that:
   55: #      o The certificate authority files are in $SSLDir/loncapaca
   56: #      o The certificate authority certificate is in:
   57: #         $SSLDir/loncapaca/cacert.pem
   58: #      o The certificate authority maintains a certificate index file
   59: #        $SSLDIR/loncapaca/index.txt
   60: #      o Only one instance of this script will be run at a time!!!!!
   61: #        (otherwise the last line of the index file may not be the
   62: #         index to our certificate.  We'll do some rudimentary
   63: #         error checking, but have no idea how to recover in case
   64: #         of problems).
   65: #      o The generated certificates are stored in $SSLDIR/loncapaca/certs
   66: #      o The person that runs this script knows the passphrase
   67: #        for the loncapa certificate authority's private key
   68: #        which remains encrypted for security reasons.
   69: #
   70: #
   71: 
   72: # Import section:
   73: 
   74: use strict;
   75: use lib '/home/httpd/lib/perl';
   76: use MIME::Entity;
   77: use LONCAPA::Configuration;
   78: 
   79: 
   80: 
   81: # Global variable declarations
   82: 
   83: 
   84: 
   85: # Debug/log support
   86: 
   87: my $DEBUG=1;
   88: 
   89: sub Debug {
   90:     my $msg = shift;
   91:     if($DEBUG) {
   92: 	print STDERR "$msg\n";
   93:     }
   94: }
   95: #  Support subs:
   96: 
   97: sub Usage {}
   98: 
   99: sub CreateCertificate {
  100:     my $RequestFile = shift;
  101: 
  102:     return 'fox@nscl.msu.edu';   # Stub..
  103: }
  104: sub CreateInstallScript {}
  105: 
  106: sub CreateEmail {
  107:     return "Dummy message";	# Stub.
  108: }
  109: 
  110: sub SendEmail {
  111:     my ($EmailAddress, $Message) = @_;
  112: }
  113: sub Cleanup {}
  114: 
  115: 
  116: #  Program entry point
  117: #   The usage is:
  118: #     CrGrant.pl    {request_file}
  119: #
  120: 
  121: my $argc = @ARGV;		# Count number of command parameters.
  122: if($argc != 1) {
  123:     Usage;
  124:     exit -1;
  125: }
  126: my $CertificateRequest = $ARGV[0];
  127: 
  128: my $EmailAddress = CreateCertificate($CertificateRequest);
  129: CreateInstallScript;
  130: my $Message = CreateEmail;
  131: SendEmail($EmailAddress, $Message);
  132: Cleanup;
  133: 
  134: # POD documentation.