home *** CD-ROM | disk | FTP | other *** search
/ CD Shareware Magazine 1996 December / CD_shareware_12-96.iso / DOS / Comunic / CS_102.ZIP / CHECKSEC.DOC < prev    next >
Encoding:
Text File  |  1996-06-20  |  8.5 KB  |  188 lines
  1.  [CHECKSEC.DOC]
  2.  
  3.  
  4.                          CheckSec for Wildcat! v5.x
  5.  
  6.   Q. CheckSec?  What is it?
  7.   A. A wcCODE application (WCX) to run a security profile check on a user
  8.      before executing a menu option.
  9.  
  10.   Q. What does it do?
  11.   A. Using a configuration file, it will allow or deny access to a specified
  12.      menu command/WCX, and notify the denied user WHY the command may not be
  13.      accessed!
  14.  
  15.   Q. What is it good for, give me an example?
  16.   A. The basis of this utility was to alert a user that the menu command they
  17.      had just attempted to execute is not allowed for their security level.
  18.      I have had many users execute a command only to have it bounce right
  19.      back to the menu - they all either decided it didn't work, or that the 
  20.      BBS was not completely functional.  I wanted them to know it all worked
  21.      and that if they wanted to access a (certain) feature, they would have to
  22.      have a different security level - by donating or what have you.
  23.  
  24.   Q. I have many menu options I would like to restrict, can I run more
  25.      than one CheckSec?
  26.   A. Yes, you may specify a configuration file as a parameter - allowing
  27.      as many CheckSec's as you like.  Keep in mind that you only need one
  28.      CHECKSEC.WCX in your Wildcat v5 home directory, but you can have as
  29.      many configuration and access profile files as you like, the only
  30.      restriction is configuring wcMENU accordingly.
  31.  
  32.   Q. I'm confused, can you give me an example?
  33.   A. Yes, unzip CHECKSEC.WCX, CHECKSEC.CFG, and BASIC.SEC to your Wildcat
  34.      home directory - using the default configuration file (checksec.cfg)
  35.      you will deny access to PAGE THE SYSOP to any user with a security level
  36.      listed in the BASIC.SEC file.  Be sure to replace the "Page Sysop"
  37.      command in wcMENU with CheckSec (see example below).
  38.  
  39.   Q. Nice utility, but why should I register?
  40.   A. Registration grants you FREE lifetime upgrades, and gets rid of the nag
  41.      screen and Activity Log notations.  As the product features improve, 
  42.      registration may increase - register early and benefit forever!  
  43.      Registration also encourages me to add more features, and it (might)
  44.      give you that warm fuzzy feeling of having done something good.
  45.  
  46.  ────────────────────────────────────────────────────────────────────────────
  47.  FEATURES:
  48.  ────────────────────────────────────────────────────────────────────────────
  49.  
  50.   * Highly Versatile
  51.  
  52.   * Optional use of your own display file(s)
  53.     Seperate display files for your specific BBS!
  54.  
  55.   * Checks Access Profiles 1 and 2!  
  56.     This allows for even greater control and restrictions!    
  57.  
  58.   * Small, effitient code
  59.  
  60.   * Extensive error control
  61.  
  62.   * Easy-to-use and affordable!     
  63.  
  64.   (For later releases, see CHECKSEC.NEW for the latest about CheckSec, and
  65.    CHECKSEC.UPG for upgrade information).
  66.  ────────────────────────────────────────────────────────────────────────────
  67.  INSTALLATION/SETUP:
  68.  ────────────────────────────────────────────────────────────────────────────
  69.   1. Unzip the following to your Wildcat home directory (C:\WC5):
  70.  
  71.       CHECKSEC.WCX       - main program
  72.       CHECKSEC.CFG       - configuration file
  73.       CHECKSEC.SEC       - list of security profiles to deny access
  74.  
  75.      OPTIONAL:
  76.      Create a display screen for users denied access, be sure to specify
  77.      the extention (enter filename on line 5 in configuration file).
  78.  
  79.   2. Edit CHECKSEC.CFG and CHECKSEC.SEC to suit your needs.     
  80.  
  81.   3. Run wcMENU, if you are replacing a current menu option with CheckSec,
  82.      then simply edit that menu option to reflect CheckSec and the 
  83.      corresponding configuration file.  Give access to all security levels,
  84.      levels you want to restrict will go into the security profile list.
  85.  
  86.      The following example requires CHECKSEC.WCX and CHECKSEC.CFG to be in 
  87.      your Wildcat home directory.  The security profile list you specify on
  88.      line four (4) in CHECKSEC.CFG must also be present.
  89.  
  90.      This example will deny access to PAGE THE SYSOP to any profile that is
  91.      specified in the profile list.  
  92.  
  93.      Example:
  94.     ┌─────────────────────────────────────────────────────────────────┬─┬─┐
  95.     │░░ EDIT MENU ITEM ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│?│X│
  96.     ├─────────────────────────────────────────────────────────────────┴─┴─┤
  97.     │  Selection Key  [ P       ▌]                           ▐   OK   ▌  │
  98.     │                                                                     │
  99.     │  Description    [ [P].............Page Sysop ]          ▐ Cancel ▌  │
  100.     │                                                                     │
  101.     │  Command Type   [ Run WcCODE Program ▌]                            │
  102.     │                                                                     │
  103.     │  Program        [ CHECKSEC                      ▌]     ▐ Access ▌  │
  104.     │                                                                     │
  105.     │  Parameters     [ CheckSec.CFG                    ]                 │
  106.     │                                                                     │
  107.     └─────────────────────────────────────────────────────────────────────┘
  108.              Be sure to give Access to all levels on this screen!
  109.  
  110.     PLEASE NOTE:
  111.  
  112.     If you do not enter a configuration file as a parameter, CheckSec will
  113.     default to CHECKSEC.CFG.
  114.  
  115.   4. Always make a test run, to be sure you have everything setup correctly.
  116.      No new screens are needed, unless you are adding menu options instead 
  117.      of replacing them.  You are now finished!
  118.  
  119.  ────────────────────────────────────────────────────────────────────────────
  120.   MULTIPLE CHECKSECs:
  121.  ────────────────────────────────────────────────────────────────────────────
  122.   If you run more than one CheckSec, you will have to use different
  123.   configuration files (the security access file may be used for any CheckSec 
  124.   setup).  Be sure to give it a different name (does not have to be a .CFG 
  125.   extention, but for your own sanity, name it something related to the menu 
  126.   option).
  127.  
  128.   Configuration files and security profile lists are straight ASCII files.
  129.  
  130.  ────────────────────────────────────────────────────────────────────────────
  131.  CONFIGURATION FILES:
  132.  ────────────────────────────────────────────────────────────────────────────
  133.  
  134.   Configuration files consist of four (4) lines each.  Nothing below the 
  135.   fourth line will be read, use it for notes on the program/command you are
  136.   restricting.
  137.  
  138.   Line 1:  Registration Number
  139.   Line 2:  WCX/Menu command to run
  140.   Line 3:  Parameter, if any
  141.   Line 4:  ASCII file with Security Profiles denied access to 
  142.            program on Line 2.
  143.   Line 5:  (Optional) Display screen, include extention!!
  144.  
  145.   See EXAMPLE1.CFG and EXAMPLE2.CFG for other ideas and uses.
  146.  
  147.  ────────────────────────────────────────────────────────────────────────────
  148.  SECURITY PROFILE FILES: (Specified on Line 4 in configuration file)
  149.  ────────────────────────────────────────────────────────────────────────────
  150.  
  151.   Be sure to enter one access level per line, and DO NOT leave a blank line!
  152.   Blank lines will deny ALL access levels.
  153.  
  154.  ────────────────────────────────────────────────────────────────────────────
  155.   REGISTRATION:
  156.  ────────────────────────────────────────────────────────────────────────────
  157.   Registration will eliminate the nag screen and log notices.  Registration
  158.   also changes the Activity from "CheckSec" to asterisks (seen when running
  159.   Who's Online).  You will be entitled to FREE future upgrades.  
  160.   Registration is only $10.00.
  161.   
  162.   Please send your registration fee (U.S. funds only) to:
  163.  
  164.      Corinne King             <-- Payable to
  165.      481 Parkwood lane
  166.      Arab, Alabama 35016
  167.  
  168.  ────────────────────────────────────────────────────────────────────────────
  169.   SUPPORT:
  170.  ────────────────────────────────────────────────────────────────────────────
  171.   For the latest versions and support, contact me at any of the following:
  172.  
  173.     Internet:         mailto: CorkyK@mindspring.com
  174.                       http://www.mindspring.com/~peking/code.html
  175.  
  176.          BBS:         Alter Ego BBS   (my BBS)
  177.                       (205) 586-0555
  178.                       9600-28800 only
  179.                       mail to: SysOp/Corky King
  180.  
  181.                       MSI HQ 5
  182.                       (803) 873-2400
  183.                       bbs.mustang.com (telnet)
  184.                       mail to: Corinne King
  185.  
  186.   Send in feature requests, or removals!
  187.  ────────────────────────────────────────────────────────────────────────────
  188.