home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / BOUNC054.ZIP / !BOUNCER.DOC next >
Text File  |  1993-08-20  |  26KB  |  533 lines

  1.  
  2. PURPOSE of this Program:
  3.  
  4.     o   BOUNCER can force callers to fill out a Legal Form which allows
  5.         the Sysop to make a more reliable decision of who to Allow
  6.         or to Dis-Allow access into certain Areas of the Bbs.
  7.  
  8.     o   To intercept callers before entering Adult Games on your
  9.         Bbs to insure they are of Legal age. The Age limit is
  10.         configurable to accomodate for different State Laws or
  11.         the Sysops personal preference.
  12.  
  13.     o   To intercept and allow only those who have proper access or
  14.         clearance into your CD-ROM areas.
  15.  
  16.     o   Can be used to allow "TRIAL" access into certain areas or 
  17.         games.  After the configured Trial Period has elapsed then 
  18.         access for that caller is immeditaly withdrawn from that area.
  19.  
  20.     o   To help Govern movement into other Restricted areas of a Bbs.
  21.         (The possibiltis of Bouncer is endless)
  22.  
  23.     o   Or can be used as a Validation technique for PRIVATE Bbs's.
  24.  
  25.     o   BOUNCER "Can" be configured to allow Immediate entry once the
  26.         FORM is completed online, but still informs the caller to send
  27.         in the "Signed" form if they wish to maintain that access.
  28.  
  29.  
  30.     o   If FORCED to fill out the Legal Form on-line, they are instructed 
  31.         to prepare to capture their copy.  They are instructed both on 
  32.         screen and again on the form to Read it, Sign it, and attach a 
  33.         photocopy of their Drivers License, then mail it to the address 
  34.         YOU supply.
  35.  
  36.     o   Once the caller is on the Guest List then BOUNCER will be invisible
  37.         to them as it verifies their name. Although Bouncer can also be
  38.         configured to make sure that person has actually SENT in the form 
  39.         (if requested), if not they can be WARNED, or have their Access 
  40.         withdrawn AUTOMATICALLY.
  41.  
  42.         ---------------------------------------------------------
  43.         The manner in which the Sysop chooses to utilize this DOOR is  
  44.         up to each individual Sysop. 
  45.  
  46.  
  47.         This program is fully functional, nothing has been disabled..
  48.         However you and your users WILL encounter a 2 second NAG screen
  49.         every time Bouncer is initialized.  This NAG screen is bypassed
  50.         by your Registration Key.
  51.  
  52. ────────────────────────────────────────────────────────────────────────────
  53.  
  54. Configuration File:
  55.  
  56. 1   Key code               leave 0 if unregistered or program will Error.
  57.  
  58. 2   Your Bbs name.         Address line #1        See Example
  59. 3   Sysop Name.            Address Line #2        on Form
  60. 4   Sysop Address, Street  Address line #3        Below
  61. 5   City, State, ZIPcode   Address line #4
  62.                            The above Address (yours) is the address the
  63.                            caller will be informed to send the completed
  64.                            and signed FORM to. This can be your home
  65.                            address or a P.O. Box, doesnt matter.
  66.  
  67. 6   Locked Port?           Y or N if you are using LOCKED ports
  68.  
  69. 7   Fossil ?               Y or N if you are using a Fossil Driver
  70.  
  71. 8   Path\ to DOOR.SYS      Path only\   A "SAMPLE DOOR.SYS" IS SUPPLIED
  72.                            so that you may "TesT" BOUNCER to see what it
  73.                            actually does.  The only difference between This
  74.                            Door.Sys and a Normal one is that the first entry
  75.                            (which is the Comport number) has been set to "0".
  76.                            This will force "Local-mode" for Bouncer..
  77.  
  78. 9   NoBounce.Lst           Your GUEST LIST of callers.
  79.                            This list can either be updated by you OR by the
  80.                            Door depending on how you set it up.
  81.                            The Format for the names on this list as follows:
  82.                            "CallernamePassword/DATE" on each line.
  83.  
  84.                            EXAMPLE:
  85.                            "Grant Bell" with a PW of "Clara" who was processed
  86.                             by BOUNCER on  01-01-1993 would be -
  87.                            "Grant BellClara/01-01-1993" 
  88.                         
  89.  
  90.                      *     Deleting the /DATE from their Name+Password will
  91.                            signify they are VERIFIED and have either sent
  92.                            in the requested FORM or met your criteria for
  93.                            permanant entrance past the Bouncer. BE SURE to
  94.                            delete the entire sequence of "/DATE" leaving only
  95.                            their CallernamePassword on the line..
  96.                     
  97.                            EXAMPLE:
  98.                            "Grant BellClara/01-01-1993" to qualify as being 
  99.                             Verified would be "Grant BellClara"    
  100.                             Notice the "/01-01-1993" has been removed...
  101.  
  102.        
  103. LIST OF NAMES WHO TO ALLOW
  104. PAST BOUNCER, Example of 
  105. FileNames you can use:
  106.  
  107.  (  Private.Lst  )   *     You may Specify any filename you wish to use for
  108.  (  CD-ROM.Lst   )         the ALLOW ON list, the "NoBounce.Lst" filename is
  109.  (  You-Name.It  )         supplied as a beginning point. Allowing YOU to input
  110.  (  Adult.Lst    )         the Filename Should allow you to use BOUNCER for
  111.                            multiple purposes. To keep a seperate list for
  112.                            different games or situations.
  113.  
  114.                      *     A File called "USER.OK" is created whenever the
  115.                            callers name is found on the Guest list OR has just
  116.                            been added to the list.
  117.                            The existence of this file can help you determine
  118.                            whether or not to allow the Caller to play the
  119.                            game in question.
  120.  
  121.  
  122. 10  AGE                    Lowest AGE to allow through the DOOR.
  123.                            If you are using BOUNCER to help intercept the
  124.                            kiddies then it is up to YOU to set this age limit
  125.                            to whatever you feel is necessary. Even if the LEGAL
  126.                            age is 18 you may not want anyone under 21 into
  127.                            "Certain"  Adult Doors.  You may be unscathed by
  128.                            local laws or the intended use has nothing to do
  129.                            with AGE then set this to 0 or 1 or whatever.
  130.                            Its your Bbs, you handle it your own way!
  131.  
  132. 11  Access Now?            if set to Y,  will allow IMMEDIATE access AFTER
  133.                            filling out the Legal Form or Questionaire online.
  134.                            If this Option is used then the callers Name+Pw/DATE
  135.                            is automatically added to the Guest list above. It is
  136.                            up to you the Sysop to Monitor this list accordingly.
  137.  
  138.  
  139.                            [-SEE Settings 15 and 16 below!-]
  140.  
  141.  
  142.                            A File called "USER.OK" is created whenever the
  143.                            callers name is found on the Guest list OR has just
  144.                            been added to the list.
  145.  
  146.                            This file will only exist IF the caller is either
  147.                            ALREADY on the Guestlist OR you have granted access
  148.                            once the form is completed.
  149.                            (See also  #14 below)
  150.  
  151.  
  152. 12  LPT1 / NP              Where to send YOUR copy of the FORM. If Printer is
  153.                            selected then a copy will be printed at same time as
  154.                            the caller CAPTURES their copy, a copy will also be
  155.                            saved to disk irregardless of this setting. If you
  156.                            do not want a copy to go to printer then put NP.
  157.                            If printer is selected but Printer is not turned on
  158.                            then only a copy to disk is made. This copy is saved
  159.                            using the callers Log on Name into the Bouncer Dir.
  160.  
  161.                            NP for No Printer .
  162.  
  163. 13  Y                      If Printer is selected, Send a FormFeed first?
  164.                            Y or N.....  Makes for Neater Personal Copies..
  165.  
  166. 14  Y                      If (Y)es then a file called FORMDONE.OK will be
  167.                            created IF the entire FORM was completed, the
  168.                            existence of this file can help you determine
  169.                            whether or not to allow Auto-Validation.
  170.  
  171.                            The absence of this file would indicate the caller
  172.                            Opted NOT to fill out the FORM. In this case your
  173.                            Auto-Validation Batchfile can be bypassed.
  174.                            (See also #11 above)
  175.  
  176.                            For an Example please see PRIVATE-BBS below.
  177.                            Y or N
  178.  
  179. 15   10                    If set to anything besides a Zero (0) then the caller
  180.                            will be sent a message after THAT many days has
  181.                            passed since they were first entered into the Guest
  182.                            List.
  183.                            IE: if you set this to 10 then on AND after the 10th
  184.                            day, Each time your caller enters the area through
  185.                            Bouncer, they will be presented with whatever message
  186.                            is in the file called FIRSTMSG.TXT. But ONLY if you
  187.                            have NOT deleted the /DATE from their NamePassword
  188.                            on the Guest List!
  189.  
  190.                            You can also use this to send a "Enjoy your Trial
  191.                            Period" message from day 1 by setting this to 1 ..
  192.  
  193.                            If you should decide to make your OWN, or Edit the
  194.                            current FIRSTMSG.TXT, then it cannot be wider than
  195.                            55 columns or longer than 19 lines.
  196.                            The Color is permanantly SET to RED on WHITE.
  197.  
  198.                            Remember though, this is dependant upon reading
  199.                            the callers /DATE from within the Guest List.
  200.                            If you have deleted the /DATE then this function
  201.                            will not work for that Caller.
  202.  
  203.  
  204.                            A COPY of the FORM has been provided "in case"
  205.                            the Caller misplaces it and NEEDS to download
  206.                            another copy.   :-)
  207.  
  208.  
  209. 16   20                    This acts the same as the above #15 does, except
  210.                            this tells Bouncer when to send a FINAL message
  211.                            and to STOP access on the DAY in this setting.
  212.                            If set to 20, then on the 20th day (and after)
  213.                            access into the intended area is withdrawn and a
  214.                            Final Message is sent. The contents of that message
  215.                            is in the file called LASTMSG.TXT.
  216.                            The callers name is NOT  deleted from the list, so
  217.                            Each time they try to access the intended area they
  218.                            will recieve the message within LASTMSG.TXT.
  219.  
  220.  
  221.                            This message can tell them their access is denied
  222.                            because they failed to send in the FORM,
  223.                            or the message can tell them their "TRIAL PERIOD"
  224.                            has ended.  (Whatever)
  225.  
  226.                            If you should decide to make your OWN, or Edit the
  227.                            LASTMSG.TXT then (as above) it cannot be wider than
  228.                            55 columns or longer than 19 lines.
  229.                            The Color is permanantly SET to RED on WHITE.
  230.  
  231.  
  232.                            Remember though, this is dependant upon reading
  233.                            the callers /DATE from within the Guest List.
  234.                            If you have deleted the /DATE then this function
  235.                            will not work for that Caller.
  236.  
  237.  
  238. 17   Y                     Tell Bouncer whether or not you want to send the
  239.                            caller a copy of the Legal Form via "CAPTURE" ?
  240.                            Turn this off if your NOT forcing the caller to fill
  241.                            out or send in the FORM, Or if your using this for
  242.                            OTHER reasons besides an Adult Door / Private Bbs
  243.                            Monitor.
  244.  
  245.  
  246.  
  247. 18   Y                     If toggled No then Questions 8 thru 12 will not be
  248.                            asked.
  249.                            Questions 8 thru 12 are:
  250.  
  251.                             8.  Any Affiliation?  :  (with law enforcment or
  252.                                                       Software companys)
  253.                             9.  Purpose for Access:
  254.                            10.  Current Employer  :
  255.                            11.  Your Department   :
  256.                            12.  Work Phone Number :
  257.  
  258.                            Toggle this to No if you do not require these answers.
  259.  
  260.  
  261.  
  262. 19   999 255 90            Security Levels to allow thru "No Questions Asked".
  263.                            Allows you to enter as many security levels you
  264.                            wish to allow to PASS Bouncer without ANY questions
  265.                            asked.  Bouncer will bypass the Guest list for
  266.                            any security level on this list. The Callers name
  267.                            will not be searched for NOR will it be added to
  268.                            the list.
  269.                            The Security Levels MUST be separated by a Space " ".
  270.  
  271.  
  272.  0                         Specifies which interrupt to use with this port.
  273.                            If the value of IRQ% is ZERO (0), then the default
  274.                            IRQ values are used (COM1 & COM3 use IRQ4, COM2 &
  275.                            COM4 use IRQ3).  This is what most applications will
  276.                            use. Specify an IRQ value of 1 through 15 when you
  277.                            want to use an IRQ value other than the default.
  278.                            Such as when you want to use IRQ15 with COM3.
  279.                            NOTE: Be careful when choosing an IRQ value other
  280.                            than the default. Most machines use some of the other
  281.                            IRQ inputs for other machine functions such as the
  282.                            Hard drive and system clock. The ComPort Routines
  283.                            found in Bouncer DOES NOT chain the interrupt, it
  284.                            takes it over entirely. If you choose an IRQ that
  285.                            is used for something already, your machine will most
  286.                            certainly operate improperly.
  287.  
  288.                  FOSSIL:   No IRQ value is necessary in FOSSIL mode since all
  289.                            communications tasks are handled outside of the
  290.                            ComPort routines found in Bouncer.
  291.  
  292.  
  293. ────────────────────────────────────────────────────────────────────────────
  294. EXAMPLE FORM:
  295.  
  296.  
  297.           Below is a copy of the FORM your caller will recieve VIA
  298.           their Capture.   (If "Send Form" is Selected)
  299.  
  300.  ───────────────────────────────────────────────────────────────────────────
  301.                  V.o.i.c.e. Bbs  Adult Area Application Form
  302.  ───────────────────────────────────────────────────────────────────────────
  303.  
  304.    Name-------->:  GRANT BELL
  305.    Address----->:  17508 DINGLE RD.
  306.    CityStateZip>:  DETROIT., MI, 48240
  307.    Age--------->:  45
  308.    Birthdate--->:  01/25/48
  309.    Homephone--->:  (313)555-2121
  310.    Modemphone-->:  (313)532-8410
  311.    Affiliates-->:  NO AFFILIATIONS
  312.    Purpose----->:  TO ACCESS ADULT GAMES
  313.    Employer---->:  SELF EMPLOYED
  314.    Department-->:  N/A
  315.    Workphone--->:  (313)532-8410
  316.    AcceptCall-->:  Yes, I Will Accept Collect Call
  317.  
  318.     I, GRANT BELL Swear that I am over 18 years of age.
  319.  
  320.     I, GRANT BELL am requesting access to Restricted sections on
  321.    V.o.i.c.e. Bbs.  I fully realize that some files or areas may be
  322.    offensive to some and that the Adult area may contain sexually explicit
  323.    materials.
  324.    
  325.     I will not hold the Sysop of V.o.i.c.e. Bbs responsible for any of the
  326.    materials contained on V.o.i.c.e. Bbs.  I also agree that I will
  327.    not share or distribute any of the files obtained from V.o.i.c.e. Bbs
  328.    that are of ADULT theme to Minors.
  329.  
  330.     I, GRANT BELL, swear that all the information contained in this form is
  331.    true and correct.  If any misinformation has been included on this form
  332.    than I will be considered to be Criminally Trespassing this Computer
  333.    System and guilty of committing Fraud.  Failure to devulge information
  334.    pertaining to legal affiliates will be construed as entrapment if any
  335.    legal action is taken against the system administrator at any time!
  336.  
  337.  
  338.  
  339.                    ────────────────────────────────────────
  340.                                Signature
  341.  
  342.  
  343.    ****** A PHOTOCOPY OF YOUR DRIVERS  LICENSE MUST ACCOMPANY THIS FORM *****
  344.     
  345.  
  346.    ╒════════════════════════════════════════════════════════════════════════╕
  347.    │ IF you are,  or have Ever worked for ANY Law Enforcement Agency or ANY │
  348.    │ Regulatory Commission of any sort, then you MUST Indicate that on this │
  349.    │ Form, explaining what Company or Agency,  and what your purpose for    │
  350.    │ calling this Bbs System is, OR, if you Report to ANY Regulatory or Law │
  351.    │ Agency or, Work for, or Report to any Software or Publishing Companies.│
  352.    ╘════════════════════════════════════════════════════════════════════════╛
  353.            Use a seperate Sheet if you must to list your Affiliates,
  354.            As described in the above -Box- ..
  355.  
  356.  
  357. ────────────────────────────────────────────────────────────────────────────
  358. EXAMPLE of ADDRESS:     (If "Send Form" is Selected)
  359.  
  360.    Following is an example of what the Mail To: address (lines 1 2 3 4 in
  361.    the Config file above) looks like.     This is sent VIA Capture also..
  362.  
  363.  
  364. ─────────────────────────────────────────────────────────────────────────────
  365. NOW SAVE THIS CAPTURE!   I realize that was a Little fast, but: 
  366.  
  367. After you Log off, READ the Form carefully, Sign it, staple a Photocopy
  368. of your Drivers License to it,  and Mail it to the Following Address:
  369.  
  370.  
  371.                V.o.i.c.e. Bbs
  372.         C/o    Jim Samples
  373.                17508 Inkster Rd.
  374.                Redford Twp., Mi.  48240
  375. ────────────────────────────────────────────────────────────────────────────
  376. ────────────────────────────────────────────────────────────────────────────
  377.    
  378. SET-UP:
  379.  
  380.  
  381.  
  382.       Either put Bouncer in a common Path or in the Door Directory
  383.       your working in. or in its own Directory. I personally Recommend
  384.       giving Bouncer it's OWN Directory.  The Examples below will reflect
  385.       this recommendation.
  386.  
  387.  
  388.       >USER.OK filename created
  389.  
  390.       As indicate above, once a Callers Name is found to be on the
  391.       Guest List, a file is created called "USER.OK",  to show that
  392.       the current Caller is ON the List. Their name is added to the
  393.       LIST either by YOU manually or if you set line #11 (above) to
  394.       Allow them automatic access after filling out the FORM or first
  395.       7 questions.
  396.  
  397.       We use that filename to determine whether or not to continue,
  398.       Like so:
  399.  
  400.       Suppose we have an Adult Game called "Sexorama.Exe",
  401.       to use Bouncer we:       (In Spitfire)
  402.  
  403.  
  404. :Door_S
  405.   Cd C:\Sf\Bouncer
  406.   Bouncer Bouncer.Cfg
  407.   if NOT exist User.Ok goto NoAllow
  408.  
  409.   Cd C:\Sf\Adultdoor
  410.   Sexorama
  411.       
  412. :NoAllow
  413.   <return to bbs>
  414. Goto Loop
  415.  
  416. :Door_T
  417.  
  418.  
  419.             * When "Calling" Bouncer you must specify the Config filename
  420.             * you will be using.  You can have Multiple Config files and
  421.             * therefore use Bouncer with a different setting for Each
  422.               situation.
  423.  
  424.  
  425.       In the Above Example Batch:
  426.  
  427.       If the USER.OK file does NOT exist then the caller is returned
  428.       to the Bbs because the Game SexoRama is Bypassed.  There is No
  429.       need to delete the file USER.OK after creating it because Bouncer
  430.       deletes it automatically as soon as Bouncer is initialized, this
  431.       is done to insure others are not accidently allowed through..
  432.  
  433.  
  434. REMEMBER!
  435.         Bouncer can be Set Up on EVERY ADULT door you have online. Once
  436.         your caller has been added to the Guest List Bouncer will see
  437.         their Name and they WONT have to fill out the FORM again.
  438.         Just call Bouncer for Each Door, if the caller has Already
  439.         been approved or is on the Guest List then Bouncer will allow
  440.         them to PASS .
  441.  
  442.  
  443.  
  444. DONT FORGET:
  445.  
  446.         You can have as many seperate Guest Lists as you want too!
  447.         Bouncer can be used for MANY situations just by using a different
  448.         Config file with different settings and a different name, such as
  449.         CD-ROM.CFG.
  450.  
  451.  
  452.  
  453.         Call it with :
  454.                         BOUNCER CD-ROM.CFG
  455.  
  456.  
  457.  
  458.  
  459. ────────────────────────────────────────────────────────────────────────────
  460. PRIVATE BBS:
  461.  
  462.        >FORMDONE.OK filename created
  463.  
  464.         This same technique can also be used in conjunction with your
  465.         auto-validator if you are running a Private Bbs or even if your
  466.         Not. I have allowed for another file to be created for use with
  467.         a Validator or whatever other ways you can find to use it. That
  468.         file is called "FormDone.Ok" and it means just what the name implies,
  469.         the FORM has been filled out COMPLETELY although unlike the
  470.         User.Ok this Callers name Was Not added to the GUEST List (unless
  471.         you told it to do so in line #11!.  They Only Filled out the form,
  472.         this gives you the opportunity to offer a self validation program
  473.         to the caller.  How you decide to handle it after that is totally
  474.         up to you.
  475.  
  476.  
  477.  
  478.   Cd C:\Sf\Bouncer
  479.   Bouncer Bouncer.Val
  480.   if NOT exist FormDone.Ok  goto  NoAllow
  481.  
  482.   Cd C:\Validator
  483.   Validate.Exe
  484.       
  485. :NoAllow
  486.   <return to bbs>
  487.  
  488.  
  489.         If the "FormDone.Ok" file was not created then the person DID NOT
  490.         fill out the Form,   so you probably wouldnt want to waste the
  491.         call on that person..
  492.  
  493.         And as is the case with the USER.OK file, there is no need for
  494.         you to Delete it as BOUNCER checks for and Deletes it automatically
  495.         upon initialization.
  496.  
  497. ────────────────────────────────────────────────────────────────────────────
  498.  
  499. ╔═══════════════════════════════════════════════════════════════════════════╗
  500. ║ LIMITED WARRANTY/DISCLAMER                                                ║
  501. ║ --------------------------                                                ║
  502. ║                                                                           ║
  503. ║     This software package is warranted to perform in substantial          ║
  504. ║ accordance with the description outlined in this document, when operated  ║
  505. ║ on an IBM Personal Computer or close compatible system running under DOS  ║
  506. ║ Version 3.3 or greater.  No guarantee is provided that this program will  ║
  507. ║ operate as intended or expected by the user under all circumstances,      ║
  508. ║ combinations of hardware, or operating environments.  No warranty,        ║
  509. ║ expressed or implied, of merchantability or fitness for a particular      ║
  510. ║ purpose is provided.  This program is provided "AS IS" and user assumes   ║
  511. ║ all risks as to the quality or suitability of this program for whatever   ║
  512. ║ purposes contemplated.                                                    ║
  513. ║                                                                           ║
  514. ║ No Guarantee is given to the LEGAL wording included within the "FORM"     ║
  515. ║ or within the "TEXT" of the "FORM" nor anywhere else within this Program. ║
  516. ║ If you have ANY doubts to the "Legality" of this program or to the        ║
  517. ║ wording used then it is UP TO YOU to seek Legal Counsel regarding same.   ║
  518. ║ Poor grammar, Typos or missing words have NO bearing.                     ║
  519. ║                                                                           ║
  520. ║ IN NO EVENT WILL JAMES M. SAMPLES BE LIABLE TO YOU FOR ANY DAMAGES,       ║
  521. ║ WHETHER INCIDENTAL OR CONSEQUENTIAL, INCLUDING ANY LOST SAVINGS, LOST     ║
  522. ║ PROFITS, LOST DATA, OR ANY OTHER DAMAGES ARISING FROM THE USE OR          ║
  523. ║ INABILITY TO USE THIS PROGRAM.                                            ║
  524. ║                                                                           ║
  525. ║ James M. Samples offers support and assistance to registered users only.  ║
  526. ║                                                                           ║
  527. ║ USE OF THIS PROGRAM CONSTITUTES USER AGREEMENT TO THE ABOVE TERMS.        ║
  528. ║                                                                           ║
  529. ║ If you have ANY doubts about this program then you are herby strongly     ║
  530. ║ advised to NOT use it.                                                    ║
  531. ║                                                                           ║
  532. ╚═══════════════════════════════════════════════════════════════════════════╝
  533.