ftp.wwiv.com

home *** CD-ROM | disk | FTP | other *** search

/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / CSV256.ZIP / CSVERIFY.DOC < prev next >

Wrap

Text File | 1993-08-09 | 20KB | 566 lines

(*****************************************************) (* CSVerify Written by Gary Bouchard *) (* SysOp - The Computer Store BBS *) (* St. Augustine, Florida (904)794-0063 *) (* Copyright(c) 1993....All Rights Reserved *) (* Released Modified *) (*****************************************************) Installation of CSVerify BBS SETUP 1. Create a directory to keep the CSVerify files in, we will use \DOORS\CSVERIFY in this documentation. Copy all the files from CSVERxxx.ZIP into the directory you have chosen. 2. Use PCBoards PCBSETUP program to add CSVERIFY to your DOORS.LST file. You can add to or modify this file from the "Main Board Configuration" option on the menu. IMPORTANT: In the column marked USER.SYS enter the following: For PCBoard version 14.x, enter O (uppercase ohh) :) For PCBOard version 15.x, enter Y USERS.SYS is used by the program to write information back to the users record after they are verified. If you want new users to be automatically forced into the program when they log on to the BBS, enter a Y in the LOGIN column and set the SEC level for the level you have assigned to new users. Sample Screen From PCBSETUP - EDIT Doors File USER DOOR Filename Password Sec Login SYS SYS Shell Path to DOOR files ======== ======== === ===== === === ===== =================== CALLBACK 5 Y Y N N c:\doors\csverify\ Exit PCBsetup, saving your changes. 3. Now create a batch file to start CSVERIFY. Below are two samples, one for a single node, and the other for a multi-node setup, using PCBoards %PCBNODE% variable. If you wish to have the ability to call up the program using either a DOOR number or name, call the batch file something you can relate the operation of the program to, such as CALLBACK. Do not put an extension on the batch file name. For example, if you use CALLBACK as the batch file name, and also as the "filename" entry in DOORS.LST and have the program set as DOOR 2, users could access the program by entering OPEN 2, DOOR 2, or CALLBACK. ** Single Node BBS ** ** Multi-node BBS ** (Paid Registration Only) @Echo Of @Echo Off C: F: CD \DOORS\CSVERIFY CD \DOORS\CSVERIFY CSVERIFY CSVERIFY.CNF CSVERIFY CSVERIFY.CNF CD \PCB CD \PCB%PCBNODE% BOARD BOARD * For multi-node BBS's, there is no need to create a separate configuration file for each node if you follow the instructions above. * The Freeware version of CSverify will only operate on 1 node. You must specify which node will be used in the config file, by setting the variable PCBNODE=# where #=the number number to run on. * To obtain a Multi-Node version of CSV see ORDER.CSV in the ZIP file. ----------------------------------------------------------------- CSVERIFY SETUP 1. Modify the CSVERIFY.CNF file for your configuration. Each line of the configuration line is shown below, followed by a description of what each line means. SYSOP_NAME=Gary Bouchard Sysop's Name - Self Explanatory REGISTRATION=1234567890 The number you get from The Computer Store BBS to make your program registered. See ORDER.CSV for registration information. DIALSTRING=ATE0M1DT Init string to send to the modem during redial. LD_ACCESS=10288-1 * Long distance dialing prefix or access number (8 * characters max). Note: Include the 1 after the dash. * Example: LD_ACCESS=1 (to just dial 1 before the number) * or: LD_ACCESS=10288-1 (for AT&T access). SUFFIX=1234567890 Suffix tacked onto the end of the of a phone dialing string for users that need to enter an account number on KSU systems. If your phone system requires you to key in an account number after you dial a phone number (for billing/accounting purposes), enter that number here. If you do not need this feature, leave this field blank. ALLOW_LD=YES * To allow NO long distance verifications: * In the file AREACODE.CSV, enter only your area code. * In the file EXCHANGE.CSV, enter only local exchanges. * To ALLOW verification of ALL long distance callers: * Make ALLOW_LD=YES * To ALLOW restricted verification of long distance * callers by areacode: * Make ALLOW_LD=NO * List area codes you will verify from in AREACODE.CSV. LOGOFF=YES If you allow long distance calls, entering YES will configure the program to verify the number, then once the user is upgraded, tells the user that he/she is now verified, and tells them to call back for access. The program will then drop carrier and recycle. Answering NO allows the user to continue on the BBS AFTER the verification is successful. If you have ALLOW_LD set to YES, this means the long distance users will remain logged on to your BBS at YOUR expense. METERED=NO METERED is a Yes/No answer. If BBS line is charged by a metered rate, placing METERED=YES in line 5 will have the BBS disconnect after verification of the user, and display the file identified in line 21 (HANGUPFILE). REDIALS=3 Maximum number of redial attempts to make. DIAL_TIMEOUT=60 Redial timeout in seconds (how long to wait for an answer). ADDTIME=10 Additional time in minutes to give to a successful callback. VERIFIED_LEVEL=60 Security level given to verified callers, after the callback verification is successfully completed. EXPIRED_LEVEL=30 Expired Security Level given to caller. NOTE: PCBoard Defaults this to 0 . LONG_DISTANCE_LEVEL=80 Security level given to Long distance verified callers. If you want long distance callers to have the same security level as local callers, then set this to the same value as VERIFIED_LEVEL. WELCOME=c:\doors\csverify\welcome.csv Path & name of welcome file that will be displayed to the user when they enter the program. INSTRUCT=c:\doors\csverify\instruct.csv Path & name of instructions file for caller. TRASHFILE=c:\doors\csverify\trashno.csv Path & name of the trash numbers file. Enter your BBS number in this file. Each user that verifies with the CSVERIFY program will be added to this list. This keeps users from verifying multiple times with the same phone number. EXCHANGEFILE=c:\doors\csverify\exchange.csv Path & name of valid local exchanges list AREACODEFILE=c:\doors\csverify\areacode.csv Path & name of valid local area codes list. LONGDISTANCE=c:\doors\csverify\longdist.csv Path & name of long distance file displayed to caller HANGUPFILE=c:\csverify\hangup.csv Path & name of file displayed to user instructing them to call back if long distance or metered line. (HangupFile) ADD_COMMENT=YES If YES, Comment #2 in the users record is updated with the phone number used to verify him/her. The text "XXX XXX-XXXX was/not verified." is inserted. In this way you can tell which users in your users file have been verified by this program. If NO, then NO information will be written to this field. CHANGE_BDPHONE=No If YES, the B/D Phone Number in the users record is optionally replaced with the telephone number the user entered into the program to be verified. This phone number is formatted to PCBoard specs. If NO, then no change will be made to this field. PBX=9, PBX access number if any. If you have to dial 9 as an example to get an outside line. a comma represents a pause to the modem for the outside line to switch. If nothing is required, just make the line blank after the equals sign. MIN_SECURITY=PCBSECURITY Security level needed for caller to use door. This is the minimum security level the user must have to enter the program. If you want to use the default value set in the BBS software, then type PCBSECURITY. Example; MIN_SECURITY=60 or: MIN_SECURITY=PCBSECURITY EXPIRATION_DAYS=1 EXPIRATION_DAYS value on successful verification of a user. Enter the number of days to give the user from the date of verification. Leaving this option blank defaults it to 365 days or 1 year. Example: Setting this option to 730 would set the users expiration date for two years from the date they successfully verified. LD_EXPIRATION=1 LD_EXPIRATION=## is a variable that allows you to set the expiration date of long distance callers to a shorter time period than local or regular users. This works the same way that EXPIRATION_DAYS works. INTERNATIONAL=NO INTERNATIONAL Allows Callbacks to take place using the International Phone numbers. Place a NO there if you do not use International numbers. TIMETABLE_FILE=C:\DOORS\CSVERIFY\TIMETAB.CSV This is the path and name of your file that you will use for your timetable. I seriously recommend that you follow my format in the file or it may not work. CALLTIME_FILE=C:\DOORS\CSVERIFY\CALLTIME.CSV CALLTIME_FILE is the path and name of a display file to tell the caller that he cannot be called back at this time because the timetable does not allow long distance callbacks in this time slot. DISPLAY_NAME=YES Some SysOps are worried about giving out phone numbers of there users. When CSV finds a number in the TRASHNO.CSV file that has been used, the program will display the Number, Name, and Date & Time of the caller that used this number. If you do not wish to have that information revealed to a caller when his number is rejected, you may set this variable to DISPLAY_NAME=NO, and the program will only show the Phone number entered as being used previously. PCBNODE=1 This variable allows the SysOp to define what node the program will be run from, rather than hardcoding node 1 into the program. If this variable is not found in the config file, the program will default to node 1. ---------------------------------------------------------------- 2. Make the necessary changes to the following files: AREACODE.CSV This is a list of valid area codes that the program will call back to verify. * If you have ALLOW_LD set to YES, the program will NOT check * this file. It will allow all area codes to be verified. * If you have ALLOW_LD set to NO, then ANY area code in this * file will be accepted as an allowable area code to verify. Example: 904 EXCHANGE.CSV CSVERIFY will ask the user if the number is long distance if the area code does not match the entry in AREACODE.CSV or the exchange entered does not match what you specify in this exchange file. example; 692 ; Sample Exchange listing. 823 ; these are all local numbers in my calling area 824 ; Anything after column 4 is ignored, so you can 825 ; make comments on each line if you like. 826 TRASHNO.CSV This is a trashcan type of file. You can add numbers to this list that you want rejected should they be entered by a user. Each time a user is successfully verified, the phone number used by the caller is added to this list. The TRASHNO.CSV file MUST have at least one phone number in it before you use it, namely your BBS number, or the program will not operate properly. Example: 907 555-1212 TIMETAB.CSV This file can be modified for your needs, or left at the default settings. ----------------------------------------------------------------- 3. Make changes to the following files if you wish to customize them for your BBS. The text files included are used by my board, and can be modified to your liking. They have the capability, as you will see, to expand the standard PCBoard @xxxx@ macros, and color macros. CALLTIME.CSV This file will display to users if: You have ALLOW_LD=YES and have defined allowable times in the TIMETAB.CSV file. HANGUP.CSV This file is displayed to users: If you allow long distance callbacks, and have LOGOFF=YES. If you have METERED=YES. INSTRUCT.CSV Instructions to the user on how to complete the callback verification. LONGDIST.CSV Displays to user if you have ALLOW_LD=NO. WELCOME.CSV This is the opening screen shown to all users when they enter the program. ----------------------------------------------------------------- MISCELLANEOUS NOTES CALLER LOG Activities performed by the program are logged into your PCBoard Callers log. If you have multiple nodes, the program will make the entry into the proper caller# log. INTERNATIONAL SUPPORT The program will support the 13 digit international phone number now. To activate this feature, just add the keyword "INTERNATIONAL" to line 23 of the configuration file, and it will accept the long dialing string. What is not available here is support for local exchange/area code verification. If the caller enters a number that cannot be broken up into Country Code, City Code, and number, CSV will automatically prompt the user to reenter the number. CALLBACK ONLY FEATURE (REGISTERED VERSION ONLY) CSVerify has the ability to perform CALLBACK only type calls. Once a user has registered, and been successfully verified, you can set the program up to just disconnect the caller, and have CSV call the user back. Once connected, the user is returned to PCBoard. In order to accomplish this task, you must in some way send an environment variable to CSV. CSV looks for the environment variable "PCBDOOR" when it is executed. If PCBDOOR is set to "CB" that the program will do a CALLBACK only, rather than a registration verification. You can do this one of two ways, and I'll give you a couple of examples here; 1. From the PCBoard menu, I have the letters "CSV" which open the callback door. If I type CSV<space>CB, then when CSV executes, it is in callback only mode. If I type CSV by itself, then the program is in registration/verification mode. Typing the "CB" after the CSV command places the "CB" into the environment variable PCBDOOR, and CSV will pick it up. 2. You can create a separate batch file for PCB to execute for callbacks which would contain a line like "SET PCBDOOR=CB". You would then call the CSV program as documented. At the end of the batch file you place the command "SET PCBDOOR=" which would clear the environment variable for you when it was finished. OTHER STUFF! Reverifications - If you have the users expiration security level equal to that of a New user, CSV will allow reverification of the phone number without checking the trashfile. Once the user is reverified, the program will reset the expiration date ahead x number of days as you specified. Let me know if you need something else added to the program or datafile. I use the History file as an addendum to the documentation, and there is a lot of information contained in the file, so please pay attention to what is in there, ok? -= Legal Stuff =- This is a Copyrighted(c) program. It cannot be altered, disassembled, de- compiled, or hacked without my expressed written consent. I maintain the rights to the source code, and will support the program as long as there is an interest in it. I cannot be responsible for any damage that may result from the use of this program. Though the program appears to be "BUG FREE" there maybe something that I did not catch.. As Sam Smith say's -> "You've Been Warned!". This ZIP file was assembled using the Authenticity Checking Capabilities of PKZIP(tm) with a label of; "The Computer Store BBS -> 904-794-0063". If Authenticity verification was not present when you unzipped this file, or the Authenticity check does not show the above, then DO NOT use it, as it has been altered, and may not be safe to use. This software is FREE to my fellow SysOps who operate 1 node, non-commerical BBS systems. If you desire a Multi-Node version, or wish to use this software in a commerical application, please refer to the ORDER.CSV form included in this ZIP file. To obtain your FREE single node registration key, contact my BBS, and in a <C>omment to the SysOp, please leave your name, and the EXACT NAME of your BBS as defined in PCBoard.DAT. In reply to your message, I will attach a key for you to download. -= Credits =- This program was written using Clark Developments PCBoard Toolkit, and supports the PCBoard @xx@ macros in its display files. This allows for tremendous customization. As a side benefit, the program also inherits the security features, and integrity that PCBoard offers, along with Multi-National support, and fully supports the use of Fossil Communications drivers. -= Technical =- The system used to write the program is a IBM PS/2 model 57 486 with 160meg of Disk, and 12megs of RAM, MS-DOS ver 6.0, and 4DOS ver 4.2 and DoubleSpace without any problems. The system is attached to a Token Ring Novell 3.11 server. The program was tested using PCBoard(tm) ver 15.0/10 on a single node system. -= Notes =- I am a member of the SmartNet(tm) NetMail Network, and can be reached thru just about any of the conferences available. My BBS # is on the top of page #1, and is a free open access system upon registration. I request that any questions or problems you encounter with this program be directed to me on my BBS or thru the Net/Mail network. I can also be reached through RoseNet.