home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / PCBOARD / PWD16.ZIP / PASSWORD.DOC < prev    next >
Text File  |  1994-01-02  |  12KB  |  244 lines
  1.  
  2. *****************************************************************************
  3.   PWD16.ZIP - PASSWORD.PPE version 1.6 compiled on 01/02/94 by James R. Erck
  4.  
  5.   PASSWORD.PPE is a PPL (PCBoard Programming Language) program designed to
  6.   allow a caller to reset their own password if they can match the
  7.   information contained in the verification PSA.  All comments or
  8.   suggestions about this program should be directed to me (see below).
  9.  
  10.   NOTE:  DO NOT DISTRIBUTE modified source code without prior permission
  11.   or without meeting the requirements set forth in this file.
  12. *****************************************************************************
  13.  
  14.  
  15.    About the program:
  16.    -----------------
  17.    I was originally inspired to write this program after downloading a PPE
  18.    called FORGETPW from Salt Air (sorry, I can't give credit here as there
  19.    was no name included in the file).  This program would allow a user to
  20.    leave a message to the Sysop upon password failure.  I started thinking,
  21.    "okay, but why not let them update their own password and take the job
  22.    away from the Sysop?"  Hence, the concept for the original PWD10.ZIP.
  23.  
  24.    I've tried to make the program as configurable as possible (with caller
  25.    log and/or message notifications).  Print the file PASSWORD.CFG for a
  26.    complete description of the mandatory configuration options.
  27.  
  28.  
  29.  
  30.    What the program will do: (options with ** are new for this upgrade).
  31.    --------------------------------------------------------------------------
  32.  **   added a configurable option for maximum security level.  If the
  33.       callers security level is greater than what is specified in the
  34.       configuration file the program will not run.  Added optional caller
  35.       log and message options to show if this occurs.
  36.  
  37.    .  added the ability to enter additional characters in the Verification
  38.       field if you're using something other than "Mother's Maiden Name".
  39.  
  40.    .  if you are using something other than PCBoard's default value of
  41.       "Mother's Maiden Name" for the callers entry into the Verification PSA
  42.       you can have this other value displayed by entering the definition of
  43.       it on the appropriate line in the configuration file.
  44.  
  45.    .  check to see if the VERIFICATION and ADDRESS PSA's are installed (the
  46.       program will end if they're not)
  47.  
  48.    .  check for the existence of the configuration file (PASSWORD.CFG). The
  49.       program will end if it doesn't exist or it's not in the PPE directory)
  50.  
  51.    .  read PCBOARD.DAT to see what the Sysop has selected in PCBSETUP as the
  52.       minimum allowable password length, display this length to the caller
  53.       and disallow a password entry/update if the password is shorter.
  54.       **NOTE**  You do not have to have the Password PSA installed to use
  55.       this field in PCBSETUP.  All this program will do is read what you
  56.       have entered in the field in PCBSETUP and force the callers password
  57.       to be a minimum of that length.  The maximum length defaults to 12. If
  58.       a different maximum length is desired let me know and I can make this
  59.       an option too.
  60.  
  61.    .  if the PASSWORD PSA is installed it will not allow the update to an
  62.       old password contained in their record. The user will be told their
  63.       password was not updated and be prompted to enter a different one.
  64.  
  65.    .  allows for 11 configurable options to be written to the caller log for
  66.       the Sysop to see what the caller did while in the program. These are
  67.       selected in the PASSWORD.CFG file (read that file for instructions and
  68.       explanations)
  69.  
  70.    .  allows for 3 configurable options to have private messages sent to the
  71.       name/directory of your choice when:
  72.       (1) the program is executed
  73.       (2) a caller entered incorrect verification information (possible
  74.           attempt to hack into an existing account)
  75.       (3) a password was successfully reset.
  76.  
  77.    .  optionally sends a message to the user in the conference of your
  78.       choice when their password has been reset.
  79.  
  80.    .  if the Verification Information is not entered into the PSA the
  81.       program will not display their Address Information but will just
  82.       prompt the caller for phone number and new password and will format
  83.       this information into the "COMMENT: PASSWORD FAILURE" generated by
  84.       PCBoard.
  85.  
  86.    .  if the Verification Information exists their User Address Information
  87.       will be displayed asking them to verify it as being theirs. If they
  88.       answer YES they'll be prompted for the Verification Information. If
  89.       they answer NO (possible duplicate name) they'll be prompted to call
  90.       back using a variation of their name and also to leave a private
  91.       message to the Sysop.
  92.  
  93.    .  which lines of the User Address Information and what information from
  94.       their user record is displayed to them is now configurable by you.
  95.  
  96.    .  if the first entry of Verification Information they type does
  97.       match what is stored in the Verification PSA they'll be prompted
  98.       (twice for error checking) for a new password.  If the first entry of
  99.       Verification Information does NOT match they'll be promted again
  100.       for the Verification name.  If this entry matches they'll be prompted
  101.       for a new password.  If neither entry matches the verification name
  102.       they'll be prompted for a voice phone number and new password which
  103.       will be formatted into PCBoard's "COMMENT: PASSWORD FAILURE".
  104.  
  105.    .  All passwords will also be checked against the allowable minimum
  106.       length and if correct will update their user record with the changes.
  107.       Once the password is updated they will be informed that, because their
  108.       original password failed, they'll be automatically logged off but can
  109.       use their new password on the next call.
  110.  
  111.    .  WHEW!  If you can think of any other checking that needs to be done
  112.       I'm always open for constructive criticism <grin>.
  113.  
  114.  
  115.    Files : The following files are included in the PWD16.ZIP archive:
  116.    -----------------------------------------------------------------
  117.    HISTORY .DOC - program history
  118.    PASSWORD.CFG - configuration file to set caller log and message options
  119.    PASSWORD.DOC - this text file
  120.    PASSWORD.PPE - the PPL executable
  121.    PASSWORD.PPS - source code
  122.    PWD_PPE. MSG - optional message to Sysop when program is executed
  123.    PWD_PASS.MSG - optional message to Sysop when password has been reset
  124.    PWD_SEC. MSG - optional message to Sysop if invalid security level
  125.    PWD_USER.MSG - optional message to User when password has been reset
  126.    VER_FAIL.MSG - optional message to Sysop if verification info doesn't match
  127.  
  128.  
  129.    Installation
  130.    ------------
  131.    1) Both the VERIFICATION and ADDRESS PSA's must be installed on your
  132.       system and must contain the callers information (obviously if these
  133.       are not installed or blank the program has nothing to display or
  134.       verify against and will not run).  NOTE: The PASSWORD PSA doesn't
  135.       need to be installed but if it is the program will not update their
  136.       password if they type in one previously stored in this record.
  137.  
  138.       An easy way to have your users enter their information is to install
  139.       the following PPL programs written by Larry Steele:
  140.       UAI.PPE - (Usage Account Info)
  141.       WUI.PPE - (Write User Information)
  142.       I've personally found both of these invaluable.  Thanks Larry!
  143.  
  144.    2) In PCBSETUP > CONFIGURATION ITEMS > SYSTEM CONTROL you should have
  145.       "Allow Password Failure Comment" set to Y.  The PASSWORD.PPE program
  146.       will prompt a caller for their voice phone number and new password if
  147.       their verification information was never entered into the Verification
  148.       PSA or if they enter invalid verification information.  This
  149.       information will be formatted into the "COMMENT: PASSWORD FAILURE"
  150.       comment that is generated by PCBoard and sent to the Sysop.
  151.  
  152.    3) Copy all of the files in PWD16.ZIP to the directory of your choice.
  153.  
  154.    4) Run MKPCBTXT to edit your PCBTEXT file
  155.  
  156.    5) Press the F3 function key and select record #595.
  157.  
  158.    6) Type in the full path and filename for PASSWORD.PPE (preceded by an
  159.       exclamation point, as in !d:\pcb\ppe\password\password.ppe).
  160.  
  161. ╒══════════════════════════════════════════════════════════════════════════════╕
  162. │   Record No.:  595          Record Length:  40        Justification:  Left   │
  163. ├──────────────────────────────────────────────────────────────────────────────┤
  164. │Did you forget your password?                                                 │
  165. │!d:\pcb\ppe\password\password.ppe                                             │
  166. ╘══════════════════════════════════════════════════════════════════════════════╛
  167.  
  168.    7) Edit the PASSWORD.CFG file to select your caller log and message
  169.       options.
  170.  
  171.  
  172.  
  173.    Legalities:
  174.    ----------
  175.    I can only guarantee that it will take up space on your hard drive.
  176.  
  177.    Modifying:
  178.    ---------
  179.    The source code may be modified for your own personal needs. Do NOT
  180.    modify the code and distribute it without prior consent from me.  If you
  181.    have suggestions or comments about the program contact me and I will try
  182.    to include them in the program (and give you full credit in the
  183.    HISTORY.DOC).
  184.  
  185.    Distribution:
  186.    ------------
  187.    You may make this file available for downloading from your BBS or you
  188.    may upload it to any BBS of your choice, provided that you do not make
  189.    any changes to the contents of the original archive (PWD16.ZIP file).
  190.    You may NOT charge any monies whatsoever for the use of this program.
  191.  
  192.    Support:
  193.    -------
  194.    If for any reason you need to contact me I can be reached at one of the
  195.    following (address messages to JIM ERCK):
  196.  
  197.      Knight Moves BBS - (Fidonet Netmail - 1:2613/313)
  198.      Node #1 - (716) 865-2196--14.4 v.32bis (public access)
  199.      Node #2 - (716) 865-8843--14.4 v.32bis (public access)
  200.      Node #3 - PRIVATE---------14.4 v.32bis (subscribers only)
  201.      Node #4 - PRIVATE---------14.4 v.32bis (subscribers only)
  202.      Node #5 - (716) 865-2466--HST only     (public access)
  203.      Node #6 - PRIVATE / LOCAL NODE
  204.      Node #7 - PRIVATE / MAIL DELIVERY / SYSOP ACCESS
  205.  
  206.      Fidonet -  PCBOARD (CDC) support conference
  207.                 PCBNET support conference
  208.  
  209.      Usenet  - alt.bbs.pcboard
  210.  
  211.      Salt Air - (I usually call once a week)
  212.         Conf# 37 (RLY-Support)  (make sure you "echo" these messages as they
  213.                                 as they are gated into the above Fidonet
  214.                                 PCBOARD conference).
  215.         Conf #39 (PPLC)  (PPL programmers only)
  216.         Conf #57 (PPE)   (general PPE discussions)
  217.  
  218.      Internet - erck@rochgte.fidonet.org
  219.  
  220.    Registration:
  221.    ------------
  222.    This is my first release of any program for public usage. Because of
  223.    this I've decided the program will be absolutely FREE!  It's my way of
  224.    saying thanks to:
  225.  
  226.    1) CDC for making the best BBS software.
  227.  
  228.    2) Others who have included the source code with their programs.  Thanks
  229.       guys (and gals), you allowed me to learn a lot!
  230.  
  231.    If you feel like this program has served a useful purpose to you and
  232.    would like to donate something stuff a few dollars in an envelope and
  233.    mail it off to your local chapter of the American Cancer Society.
  234.  
  235.    If you have any suggestions, comments or thoughts about this program I'd
  236.    appreciate hearing them.  I can be reached as described above or by
  237.    U.S. (Snail) Mail:
  238.  
  239.      James R. Erck
  240.      194 Wycliff Drive
  241.      Webster, NY 14580-2824
  242.      USA
  243.  
  244.