home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / WVER.ZIP / WWVERIFY.DOC < prev    next >
Text File  |  1995-01-03  |  19KB  |  432 lines
  1.  
  2.  
  3.  
  4.                    
  5.                 ***   wwVerify   ***
  6.                   Version 1.11 Demo
  7.             a wcCode call back verifier
  8.              for the most Awesome BBS 'Wildcat 4'
  9.          
  10.             
  11.             (C) Copyright 1994 Wildware!
  12.                  All Rights Reserved
  13.   
  14.  
  15.                  Wildware!
  16.                3443 N. Parkway Drive Suite 22
  17.                Fresno, California 93722-4770
  18.                  BBS (209) 277-3005 
  19.         
  20.       ****  To place an order call our authorized dealer  ****       
  21.              BBS Technologies at (209) 498-0200
  22.  
  23.           
  24.     
  25.     
  26.     *****     For technical support please call our Support BBS    *****
  27.    *******  and leave a message in the wwVerify Support Conference  *****
  28.                 BBS (209) 277-3005
  29.  
  30.                   
  31.  
  32.   This demo version will work with (all) versions of Wildcat! 4.01 and will
  33.   do everything the registered version will except upgrade the callers 
  34.   security level after being verified.
  35.               
  36.   ******* Please note: This version is ONLY for version 4.01 of Wildcat!
  37.  
  38.               
  39.               Documentation version 1.11
  40.   
  41.  
  42.           
  43.   
  44.             ------- Legal Stuff -------
  45.   
  46.   
  47.   *************************************************************************
  48.   * By using this software you agree to the terms of the Software License *
  49.   * Agreement, Limited Warranty on Diskettes and Disclaimer of Warranty.  *
  50.   *************************************************************************
  51.  
  52.  
  53.               SOFTWARE LICENSE AGREEMENT
  54.               --------------------------
  55.  
  56.  This software is LICENSED not sold.
  57.  
  58.  
  59.  
  60.  You may:
  61.  --------
  62.  (1) Make as many backups as you see fit to protect your investment.
  63.  
  64.  (2) Use this software on as many nodes as you are licensed for. If
  65.      you run more than one BBS you must purchase an additional license
  66.      agreement(s) to comply with this license.
  67.  
  68.  Besides the above rights you have no other rights to the software, implied
  69.  or otherwise.
  70.  
  71.  You may NOT:
  72.  ------------
  73.  (1) Reverse-Engineer, Decompile or Alter the software in any way.
  74.  
  75.  (2) Rent, Lease or Lend the software that you have licensed.
  76.  
  77.  (3) Give out or let anybody use your software activation code.
  78.  
  79.   
  80.  
  81.   If you breach this License Agreement Wildware! will terminate
  82.   your license and all software and manuals must be returned
  83.   back to Wildware! or authorized dealer and use of the
  84.   software must be terminated.
  85.  
  86.  
  87.  
  88.  
  89.  
  90.                ------- More Legal Stuff -------   
  91.             
  92.             
  93.             LIMITED WARRANTY OF DISKETTE(S)
  94.             -------------------------------
  95.  
  96.  WILDWARE! WARRANTS TO THE ORIGINAL LICENSEE OF A REGISTERED PRODUCT THAT
  97.  THE PROGRAM DISKETTE(S) ON WHICH THE PROGRAM IS RECORDED WILL BE FREE
  98.  FROM DEFECTS IN MATERIALS AND WORKMANSHIP UNDER NORMAL USE FOR A PERIOD OF
  99.  NINETY (90) DAYS FROM THE DATE OF DELIVERY. WILDWARE!'S ENTIRE LIABILITY
  100.  AND YOUR EXCLUSIVE REMEDY SHALL BE REPLACEMENT OF THE DISKETTE(S) NOT
  101.  MEETING WILDWARE!'S LIMITED WARRANTY IF RETURNED TO WILDWARE! WITHIN THE
  102.  (90) DAY PERIOD.
  103.  
  104.             DISCLAIMER OF SOFTWARE WARRANTY
  105.             -------------------------------
  106.  
  107.  THIS SOFTWARE PRODUCT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. THE
  108.  ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF THIS SOFTWARE IS ASSUMED
  109.  BY YOU (NOT WILDWARE!). WILDWARE! DOES NOT WARRANT, GUARANTEE, OR MAKE ANY
  110.  REPRESENTATIONS REGARDING THE USE OF, RESULTS OF, MERCHANTABILITY OR
  111.  FITNESS FOR A PARTICULAR USE OF THIS SOFTWARE. SHOULD THE SOFTWARE PROVE
  112.  DEFECTIVE, YOU (NOT WILDWARE!) ASSUME THE ENTIRE COST OF ALL NECESSARY
  113.  SERVICING, REPAIR OR CORRECTION EVEN IF WILDWARE! HAS BEEN NOTIFIED OF A
  114.  DEFECT(S). WILDWARE DOES NOT WARRANT, GUARANTEE, OR MAKE ANY REPRESENTATIONS
  115.  REGARDING THE USE OF, OR RESULTS OF THE USE OF THE SOFTWARE IN TERMS OF
  116.  CORRECTNESS, ACCURACY, RELIABILITY, OR OTHERWISE. YOU RELY ON THE SOFTWARE 
  117.  AND RESULTS SOLELY AT YOUR OWN RISK. WILDWARE! WILL NOT BE LIABLE FOR ANY 
  118.  DAMAGES, INCLUDING BUT NOT LIMITED TO SYSTEM DAMAGE, SERVICE, REPAIR, 
  119.  CORRECTION, LOSS OF PROFIT, LOST SAVINGS, OR ANY OTHER INCIDENTAL, 
  120.  CONSEQUENTIAL, OR SPECIAL DAMAGES OF ANY NATURE WHATSOEVER RESULTING 
  121.  FROM THE USE OR THE INABILITY TO USE THIS SOFTWARE.
  122.  
  123.  THE DISCLAIMER OF WARRANTY SHALL BE GOVERNED BY THE LAWS OF 
  124.  THE STATE OF CALIFORNIA.
  125.  
  126.  
  127.  
  128.             *** wwVerify Description ***
  129.  
  130.    For those who are new to the BBS world here is a short description 
  131.    of what a call back verifier does. A call back verifier verifies a 
  132.    caller's location by using a modem on the BBS to call out and verify
  133.    what the caller gave as his/her modem telephone number. When the 
  134.    modem that is being verified answers, the caller is asked to enter 
  135.    his/her password. If the password matches the caller's password 
  136.    on the BBS, the caller's security level is upgraded.
  137.    
  138.    wwVerify is a wcCODE call back verifier. It is easy to use and easy for
  139.    new callers to understand.  
  140.    
  141.    Features and abilities:                              
  142.    -----------------------
  143.    * can block ANY numbers that you do not want dialed.
  144.    * can block long distance numbers completely or by time of day.
  145.    * can block certain area codes.
  146.    * can scan database for duplicates telephone numbers against caller's
  147.      record in user database.
  148.    * Sysop is kept informed of call back successes and failures by
  149.      private email. This email can be sent to the Sysop or the person
  150.      in charge of the verification process.
  151.    * security level upgrade is fully configurable.
  152.    * smart modem monitoring - will send a configurable display file to a
  153.      caller who interrupts another person's dial-out verification.
  154.    * many Sysop configurable display files for (RIP and ANSI).
  155.    * direct support for encrypted and non-encrypted passwords.
  156.    * can allow caller to leave voice verification information if call
  157.      back verification is not allowed for his/her modem number.
  158.    * can allow optional 3rd number input for verification.
  159.    * demo version can be fully activated into a registered version
  160.      with a simple voice telephone call.
  161.                    
  162.                    *** FILES ***
  163.    The following files are included on the disk or in the ZIP file
  164.    you downloaded:
  165.     
  166.       readme.txt   <--- information on how to update wwVerify 1.10 to 1.11
  167.        order.txt   <--- information on how to order wwVerify
  168.     wwverify.doc   <--- you are reading it now
  169.     wwverify.wcx   <--- executable program for wwVerify
  170.     wwvercfg.wcx   <--- configuration utility for wwVerify
  171.     wwverify.cty   <--- text file for your cities area code & prefixes
  172.     wwverify.lld   <--- text file for local long distance numbers
  173.     wwverify.cod   <--- text file of area codes you don't want dialed
  174.     wwverify.bad   <--- text file of bad numbers you don't want dialed
  175.     wwbadnum.bbs   <--- bad telephone number display file
  176.     wwdupnum.bbs   <--- duplicate number in user database display file
  177.     wwlogoff.bbs   <--- upgrade security level and log off display file
  178.     wwnolong.bbs   <--- no long distance numbers display file
  179.     wwstayol.bbs   <--- allowed to stay online display file
  180.     wwtempsl.bbs   <--- temporary security level upgrade display file
  181.     wwtimebl.bbs   <--- time block currently active display file
  182.     wwcallbk.bbs   <--- sent to a caller who interrupts a wwVerify callback
  183.     wwverify.hst   <--- history of revisions text file
  184.  
  185.                                 
  186.                    
  187.                    *** Setup ***
  188.  
  189.    The setup of wwVerify is easy. Just follow the documentation's step by
  190.    step instructions.
  191.      
  192.  (1) Copy all files from diskette or downloaded files to your Wildcat!
  193.      home directory. (probably c:\wildcat)
  194.  
  195.      Copy all display files (all files that end in .bbs) to your display
  196.      directory. (probably c:\wildcat\disp)
  197.  
  198. ---------------------------------------------------------------------------
  199.  
  200.  (2) Things you should know and do:
  201.   
  202.   (a) The wwVerify Configuration Utility is going to ask you for 2 or
  203.       3 security levels depending on how you answer the questions.
  204.       The first security level it will ask for is the name of the def-
  205.       ault security level a new caller gets when calling in for the first
  206.       time. The second security level it will ask for is the security
  207.       level that you want to upgrade the caller to after he/she has been
  208.       verified. If you do not verify long distance calls it will ask you
  209.       for a temporary security level to upgrade long distance callers to.
  210.       You do not have to give long distance callers a temporary security 
  211.       level upgrade at all, this is an option. Please make a note of the 
  212.       security levels that you want to use. If you need to create a new 
  213.       one go ahead and do that now. For information on creating and 
  214.       changing security levels refer to you Wildcat! manual.
  215.       
  216.   (b) You will need to decide where you want the email to go that wwVerify
  217.       generates to the Sysop.  You can use your existing private email 
  218.       conference or you could set up a conference just for wwVerify's 
  219.       messages. Which ever way you decide to do this, your default security
  220.       level for newusers (first time callers) must have Read, Write and Join
  221.       access to this conference. See your Wildcat! manual for details on
  222.       setting conference access.
  223.    
  224.   (c) Your default new user security level MUST have the ability to run
  225.       a wcCODE application. Here are the steps you will need to take to
  226.       turn this feature on:
  227.       (1) From your Wildcat home directory type MAKEWILD and press <Enter>.
  228.       (2) Select <Security Profiles> and press <Enter>.
  229.       (3) Select your default new user security level and press <Enter>.
  230.       (4) Press <F5> and toggle almost all the way down to the bottom
  231.       and turn on <Run wcCODE program>.
  232.       (5) Press <F10> 3 times and then exit out of Makewild.
  233.   
  234.   (d) wwVerify uses comment line 5 in the user database to report
  235.       successful and failed callbacks. 
  236.  
  237.   (e) 'Use free form phone numbers:' field in Makewild MUST be set to NO.
  238.  
  239.   (f) Optional 3rd verification number is not scanned against user
  240.       database for duplicates.
  241.  
  242.  
  243.  
  244.  (3) Run Makemenu and add wwvercfg.wcx to your Sysop menu.
  245.  
  246.   (a) From your Wildcat! home directory type: MAKEMENU
  247.  
  248.   (b) Highlight the Sysop menu and press <Enter>.
  249.  
  250.   (c) Toggle down to <End of menu items> and press <insert>
  251.       and the 'Edit Menu Item' dialog box will appear.
  252.   
  253.   (d) Selection Key: for this field select the key that will run the
  254.       Configuration Utility when pressed. For our example we will use 'V'.
  255.       If V is not available or you want to use another key press <F2>
  256.       when the cursor is on the 'Selection Key' field and a box will appear
  257.       showing the available keys.  Available keys are in bright white and
  258.       gray keys are already taken in the current menu.
  259.   
  260.   (e) Description: in this field put a description that will label
  261.       what this selection does. For our example we will use.
  262.       Description: [V] wwVerify Config Utility.
  263.  
  264.   (f) Command type: in this field press <F2> and toggle down to
  265.       'Run wcCODE program' and press <Enter>.
  266.  
  267.   (g) Parameters: in this field press <F2> and then press <tab> and
  268.       highlight file 'wwvercfg.wcx' and press <Enter>, now press 
  269.       <F10> to close dialog box and then exit out of Makewild.
  270.  
  271.   (h) Run wcDraw and add the new menu selection to the Sysop menu 
  272.       display file (probably SYSOP9.BBS) For more information on 
  273.       wcDraw consult your Wildcat! manual.
  274.  
  275. -----------------------------------------------------------------------------
  276.  
  277.   (4) Log on to your BBS and run wwVerify's Configuration Utility.
  278.       If you want to change the configuration of wwVerify again you 
  279.       can run the configuration utility to do so.
  280.  
  281.   Note: There are a couple of different ways that you can use wwVerify
  282.  
  283.   1) When a user logs on to your BBS for the first time you can give
  284.      him/her very limited access. A good example of this is the sample
  285.      "NEWUSER" security level that comes with Wildcat! 4.  Just add
  286.      wwverify.wcx as a menu selection to the main menu of your BBS
  287.      and then modify the display menu to show the new menu choice.
  288.      If you are using the default new user security level called
  289.      "NEWUSER" that comes configured in Wildcat! 4 the display 
  290.      file that you will need to modify is called "MAIN1.BBS".
  291.   
  292.   2) Or you can run wwVerify as a permanent part of the logon process.
  293.      When a new user logs on he/she will be put into wwVerify before
  294.      getting to the main menu. If you choose to run it like this you
  295.      will have to rename the wwverify.wcx file to logon.wcx.
  296.  
  297.  
  298.  (5) Now you will configure the text files that determine the telephone
  299.      numbers that wwVerify can and cannot dial. You can edit the sample
  300.      text files with DOS edit or with your favorite text editor to
  301.      to fit your needs.  Double check your work when setting up the
  302.      configuration files. Wildware! will not be held responsible
  303.      for wrongly dialed telephone numbers.
  304.  
  305.   (a) wwverify.bad - put in this file any telephone number local or
  306.       long distance that you do NOT want wwVerify to dial such as the
  307.       Police Department, Fire Department etc... If a caller inputs
  308.       a number that wwVerify calls 3 different times and does not find
  309.       a modem at that number, wwVerify will automatically add that
  310.       number to this file. Format for this file is one telephone
  311.       number per line with no spaces or dashes '-' allowed in the
  312.       number. See the sample file for an example.
  313.   
  314.   (b) wwverify.cod - put in this file any 3 digit emergency, infor-
  315.       mation numbers etc.. that you don't want dialed such as 911, 411.
  316.       If you are verifying long distance numbers, put any area codes
  317.       in this file that you don't want dialed. For example if you live
  318.       in the United States and don't want to verify numbers in Canada,
  319.       you can block area codes for that country by putting them in this
  320.       file.  Format for this file is one 3 digit number per line. See
  321.       the sample file for an example.
  322.   
  323.   (c) wwverify.cty - put in this file the area code(s) and prefixes of
  324.       local telephone numbers for your city and cities around you that
  325.       there is no charge to dial. In the sample file provided it contains
  326.       the area code and all prefixes that can be verified at no charge
  327.       from Fresno. You can probably find your local numbers in the front
  328.       of your local telephone book. If the numbers are not in your tele-
  329.       phone book call your telephone company for the information. Format
  330.       for this file is one area code and prefix per line with no spaces
  331.       or dashes '-' allowed in the number.  See the sample file for
  332.       an example.
  333.  
  334.   (d) wwverify.lld - If you have 'Verify local long distance numbers'
  335.       turned on in the Configuration Utility put in this file all the
  336.       area code(s) and prefixes of telephone numbers that you want to
  337.       verify that do NOT require an area code to dial. Format for this
  338.       file is one area code and prefix per line with no spaces or 
  339.       dashes '-' allowed.  See the sample file for an example.
  340.       (( ** Local long distance in wwVerify is defined as a long distance
  341.       number that does NOT require an area code to be dialed ** ))
  342.  
  343.    
  344.  (6) Use wcDraw to modify all the display files that come with wwVerify
  345.      to fit your system's needs.  For files preceded by **, you can make
  346.      a corresponding RIP display for it. Example: if you want RIP callers
  347.      to see a RIPed version of the display file 'wwbadnum.bbs' just make
  348.      a RIP file called 'wwbadnum.rip'. For more information on wcDraw see
  349.      your Wildcat! manual. For information on RIP files see your RIPaint
  350.      manual.
  351.  
  352. **(a) wwbadnum.bbs - is shown to the caller when he/she has entered a
  353.       number that was found in the bad numbers file 'wwverify.bad'.
  354.  
  355. **(b) wwdupnum.bbs - is shown to the caller when he/she has entered a
  356.       number that was found in the Wildcat!'s user database and the
  357.       'Scan Database' option is turned on in the Configuration utility.
  358.  
  359. **(c) wwlogoff.bbs - is a informational file displayed to a caller 
  360.       after a successful call back verification has taken place.
  361.  
  362. **(d) wwnolong.bbs - is shown if the caller is calling long distance
  363.       and you have turned 'off' long distance calls backs in the
  364.       Configuration utility.
  365.  
  366. **(e) wwstayol.bbs - is a informational file displayed to a caller
  367.       after a successful call back verification has taken place and
  368.       'Allow caller to stay online after verification' is set to Yes 
  369.       in the Configuration Utility.
  370.   
  371. **(f) wwtempsl.bbs - is a display file shown to the caller if he/she 
  372.       is calling long distance and the Sysop has elected not to verify
  373.       long distance and has chosen to give a temporary security level 
  374.       upgrade.
  375.     
  376. **(g) wwtimebl.bbs - is a display file shown to a caller if the he/she
  377.       is calling long distance during a time that is time blocked.
  378.  
  379.   (h) wwcallbk.bbs - is a display file shown to a caller who interrupts
  380.       wwVerify right before it (dials-out) to do a verification.
  381.       wwVerify has approximately a 17 second delay before it calls back
  382.       a person back who wants to be verified. This delay period is to let
  383.       the modems hang up and reset. Some modems disconnect faster than
  384.       others, so there can be a brief period when the BBS modem has reset
  385.       and the telephone line is clear but the 17 seconds is not up and
  386.       wwVerify can get interrupted by another caller dialing in. If this
  387.       happens wwVerify will answer the phone, send this display file, and
  388.       hangup and start the dial out process over again. wwVerify will 
  389.       continue this process until it can accomplish the call back.
  390.       DO NOT make a RIP version of this file.
  391.  
  392.     
  393.   
  394.  
  395.      ** Thank You ** Thank You ** Thank You ** Thank You ** Thank You **
  396.      
  397.        Wildware! would like to thank the following people and companies:
  398.   
  399.   My Beautiful wife Kelli for proof reading the docs and having her vacation
  400.   delayed so wwVerify could be finished.
  401.   
  402.   Mustang Software, Inc. for creating the best BBS in the world (Wildcat!),
  403.   and a special thanks to the following five people at MSI:
  404.   Jim Harrer
  405.   Rick Heming
  406.   Paul Davis
  407.   Greg Hewgill
  408.   Sam Robertson
  409.   ------------
  410.   
  411.   Rod Jessen   - Beta testing & call back verifier consulting.
  412.   Paul Price   - Call back verifier consulting.
  413.   Chris Valk   - Call back verifier consulting.
  414.   
  415.   And Wildware! would like to thank the author of life 'Jesus Christ' for
  416.   making it ALL possible.
  417.   
  418.   
  419.   Thank you for trying wwVerify, a new Wildware! creation.
  420.  
  421.   If you have questions or comments about wwVerify or any other Wildware!
  422.   software product please call our support BBS at 209-277-3005.
  423.  
  424.  
  425.   
  426.   wwVerify is a trademark of Wildware!
  427.   Wildcat! is a trademark of Mustang Software, Inc.
  428.   RIP/RIPaint are trademarks of TeleGrafix, Inc.
  429.   Specifications subject to change without notice.
  430.   Wildware reserves the right to change this documentation at any time.
  431.   
  432.