home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / scid201.zip / sentry.doc < prev    next >
Text File  |  1997-01-01  |  60KB  |  1,440 lines
  1.  
  2.  
  3.  
  4.  
  5.   ▄█████▄ ▄██████ ▄█████▄ ███████ ██████▄ ██   ██     ▄█████▄ ▐██▌ ██████▄ ██
  6.   ██▄▄▄▄  ██▄▄▄▄  ██   ██   ▐█▌   ██   ██ ██▄ ▄██ ▄▄▄ ██       ██  ██   ██ ██
  7.    ▀▀▀▀██ ██▀▀▀▀  ██   ██   ▐█▌   ██████   ▀███▀  ▀▀▀ ██       ██  ██   ██ ▀▀
  8.   ▀█████▀ ▀██████ ██   ██   ▐█▌   ██  ▀██   ▐█▌       ▀█████▀ ▐██▌ ██████▀ ██
  9.  
  10.  
  11.                B B S     C A L L E R - I D     I N T E R F A C E
  12.  
  13.                                  VERSION 2.01
  14.  
  15.  
  16.  
  17.                   Copyright (c) 1996, 1997 by Jason Hendriks
  18.  
  19.                               ALL RIGHTS RESERVED
  20.  
  21.                        "Power Software for Lazy People"
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.      S E N T R Y - C I D                                                   1
  31.  
  32.      _______________________________________________________________________
  33.  
  34.  
  35.  
  36.      Sentry-CID (SCID) is a Caller-ID-to-BBS interface for DOS and OS/2.
  37.      Sentry-CID will read your mailer's logfile for Caller-ID information
  38.      (either American standard format or Canadian multi-page) and log the
  39.      caller's phone number, and, after much verification, automatically log
  40.      the user onto the bbs.  SCID v2 now has a powerful new-user validation
  41.      mode which can be used to upgrade the access of callers ON-LINE,
  42.      eliminating the need for kludgy call-back verifiers.  Sentry-CID is
  43.      even smart enough to set your system clock!
  44.  
  45.      NOTE: Automatic logon and newuser validation is only available for the
  46.            Maximus BBS system.  Users of other bbs systems can use Sentry to
  47.            simply keep track of your caller's phone numbers.
  48.  
  49.      Skip ahead to section [3] to get set-up and running.  Please refer to
  50.      README.TXT for information on other utilities (bbs and otherwise) that
  51.      I have produced.  Please refer to REGISTER.TXT to find out how to
  52.      register SCID.
  53.  
  54.      Sentry-CID was tested on the original Caller-ID BadBoy, the SupraFAX 
  55.      14.4 modem (with "J" ROMs) and is compatible with standard CID from the
  56.      United States and multi-page Caller-ID (hex data) used up here in the
  57.      Great White North.  SCID should work with all other Rockwell-based
  58.      Caller-ID capable modems, such as the Zoom, non-Rockwell modems such as
  59.      the ZyXel, and the new Caller-ID capable modems offered by USR 
  60.      (Sportster and Courier).
  61.  
  62.  
  63.  
  64.      ┌═════════════┐
  65.      │ [1.1] INDEX │
  66.      └═════════════┘
  67.  
  68.  
  69.                1 Sentry-CID
  70.                     1.1 Index
  71.                     1.2 Features
  72.                     1.3 Requirements
  73.                     1.4 Contents of the Sentry-CID archive
  74.                     1.5 Registration
  75.  
  76.                2 Legal-Type Stuff
  77.                     2.1 Disclaimer and Warranty
  78.                     2.2 License
  79.                     2.3 Copyrights
  80.  
  81.                3 Setup and Operation
  82.                     3.1 Configuring Your System
  83.                     3.2 Running Sentry-CID
  84.                     3.3 PhoneList
  85.                     3.4 Running Sentry-CID Validator
  86.                     3.5 Running Sentry-CID Updater
  87.                     3.6 Configuring Sentry-CID
  88.  
  89.                4 Maximus BBS
  90.                     4.1 Auto-Login
  91.                     4.2 OnLine Validation
  92.                     4.3 After Validation
  93.                     4.4 Ensuring the number is kept accurate
  94.  
  95.                5 Miscellaneous Information
  96.                     5.1 Frequently Asked Questions
  97.                     5.2 Known Bugs
  98.                     5.3 Future Plans
  99.                     5.4 Software Updates and Support
  100.                     5.5 Sentry's PGP Signature
  101.                     5.6 Contacting the Author
  102.  
  103.  
  104.  
  105.      ┌════════════════┐
  106.      │ [1.2] FEATURES │
  107.      └════════════════┘
  108.  
  109.  
  110.      Here are the features of Sentry-CID:
  111.  
  112.           GENERAL FEATURES
  113.                ■ DOS and OS/2 executables
  114.                ■ Can read American standard Caller-ID or Canadian
  115.                  multi-page format (hex text)
  116.                ■ Can barricade private callers
  117.                ■ Can automatically synchronize the system clock with the
  118.                  Caller-ID time (to the nearest minute)
  119.                ■ Can log Caller-ID data to the BBS log for easy correlation
  120.                  between user on-line and true calling number
  121.  
  122.           PHONELIST
  123.                ■ Alias "+" matching on phone numbers for the same user who
  124.                  calls from different phone numbers
  125.                ■ Drop carrier on twit users by matching "-" phone numbers
  126.                ■ Can login users found ONLY in phonelist for a truly private
  127.                  system
  128.  
  129.           USER LOGON (MAXIMUS v3)
  130.                ■ Matches caller phone number with user in the bbs userfile
  131.                  and logs them on (data phone or voice phone)
  132.                ■ Will prompt for password on user's request or if SCID is
  133.                  unsure of the accuracy of the CID data
  134.                ■ ALWAYS prompts for a password when asstsysop or sysops
  135.                  login, when multiple users of the same number call or when
  136.                  a user has not called in a long while
  137.                ■ logs on the last caller when multiple users are flagged for
  138.                  the same phone number
  139.                ■ Can login users found ONLY in bbsfile for a truly private
  140.                  system
  141.  
  142.           NEW USER VALIDATION (MAXIMUS v3)
  143.                ■ Sentry v2 includes a powerful on-line validator for new
  144.                  users by directly modifying the bbs userfiles (the flaky
  145.                  'flagfile' method is gone)
  146.                ■ Validation can be allowed or denied based on whether the
  147.                  number supplied by the user is the CID number, whether the
  148.                  number already exists in the userbase, and whether the CID
  149.                  data shows private, out-of-area, or error
  150.                ■ Both users who pass and users who fail can be given
  151.                  different access levels
  152.                ■ The user's dataphone number will be automatically set to
  153.                  the Caller-ID data and the both the data and voice numbers
  154.                  will be written in a sysop-defined format
  155.  
  156.           CID DATA VERIFICATION ENSURES NO LOGIN "MISTAKES"
  157.                ■ Makes sure CID time and mailer time do not differ by more
  158.                  than a certain amount in case of wonky CID data
  159.                ■ Makes sure mailer time and current time do not differ by
  160.                  more than a certain amount in case the mailer has
  161.                  "forgotten" to resume writing to the logfile (ie. after a
  162.                  system crash)
  163.                ■ Makes sure CID time is within a certain distance from the
  164.                  end of the logfile just for the hell of it
  165.  
  166.  
  167.  
  168.      ┌════════════════════┐
  169.      │ [1.3] REQUIREMENTS │
  170.      └════════════════════┘
  171.  
  172.  
  173.      To run Sentry-CID, you need to have:
  174.           ■ a Caller-ID (or "Ident-a-Call" or "Call-View") service installed
  175.             on your phoneline by the local phone company.  If yours is
  176.             anything like Ma Bell, there will probably be a set-up fee and
  177.             monthly service charge
  178.           ■ a modem capable of producing Caller-ID data. To see if your
  179.             modem has this ability, type AT#CID=? in a terminal and the
  180.             modem should respond with: 0,1,2
  181.           ■ a mailer such as BinkleyTerm, Intermail or Portal Of Power
  182.             capable of recording the Caller-ID data to a logfile
  183.           ■ Maximus bbs to utilize the auto-login options.  Users of other
  184.             bbs software should be able to use other features of SCID, such
  185.             as simply tracking the phone number in the logfile
  186.           ■ Maximus bbs to use new-user validation and access upgrade
  187.           ■ DOS or OS/2 v2.0+
  188.  
  189.  
  190.  
  191.      ┌══════════════════════════════════════════┐
  192.      │ [1.4] CONTENTS OF THE SENTRY-CID ARCHIVE │
  193.      └══════════════════════════════════════════┘
  194.  
  195.  
  196.      FILE_ID.DIZ
  197.  
  198.           Description file for BBS file databases.
  199.  
  200.      REGISTER.TXT
  201.  
  202.           Registration form.
  203.  
  204.      SENTRY.DOC
  205.  
  206.           This file.
  207.  
  208.      SENTRY.EXE
  209.  
  210.           Sentry-CID DOS 16-bit executable.
  211.  
  212.      SENTRYP.EXE
  213.  
  214.           Sentry-CID/2 OS/2 v2.0 32-bit executable.
  215.  
  216.      SENTRY.CFG
  217.  
  218.           Sample Sentry-CID configuration file.
  219.  
  220.      SENTRY.FON
  221.  
  222.           Sample alias-matching phonelist.
  223.  
  224.      WHATSNEW.xxx
  225.  
  226.           A list of the changes in each release of Sentry-CID.
  227.  
  228.      README.TXT
  229.  
  230.           Other software by me!
  231.  
  232.  
  233.  
  234.      ┌════════════════════┐
  235.      │ [1.5] REGISTRATION │
  236.      └════════════════════┘
  237.  
  238.  
  239.      As a registration incentive, the useful [AUTOSETTIME], [NOSYSOPLOGIN]
  240.      and [LASTCALL_AGE] features are activated, and the "please register"
  241.      kludges also disappear.
  242.  
  243.      Refer to the file REGISTER.TXT for more information on registering.
  244.  
  245.      I'm a student at Queen's University at Kingston, and I wrote this
  246.      program in my spare time. Registration of SCID is only $10 which will
  247.      help pay for my taxi ride to the grocery store and back.  Thank-you in
  248.      advance!
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.      L E G A L - T Y P E    S T U F F                                      2
  256.  
  257.      _______________________________________________________________________
  258.  
  259.  
  260.  
  261.      ┌═══════════════════════════════┐
  262.      │ [2.1] DISCLAIMER AND WARRANTY │
  263.      └═══════════════════════════════┘
  264.  
  265.  
  266.      SCID is not programmed to format your harddrive, make your modem dial
  267.      long-distance to China while you are sleeping, or run amok in any other
  268.      mischievous manner.  However, if you manage to reduce your your
  269.      harddrive to egg salad as a result of using Sentry-CID, I will not be
  270.      held responsible for any damages incurred to your system, business or
  271.      mental state.
  272.  
  273.      SCID comes with no warranty.  I'm fairly confident that SCID will not
  274.      fail when used correctly as outlined in this document, but as
  275.      experience has shown me, "there is always one more bug".
  276.  
  277.      How come disclaimers always sound so grumpy?  Things can always go the
  278.      OTHER way.  Maybe you'll get lucky and SCID will be responsible for
  279.      increasing the accuracy of your Pentium CPU by 43%.  Funky chicken!
  280.  
  281.  
  282.  
  283.      ┌═══════════════┐
  284.      │ [2.2] LICENSE │
  285.      └═══════════════┘
  286.  
  287.  
  288.      You are ENCOURAGED to register Sentry-CID after evaluating it for a
  289.      reasonable period of time.  You may use a registered copy of SCID on
  290.      any number of machines operated BY YOURSELF.  Any money you send will
  291.      help further my education as my rent and food budget seem to be getting
  292.      smaller and smaller everyday  ;)
  293.  
  294.  
  295.  
  296.      ┌══════════════════┐
  297.      │ [2.3] COPYRIGHTS │
  298.      └══════════════════┘
  299.  
  300.  
  301.           ■ MAXIMUS copyright(c) 1993, 1996 by Scott Dudley, Lanius Corp
  302.             [1:249/106]
  303.           ■ REMOTE ACCESS copyright (c) 1996 Andrew Milner & Wantree
  304.             Development
  305.           ■ WATCOM is a trademark of WATCOM International Corp.
  306.           ■ MA BELL should be a trademark of Bell Canada
  307.           ■ 386i, 486i and PENTIUM are trademarks of Intel
  308.           ■ SUPRA copyright(c) 1996 by Supra Corp
  309.           ■ COURIER and SPORTSTER copyright(c) 1996 by US Robotics
  310.           ■ MAXCID copyright(c) 1994 by Louis LePage [1:246/66]
  311.           ■ CIDLOG copyright(c) 1992 by Steven L. Davis
  312.           ■ MAXID copyright(c) 1993 by Wayne Boyd [1:153/763]
  313.           ■ Pretty Good Privacy(tm) PGP copyright(c) 1990-1994 by Philip
  314.             Zimmermann, Phil's Pretty Good Software.
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.      S E T U P    A N D    O P E R A T I O N                               3
  322.  
  323.      _______________________________________________________________________
  324.  
  325.  
  326.  
  327.      Sentry-CID will login, validate or barricade users after performing a
  328.      variety of checks on the CID data to determine it's accuracy.  If you
  329.      are running Maximus BBS and BinkleyTerm, you are in luck because so do
  330.      I, and I have included easy examples to help you with the setup.  For
  331.      users of other software, it should be a simple matter of changing
  332.      pathnames and filenames to obtain the desired result.
  333.  
  334.  
  335.  
  336.      ┌═══════════════════════════════┐
  337.      │ [3.1] CONFIGURING YOUR SYSTEM │
  338.      └═══════════════════════════════┘
  339.  
  340.  
  341.      Caller-ID use must be enabled on your modem.  For modems with the
  342.      Rockwell chipset (like the Supra) the command is:
  343.  
  344.      AT #CID=1
  345.  
  346.      which should be placed in your mailer's modem init string.  Second, you
  347.      must tell your front-end mailer to answer on the second ring to allow
  348.      the Caller-ID information to be read by the modem.
  349.  
  350.  
  351.      FRONT-END MAILER CONFIG
  352.      -----------------------
  353.  
  354.      For FRONTDOOR, tell the mailer to put modem info into the log.
  355.      Use FDSETUP:
  356.  
  357.                ┌──────────────────────────────────────────────┐
  358.                │Modem Control -> AnswerControl -> Enable LDFRS│
  359.                └──────────────────────────────────────────────┘
  360.  
  361.      For INTERMAIL 2.29k, use IMSETUP:
  362.  
  363.                       ┌─────────────────────────────────┐
  364.                       │Modem > Advanced Setup > Messages│
  365.                       └─────────────────────────────────┘
  366.  
  367.                        ╔════════════════════ Messages ╗
  368.                        ║ CID - NAME  NAME             ║
  369.                        ║ CID - NMBR  NMBR             ║
  370.                        ║ CID - DATE  DATE             ║
  371.                        ║ CID - TIME  TIME             ║
  372.                        ╚══════════════════════════════╝
  373.  
  374.                    ┌────────────────────────────────────────┐
  375.                    │Modem > Advanced Setup > Command Strings│
  376.                    └────────────────────────────────────────┘
  377.  
  378.           ╔═════════════════════════════════════════ Command strings ╗
  379.           ║ Init-2         AT#CID=1|                                 ║
  380.           ╚══════════════════════════════════════════════════════════╝
  381.  
  382.  
  383.                    ┌────────────────────────────────────────┐
  384.                    │Modems > Advanced Setup > Answer Control│
  385.                    └────────────────────────────────────────┘
  386.  
  387.           ╔═════════════════════════════════════════ Answer control ╗
  388.           ║ Manual answer  Yes                                      ║
  389.           ║ Force answer   ATB0A|                                   ║
  390.           ║ Answer delay   7                                        ║
  391.           ║ Answer on ring 2                                        ║
  392.           ╚═════════════════════════════════════════════════════════╝
  393.  
  394.  
  395.      For BINKLEYTERM v2.60, proper config verbs would be:
  396.  
  397.                          ┌────────────────────────────┐
  398.                          │Answer             ATA|     │
  399.                          │Init               AT#CID=1|│
  400.                          │LogLevel           4        │
  401.                          │ModemRinging       Ring     │
  402.                          │RingTries          7        │
  403.                          │RingWait           2        │
  404.                          └────────────────────────────┘
  405.  
  406.      or, with BINKLEYTERM v2.59,
  407.  
  408.                          ┌────────────────────────────┐
  409.                          │Answer             ATA|     │
  410.                          │Init               AT#CID=1|│
  411.                          │LogLevel           4        │
  412.                          │ModemRinging       Nmbr     │
  413.                          │ModemRinging       Mesg     │
  414.                          │RingTries          7        │
  415.                          └────────────────────────────┘
  416.  
  417.      or an even older version (v2.50),
  418.  
  419.                        ┌───────────────────────────────┐
  420.                        │Answer             ~~~`````ATA|│
  421.                        │Init               AT#CID=1|   │
  422.                        │LogLevel           4           │
  423.                        │RingTries          7           │
  424.                        └───────────────────────────────┘
  425.  
  426.  
  427.      RESULT CODES
  428.      ------------
  429.  
  430.      Your modem should start sending results usually including the DATE,
  431.      TIME and the calling NMBR:
  432.  
  433.                            ┌─────────────────────┐
  434.                            │DATE = 0401          │
  435.                            │TIME = 2019          │
  436.                            │NAME = HENDRIKS JASON│
  437.                            │NMBR = P             │
  438.                            │NMBR = O             │
  439.                            │NMBR = 5423120       │
  440.                            │NMBR = 16135423120   │
  441.                            │QUAL = L             │
  442.                            └─────────────────────┘
  443.  
  444.      or, if you live in Canada (multi-page format), you should get the DATE,
  445.      TIME and corresponding MESG (or NMBR for PRIVATE/OUT-OF-AREA calls):
  446.  
  447.                       ┌─────────────────────────────────┐
  448.                       │DATE = 0401                      │
  449.                       │TIME = 2019                      │
  450.                       │NMBR = P                         │
  451.                       │NMBR = O                         │
  452.                       │MESG = 030735343233313230        │
  453.                       │MESG = 030B3136313335343233313230│
  454.                       │MESG = 06014C                    │
  455.                       └─────────────────────────────────┘
  456.  
  457.  
  458.      LOADING THE BBS
  459.      ---------------
  460.  
  461.      Ordinarily, your front-end mailer probably calls a batch file with a
  462.      set of parameters to pass to the bbs.  If that file is SPAWNBBS.BAT:
  463.  
  464.         ┌───────────────────────────────────────────────────────────────┐
  465.         │@echo off                                                      │
  466.         │\max\max.exe -s%1 -b%2 -p%3 -t%4   (or ra.exe -b%2 -p%3 -t%4 ?)│
  467.         └───────────────────────────────────────────────────────────────┘
  468.  
  469.      you must change it to first run SCID, then run the batch file created
  470.      by SCID:
  471.  
  472.                        ┌───────────────────────────────┐
  473.                        │@echo off                      │
  474.                        │cd \sentry                     │
  475.                        │sentry.exe                     │
  476.                        │call loadbbs.bat %1 %2 %3 %4 %5│
  477.                        └───────────────────────────────┘
  478.  
  479.  
  480.  
  481.      ┌══════════════════════════┐
  482.      │ [3.2] RUNNING SENTRY-CID │
  483.      └══════════════════════════┘
  484.  
  485.  
  486.      The included SENTRY.CFG configuration file will need only minimal
  487.      changes of a few path and file names before running SCID.  See section
  488.      [3.6].  If you don't understand what a particular keyword is for, then
  489.      you probably don't need to change it.  Don't forget to put your
  490.      region's area code in!
  491.  
  492.      REMEMBER TO REGULARLY BACKUP YOUR USERBASE!
  493.  
  494.      SCID takes three optional command line parameters.  Switch to the SCID
  495.      directory and run SENTRY -? (DOS) or SENTRYP -? (OS/2) for quick help.
  496.  
  497.           Usage: sentryp  [ <config-file> ]  [-vud]
  498.                  -v : Verify mode
  499.                  -u : Update mode
  500.                  -d : Debug mode
  501.  
  502.      The <config-file> command line option allows you to run SCID with a
  503.      different configuration file, which is handy for multi-node systems
  504.      which need to read different log files and write to different data and
  505.      batch files.  Sentry-CID will attempt to read the default configuration
  506.      file "SENTRY.CFG" in the current directory if no alternate
  507.      configuration file is specified on the command line.
  508.  
  509.      Sentry'd default behavior is to parse the mailer log, record the info 
  510.      and log the user onto the bbs.  Run Sentry with NO command line
  511.      parameters just before your mailer spawns your bbs program:
  512.           (eg) SPAWNBBS.BAT
  513.                ------------
  514.                cd \sentry
  515.                sentry.exe
  516.                call loadbbs.bat
  517.  
  518.      The -v command line option tells SCID to run in verify mode, upgrade
  519.      the user's access and update the user's DATA phone number. This should
  520.      be run from the bbs EVERY time a new user has logged on and filled in
  521.      the applicable information.  More information on verify mode is
  522.      available in section [3.4].
  523.           (eg) \sentry\sentry.exe  -v  \sentry\sentry.cfg
  524.  
  525.      The -u command line option tells SCID to simply update the user's DATA
  526.      phone number. This can be run by the bbs EVERY time any user logs on,
  527.      in order to update the dataphone number of all your old users, or to
  528.      catch any new numbers a user may call from. See section [3.5].
  529.           (eg) \sentry\sentry.exe  \sentry\sentry2.cfg  -u
  530.  
  531.      The -d command line option tells SCID to run in debug mode.  This was
  532.      mainly for me while developing SCID and runs the program a tad slower.
  533.      But you may be interested to see just what kind of numbers SCID is
  534.      crunching through or may want to verify it's operation.  Using this
  535.      option automatically switches Sentry to loglevel 5!
  536.  
  537.      Sentry-CID returns the following errorlevels:
  538.           ■ 0: No operation (fatal error), syntax displayed
  539.           ■ 1: User known, autologin, autopassword
  540.           ■ 2: User known, autologin, no autopassword
  541.           ■ 3: User known, no autologin, no autopassword
  542.           ■ 4: User unknown (not found in USER.BBS)
  543.           ■ 5: Out-of-area caller
  544.           ■ 6: Private caller
  545.           ■ 7: User barred from bbs
  546.           ■ 8: Error reading log
  547.  
  548.      Sentry-CID will always write a LOADBBS.BAT file which simply calls the
  549.      bbs if an error occurs.  If a critical error occurs (such as not being
  550.      able to read the config file, or bad arguments passed on the command
  551.      line), SCID will beep twice indicating its inability to write the
  552.      LoadBBS batch file.
  553.  
  554.  
  555.  
  556.      ┌═════════════════┐
  557.      │ [3.3] PHONELIST │
  558.      └═════════════════┘
  559.  
  560.  
  561.      Please note that the phonelist file is read sequentially, and the first
  562.      match will be the only match as far as SCID is concerned.
  563.  
  564.      If a user calls from more than one number, their other number(s) can be
  565.      "alias matched" to the phone number contained in the phonelist.  The
  566.      following:
  567.  
  568.      + (519)-740-9592 5423120 623-0186 ; calling from the office
  569.  
  570.      would search for the phone number (519) 740-9592 in the userfile if any
  571.      calls were received from 542-3120 (current area code) or 546-3844
  572.      (current area code).  It is important to separate the "+" and
  573.      subsequent phone numbers and to NOT have any 'whitespace' within the
  574.      phone number.
  575.  
  576.      If [FORCELIST] is active, then only numbers listed in the phonelist,
  577.      or alias-matched in the phonelist, would be allowed to login.  A single
  578.      entry on a line is also acceptable for this feature:
  579.  
  580.      + (519)6210192
  581.  
  582.      If there are twit users who you don't want calling your system, you can
  583.      include their phone numbers in the alias file as barricaded numbers. 
  584.      Any phone numbers following a minus sign "-" in the phonelist will be
  585.      prevent the bbs from even loading.  The following:
  586.  
  587.      - 547-6756                                  ; go away Ian
  588.      - 519-432-4747   (613)-531-3093  791-4458    ; those other twits
  589.  
  590.      would drop carrier on any nuisance callers before they even have a 
  591.      chance to log onto the system.  Again, lines with single entries are
  592.      acceptable.
  593.  
  594.  
  595.  
  596.      ┌════════════════════════════════════┐
  597.      │ [3.4] RUNNING SENTRY-CID VALIDATOR │
  598.      └════════════════════════════════════┘
  599.  
  600.  
  601.      ** PLEASE NOTE THAT THE OPERATION OF SENTRY 2.x IN VALIDATION MODE IS
  602.      DIFFERENT FROM THAT OF SENTRY 1.x.  USING SENTRY 2.x WILL BREAK YOUR 
  603.      1.x CONFIGURATION. **
  604.  
  605.      ** VALIDATOR IS NOW FUNCTIONAL IN THE UN-REGISTERED VERSION **
  606.  
  607.  
  608.      Sentry-CID v2.x includes a powerful validator which verifies new users
  609.      on-line, upgrades their access and places the Caller-ID data directly
  610.      into the user's DATAPHONE field.  Sentry v2.00 only supports Maximus
  611.      BBS with this feature.
  612.  
  613.      The -v command line options tell Sentry-CID to run in validate mode. 
  614.      Sentry-CID will modify Max's LASTUSxx.BBS as defined by the
  615.      [LASTUSERFILE] keyword.  After SCID runs, you must tell your BBS to
  616.      re-read the file.  See section [4.2] for an example.
  617.  
  618.  
  619.      Sentry-CID Validator will compare the phone number in the user file to
  620.      the phone number obatined via Caller-ID.  If the numbers match, the
  621.      caller will be upgraded to the level indicated by [PASSACCESS].  If the
  622.      numbers don't match, the caller can still be upgraded to perhaps a
  623.      'limited' access with the [FAILACCESS] keyword.  Sentry-CID will write
  624.      a small text file as defined by [RESPONSEFILE] with a brief explanation
  625.      on why the validation failed for display by the BBS.
  626.  
  627.      The user's DATA phone number will be changed to the phone number given
  628.      by Caller-ID.  Sentry-CID Validator will also rewrite the VOICE phone
  629.      number in the format specified in the config file, a handy way of
  630.      making sure all phone numbers in your userbase share the same style.
  631.      The dataphone number will NOT be changed if:
  632.           ■ The Caller-ID data reports "ERROR"
  633.           ■ The keyword [NOPHONECHANGE] is used
  634.  
  635.      It is possible to specify the conditions in which a user's access will
  636.      be upgraded via the [UPGRADE] keyword.  After the [UPGRADE] keyword,
  637.      simply include one or more of the following modifiers:
  638.           ■ ERROR: To upgrade a user whose Caller-ID data fails (through no
  639.             fault of their own) with "Error"
  640.           ■ OUT-OF-AREA: To upgrade a user whose telephone company does not
  641.             yet support Caller-ID
  642.           ■ PRIVATE: To upgrade a caller who purposely blocks their phone
  643.             number from Caller-ID
  644.           ■ NUMBERMISMATCH: To upgrade a caller even if the user-supplied 
  645.             and Caller-ID numbers do not match
  646.           ■ DUPENUMBERS: To upgrade a caller who's Caller-ID phone number is
  647.             already in use by another user
  648.      By including all five of these parameters, EVERY user will be given
  649.      higher access, useful if you want all first-time callers to have normal
  650.      access on your system.
  651.  
  652.      I would suggest running Sentry-CID with the [UPGRADE] NUMBERMISMATCH
  653.      feature.  Since Sentry will supply you with the Caller-ID number in
  654.      the user's dataphone field anyway, "verifying" what the user says is
  655.      their phone number becomes a pointless exercise.  Instead, ask the user
  656.      for their voice (or alternate calling) number and Sentry will allow
  657.      the user to logon from either number.
  658.      
  659.      Sentry-CID Validator returns the following errorlevels:
  660.           ■ 0: No operation (fatal error), syntax displayed
  661.           ■ 1: User passed validation (pass)
  662.           ■ 2: Duplicate numbers found in userbase (fail)
  663.           ■ 3: Given number does not match CID number (fail)
  664.           ■ 4: Caller-ID reports "ERROR" (fail)
  665.           ■ 5: Caller-ID reports "OUT-OF-AREA" (fail)
  666.           ■ 6: Caller-ID reports "PRIVATE" (fail)
  667.           ■ 7: AsstSysOp or higher access level (fail)
  668.  
  669.  
  670.  
  671.      ┌══════════════════════════════════┐
  672.      │ [3.5] RUNNING SENTRY-CID UPDATER │
  673.      └══════════════════════════════════┘
  674.  
  675.  
  676.      Sentry-CID can update the DATA phone number of existing users to the
  677.      Caller-ID data.  This can be used on users who were not upgraded by
  678.      Sentry-CID Validator (ie. if they joined your BBS before Sentry was
  679.      installed or if you are still using a Call-Back-Verifier to do your
  680.      user upgrades).  Sentry v2.00 only supports Maximus BBS for this 
  681.      feature.
  682.  
  683.      If you wish to have Sentry-CID just update the DATA phone number, run
  684.      SCID with the -u command line paramter.  As with the validation mode,
  685.      Sentry-CID will also rewrite the VOICE phone number in the format
  686.      specified in the config file, a handy way of making sure all phone
  687.      numbers in your userbase share the same style.  See section [4.4] for 
  688.      an example.
  689.  
  690.      The dataphone number will NOT be changed if:
  691.           ■ The Caller-ID data reports "ERROR"
  692.           ■ The keywords [NOPHONECHANGE] or [NODATAPHONEUPDATE] are used
  693.           ■ The keyword [NOSYSOPLOGIN] is used and the user, and the user
  694.             has a security level of AsstSysOp or higher
  695.           ■ The current user has a null password (a "guest" account)
  696.  
  697.      Sentry-CID Validator returns the following errorlevels:
  698.           ■ 0: No operation (fatal error), syntax displayed
  699.           ■ 1: Numbers changed
  700.           ■ 2: Numbers not changed
  701.  
  702.  
  703.  
  704.      ┌══════════════════════════════┐
  705.      │ [3.6] CONFIGURING SENTRY-CID │
  706.      └══════════════════════════════┘
  707.  
  708.  
  709.      This is a detailed listing of commands in Sentry-CID's config file, by
  710.      default named SENTRY.CFG.  Pathnames and settings are all contained in
  711.      the configuration file.
  712.  
  713.      The sample configuration file is arranged in groups of parameters which
  714.      show which parameters need to be changed for which operational modes.
  715.      For ease of use as a reference, the parameters are listed alphabetically
  716.      here.  Commands are not case-sensitive and text found after semi-colons
  717.      located anywhere in the file are treated as comments.
  718.  
  719.  
  720.      Allow_Private
  721.  
  722.           Allow callers with blocked numbers to be passed to the bbs;
  723.           otherwise Sentry-CID will drop carrier (by NOT loading the bbs).
  724.           See [FORCELIST] and [FORCEUSERBBS].
  725.  
  726.      APW_KeyToggle <keys>
  727.  
  728.           This is the Maximus key (or keys) which must be set for the
  729.           current user to have the [AUTOPASSWORD] setting *toggled*.
  730.           Thus, if you have [AUTOPASSWORD] commented out (disabled) and
  731.           the user has the key set in [APW_KEYTOGGLE], then they will be
  732.           logged on as if [AUTOPASSWORD] was enabled.  Vice versa,
  733.           [AUTOPASSWORD] would be *disabled* for this user if it was
  734.           enabled in the configuration file.  I recommend using
  735.           key "L" (for "l"ogin).  Valid keys range from 1-8 and A-X.
  736.  
  737.           Comment out [APW_KEYTOGGLE] to totally disable the auto-password
  738.           feature.  See [AUTOPASSWORD].
  739.  
  740.      Area_Code <area_code>
  741.  
  742.           Your region's phone area code.  See [COUNTRY_CODE].
  743.  
  744.      AutoLogin
  745.  
  746.           Determines whether the bbs is given the user's name for login.
  747.           See [AUTOPASSWORD].
  748.  
  749.      AutoPassword
  750.  
  751.           Determines whether the bbs is given the user's name *and* password
  752.           for login (ie.  *completely* logged on) after Sentry-CID performs
  753.           all it's time and user status checks, or if the user is prompted
  754.           for their password.  This command is disabled if [AUTOLOGIN] is
  755.           disabled.  This command is toggled by the key in [APW_KEYTOGGLE].
  756.           This feature is automatically disabled for users using the
  757.           encrypted passwords in Maximus version 3.x.  See [AUTOLOGIN] and
  758.           [APW_KEYTOGGLE].
  759.  
  760.      AutoSetTime
  761.  
  762.           Allow Sentry-CID to set the system time.  Sentry-CID confirms that
  763.           the CID time is accurate by checking current time difference and
  764.           log time difference.  See [CID_DIF_LOW], [CID_DIF_HIGH],
  765.           [MAILER_DIF] and [IGNORE_RESTRICTIONS].  (REGISTERED FEATURE).
  766.  
  767.      Batch <filename> [DEFAULT is LoadBBS.BAT (DOS) or LoadBBS.CMD (OS/2)]
  768.  
  769.           The path and filename of the bbs batchfile to write (I suggest
  770.           LOADBBS.BAT).  Use different names in different configuration
  771.           files for different nodes on a multi-node system.  See [LOAD_BBS].
  772.  
  773.      BBSLog <filename>
  774.  
  775.           Will write the CID phone number and the user's name to the BBS
  776.           logfile, handy for a quick correlation between the real phone
  777.           number and the user logged on while reading the BBS logfile.
  778.           (v2.00)
  779.  
  780.      BBSType <string> [DEFAULT is Maximus]
  781.  
  782.           Your BBS type so that Sentry-CID knows how to read the different 
  783.           BBS datafiles.  SCID currently supports "Maximus" or "RA".
  784.           (v2.00)
  785.  
  786.  
  787.      CID_Dif_High <time_in_minutes> [DEFAULT is 65.0]
  788.  
  789.           The *maximum* time difference between the CID time and mailer log
  790.           time before setting the system clock.  Who knows, someone at the
  791.           phone company may decide to play a joke on you.  Set it greater
  792.           than 60 minutes to allow for daylight savings in your area!
  793.           See [AUTOSETTIME], [CID_DIF_LOW], [MAILER_DIF] and
  794.           [IGNORE_RESTRICTIONS].
  795.  
  796.      CID_Dif_Low <time_in_minutes> [DEFAULT is 1.0]
  797.  
  798.           The *minimum* time difference between the CID time and mailer log
  799.           time before setting the system clock.  No need to fiddle with
  800.           the system clock if the discrepancy is only a minute or two -
  801.           this may lead to weird looking logfiles in other running
  802.           processes. See [AUTOSETTIME], [CID_DIF_HIGH], [MAILER_DIF] and
  803.           [IGNORE_RESTRICTIONS].
  804.  
  805.      Country_Code <country_code>
  806.  
  807.           Your country's phone code (1 for U.S. and Canada).  See
  808.           [AREA_CODE].
  809.  
  810.      DoNotUpgrade
  811.  
  812.           Not a real command, but can be used to store the modifiers which
  813.           aren't currently being used by the [UPGRADE] keyword.  See
  814.           [UPGRADE].  (v2.00)
  815.  
  816.      FailAccess <securitylevel>
  817.  
  818.           The security level to give to users who FAIL validation.
  819.           Maximus users use one of the following keywords: TWIT DISGRACE 
  820.           LIMITED NORMAL WORTHY PRIVIL FAVORED EXTRA CLERK ASSTSYSOP
  821.           SYSOP HIDDEN or a value between 1 and 65535.  Commenting out this
  822.           keyword will disable access changes for failed validations. See
  823.           [PASSACCESS].  (v2.00)
  824.  
  825.      ForceList
  826.  
  827.           Login users found only in the [PHONELIST] file.  See
  828.           [ALLOW_PRIVATE] and [FORCEUSERBBS].
  829.  
  830.      ForceUserBBS
  831.  
  832.           Login users found only in the [USER_BBS] file (disabled if
  833.           [USER_BBS] is not specified).  See [ALLOW_PRIVATE] and
  834.           [FORCELIST].
  835.  
  836.      Ignore_Restrictions
  837.  
  838.           This tells SCID to NOT verify the CID time, mailer log time or CID
  839.           position in the logfile when logging in a user or setting the
  840.           time.  This command should never be enabled except for debugging
  841.           purposes.  See [AUTOSETTIME], [CID_DIF_HIGH], [CID_DIF_LOW] and
  842.           [MAILER_DIF].
  843.  
  844.      LastCall_Age <age_in_days> [DEFAULT is disabled]
  845.  
  846.           This is the greatest amount of time (in days) to allow
  847.           auto-password for a user.  When users move or disconnect their
  848.           phone number, there is a good chance that someone else will get
  849.           that phone number and be logged in as them when they call your
  850.           board.  A setting of zero disables this feature.  (REGISTERED
  851.           FEATURE).
  852.  
  853.      LastUserBBS <filename>
  854.  
  855.           The path and filename of the BBS on-line userfile to be re-read by
  856.           the BBS after modification by Sentry-CID in VERIFY or UPDATE mode. 
  857.           (v2.00)
  858.  
  859.      Load_BBS <command_line>
  860.  
  861.           The command line to load your BBS.  For Maximus system use
  862.           something like:
  863.  
  864.                \Max\Max.exe -s%1 -b%2 -p%3 -t%4 -L\Max\Logs\MAX.LOG
  865.  
  866.           For R/A systems use something like:
  867.  
  868.                \ra\ra.exe -b%2 -p%3 -t%4
  869.  
  870.           See [BATCH].
  871.  
  872.      LogLevel <log_level> [DEFAULT is level 3]
  873.  
  874.           This specifies how much information to put in SCID's status log.
  875.           Acceptable values are from 1 (minimal information) to 5 (maximum
  876.           information).  Each log entry is preceded by a character
  877.           indicating the importance of the entry, in traditional
  878.           BINKLEY/MAXIMUS style.  See [SENTRYCIDLOG].
  879.  
  880.                LogLevel  Characters That Precede Included Entries
  881.  
  882.                     1      ! *
  883.                     2      ! * +
  884.                     3      ! * + :
  885.                     4      ! * + : #
  886.                     5      ! * + : # and blank (no character)
  887.  
  888.           Sample log output:
  889.  
  890.          # 05 Nov SCID Begin, Sentry-CID/2 Ver. 1.20f [REGISTERED] [DEBUG]
  891.          # 05 Nov SCID Reading mailer logfile "d:\max\logs\Bink2.LOG"
  892.            05 Nov SCID CID data found 9 lines from end, out of 38 lines read
  893.          : 05 Nov SCID Scanned phone number is 613-382-1817
  894.          * 05 Nov SCID Ignoring time/date/position restrictions
  895.          # 05 Nov SCID Reading phonelist "d:\max\sentry\Sentry.FON"
  896.            05 Nov SCID Caller not in phonelist
  897.          # 05 Nov SCID Reading BBS userfile "d:\Max\User.BBS"
  898.          : 05 Nov SCID (   7) Jason White, Gananoque (214 calls)
  899.          : 05 Nov SCID ( 186) Heather White, Gananoque (4 calls)
  900.          : 05 Nov SCID ( 310) Amber White, Gananoque (1 call)
  901.            05 Nov SCID Duplicate accounts found for this phone number
  902.          # 05 Nov SCID Writing CID datafile "\max\node2\CID.DAT"
  903.          # 05 Nov SCID Writing BBS batch file "node2\LoadBBS.cmd"
  904.          + 05 Nov SCID Jason White - AUTO-LOGIN/NO AUTO-PASSWORD (2)
  905.          # 05 Nov SCID End, Sentry-CID/2 Ver. 1.20f
  906.  
  907.      MailerLogFile <filename>
  908.  
  909.           The path and filename of the mailer logfile containing the
  910.           Caller-ID information to read.  Only BinkleyTerm and FrontDoor
  911.           style logs are supported.
  912.  
  913.      Mailer_Dif <time_in_minutes> [DEFAULT is 1.5]
  914.  
  915.           The time discrepancy allowed between the current time and mailer
  916.           log time.  Occasionally, BinkleyTerm will decide NOT to
  917.           continue writing to it's logfile, and this setting prevents
  918.           logging the same user on over and over when the logtime fails
  919.           to lie within this time.  Increase the time if you have some
  920.           other application which runs between the mailer and Sentry-CID.
  921.           See [AUTOSETTIME], [CID_DIF_HIGH], [CID_DIF_LOW] and
  922.           [IGNORE_RESTRICTIONS].
  923.  
  924.      Max_Back <number_of_lines> [DEFAULT is 12 lines]
  925.  
  926.           The number of lines from the end of the [MAILERLOGFILE] where the
  927.           CID information must lie for the data to be considered accurate.
  928.           This is in case two CID blocks are received right after
  929.           each other and the phone message of the first is unreadable.
  930.           Trust me, this HAS happened :)  See [READFROM].
  931.  
  932.      Node <number>
  933.  
  934.           Logs the current task number to the logfile for multi-node
  935.           systems.  (v2.00)
  936.  
  937.      NoPhoneChange
  938.  
  939.           The userbase VOICE and DATA phone fields will NOT be modified
  940.           in either VERIFY or UPDATE mode.  (v2.00)
  941.  
  942.      NoDataPhoneUpdate
  943.  
  944.           The userbase DATA phone field will NOT be modified if the DATA
  945.           phonenumber already exists and if this number is not the same as
  946.           the VOICE phonenumber.  Use this if you wish Sentry to capture
  947.           once, and then never change, the Caller-ID number of old users
  948.           as they call in and get run through Sentry's UPDATE mode. This
  949.           allows a user to call from a friend's house, without Sentry
  950.           changing their regular datanumber (if it is different from their
  951.           voicephone).  If this command is NOT used, Sentry will ALWAYS
  952.           replace whatever is in the dataphone field with the current
  953.           Caller-ID info when run in UPDATE mode (except in the case where
  954.           the CID already matches the voice phone).  (v2.00)
  955.  
  956.      NoSound
  957.  
  958.           Disables the PC speaker in case your computer, like mine, traps
  959.           when the PC speaker is accessed or if you generally dislike
  960.           your computer beeping at you!  Sentry-CID only beeps on warnings
  961.           (*) and critical errors (!).
  962.  
  963.      NoSysOpLogin
  964.  
  965.           This feature disables [AUTOPASSWORD] for users with an access
  966.           level of asstsysop or above.  You probably don't want anyone
  967.           other than the asstsysop or sysop themselves logging in from
  968.           their line and accessing your bbs.  See [AUTOPASSWORD].
  969.           (REGISTERED FEATURE).
  970.  
  971.      Output [DEFAULT is CID.DAT]
  972.  
  973.           The path and filename of an ASCII file to write the Caller-ID data
  974.           to for your own use on your bbs or in another application.
  975.           Unregistered versions of Sentry-CID will have an "UNREGISTERED
  976.           COPY" nag written to the file.
  977.  
  978.      PassAccess <securitylevel>
  979.  
  980.           The security level to give to users who PASS validation.
  981.           Maximus users use one of the following keywords: TWIT DISGRACE 
  982.           LIMITED NORMAL WORTHY PRIVIL FAVORED EXTRA CLERK ASSTSYSOP
  983.           SYSOP HIDDEN or a value between 1 and 65535.  Commenting out this
  984.           keyword will disable access changes for successful validations.
  985.           See [FAILACCESS].  (v2.00)
  986.  
  987.      PhoneList <filename>
  988.  
  989.           The path and filename of the alias-matching phonelist.  Leave
  990.           commented out to disable the reading of the [PHONELIST] file.
  991.           The first phone number following a "+" in the [PHONELIST] file
  992.           will be the [USER_BBS] entry, and all phone numbers following
  993.           it (on that line) will be matched to that number for users who
  994.           call from different phone numbers.  Phone numbers following a
  995.           "-" in the [PHONELIST] are blacklisted numbers and SCID will
  996.           drop carrier on those users (by not loading the BBS).  See
  997.           [FORCELIST].
  998.  
  999.      PhoneMask <string> [DEFAULT is (###) ###-####]
  1000.  
  1001.           The phone format outputted by Sentry-CID for the logs and
  1002.           userfile can be defined with this keyword.  Use the pound '#'
  1003.           character to indicate where in the string you would like the
  1004.           numerals for the phone number to appear.  Country & area
  1005.           codes do not neccessarily have to be specified.  Thanks to
  1006.           Bob Swift for this suggestion.  (v2.00)
  1007.              (eg.)  PhoneMask ###-####
  1008.                     PhoneMask #.###.###.####
  1009.  
  1010.      ReadFrom <byte_location> [DEFAULT is 1500 bytes]
  1011.  
  1012.           The position from the end of the mailer logfile where SCID will
  1013.           begin reading.  This will probably not need to be changed
  1014.           unless you have another program which runs before SCID and
  1015.           adds to the mailer log file.  See [MAX_BACK].
  1016.  
  1017.      Registration <key>
  1018.  
  1019.           This is your key which activates the registered features of
  1020.           Sentry-CID.  See [SYSOP].
  1021.  
  1022.      ResponseFile
  1023.  
  1024.           The path and filename of an ASCII text file containing a brief
  1025.           explanation of why validation failed.  Comment out to disable.
  1026.           Unregistered versions of Sentry-CID will have an "UNREGISTERED
  1027.           COPY" nag written to the file.  (v2.00)
  1028.  
  1029.      SentryCIDLog <filename>
  1030.  
  1031.           The path and filename where SCID will log it's operation.  Leave
  1032.           commented out to disable logging.  See [LOGLEVEL].
  1033.  
  1034.      SysOp <name>
  1035.  
  1036.           Your name!  See [REGISTRATION].
  1037.  
  1038.      Upgrade <modifier>
  1039.  
  1040.           Specifies the conditions which must be met for a user to "pass"
  1041.           the validation process.  OUTOFAREA, PRIVATE and ERROR modifiers
  1042.           allow an upgrade if the CID data returns one of these strings
  1043.           instead of a phone number.  DUPENUMBERS allow an upgrade even if
  1044.           the number supplied is already listed in the userbase.
  1045.           NUMBERMISMATCH allows an upgrade even when the numbers do not
  1046.           match.  Using all the keywords will force EVERY user to be
  1047.           upgraded.  See [DONOTUPGRADE].  (v2.00)
  1048.  
  1049.      User_BBS <filename>
  1050.  
  1051.           The path and filename of the Maximus USER.BBS file to read.  See 
  1052.           [FORCEUSERBBS].
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.      M A X I M U S    B B S                                                4
  1060.  
  1061.      _______________________________________________________________________
  1062.  
  1063.  
  1064.  
  1065.      I am willing to implement login code for other bbs systems (I have
  1066.      looked into Remote Access and that system won't do it).  If you think
  1067.      it is possible with the BBS software you are running, please let me
  1068.      know.
  1069.  
  1070.      The following examples are VERY scaled-down versions of the scripts
  1071.      that I use to control my Maximus bbs with Caller-ID.  They were
  1072.      intended to be simple and clear.  If you have a good grip with the
  1073.      MECCA (or MEX) Maximus script language, don't be afraid to experiment
  1074.      with what you can do!
  1075.  
  1076.  
  1077.  
  1078.      ┌══════════════════┐
  1079.      │ [4.1] AUTO-LOGIN │
  1080.      └══════════════════┘
  1081.  
  1082.  
  1083.      If [FORCEUSERBBS] is active, only phone numbers found in the [USER_BBS]
  1084.      file (either VoicePhone or DataPhone) would be allowed to login.
  1085.      Otherwise, the caller's phone number will be looked up in the BBS
  1086.      userfile and the matching caller will be logged in, providing
  1087.      [AUTOLOGIN] is active.  Callers who have the [APW_KEYTOGGLE] will have
  1088.      their [AUTOPASSWORD] action toggled from the default.  Comment out
  1089.      [APW_KEYTOGGLE] to disable the auto-password feature altogether.
  1090.      Callers who meet the following criteria will be prompted for a
  1091.      password:
  1092.           ■ AsstSysOp or SysOp security level
  1093.           ■ encrypted passwords
  1094.           ■ multiple accounts at the same phone number
  1095.           ■ haven't called in a while (in case a new caller has their
  1096.             number)
  1097.           ■ CID data fails the time/position checks (front-end log problem)
  1098.  
  1099.  
  1100.  
  1101.      ┌══════════════════════════┐
  1102.      │ [4.2] ON-LINE VALIDATION │
  1103.      └══════════════════════════┘
  1104.  
  1105.  
  1106.      Add the following to the top of your MAX\MISC\NEWUSER1.MEC file and
  1107.      compile it with MECCA.EXE:
  1108.  
  1109.             ┌──NEWUSER1.MEC──────────────────────────────────────┐
  1110.             │[clear_stacked]Enable auto-logins? [[Y,n]? [menu]yn|│
  1111.             │[choice]n [keyon]L                                  │
  1112.             │                                                    │
  1113.             └────────────────────────────────────────────────────┘
  1114.  
  1115.      This will prompt the new user if they would like to enable the
  1116.      auto-logins and set the "L" key if they don't want the feature.
  1117.      If you want to have SCID's Auto-Password feature DISABLED by
  1118.      default, then comment out [AUTOPASSWORD] in the config file and
  1119.      reverse the above to:
  1120.  
  1121.             ┌──NEWUSER1.MEC──────────────────────────────────────┐
  1122.             │[clear_stacked]Enable auto-logins? [[y,N]? [menu]yn|│
  1123.             │[choice]y [keyon]L                                  │
  1124.             │                                                    │
  1125.             └────────────────────────────────────────────────────┘
  1126.  
  1127.      Now, remember that Sentry will plug the Caller-ID data into the
  1128.      user's dataphone field.  So it makes more sense to ask for the user's
  1129.      voice phone number so that you can keep track of both numbers.
  1130.  
  1131.      To APPLIC.MEC, add a line stating "Please enter your *VOICE* phone
  1132.      number when prompted."
  1133.  
  1134.      Then, at the beginning of MAX\MISC\NEWUSER2.MEC, run Sentry -v to
  1135.      upgrade the user with the [UPGRADE] NUMBERMISMATCH feature enabled
  1136.      in the configuration file:
  1137.  
  1138.             ┌──NEWUSER2.MEC──────────────────────────────────────┐
  1139.             │[xtern_dos]@\SENTRY\SENTRY.EXE \SENTRY\SENTRY.CFG -v│
  1140.             └────────────────────────────────────────────────────┘
  1141.  
  1142.      But if you prefer the "traditional" validation route of upgrading the
  1143.      user's access level *only if* the number they say they are calling from
  1144.      is in fact that number, then add a line to APPLIC.MEC stating "Please
  1145.      enter your *MODEM'S* phone number when prompted."
  1146.  
  1147.      Then, add the following to the top of your NEWUSER2.MEC file and
  1148.      compile it, running Sentry -v without [UPGRADE] NUMBERMISMATCH:
  1149.  
  1150.     ┌──NEWUSER2.MEC────────────────────────────────────────────────────────┐
  1151.     │[/Start]                                                              │
  1152.     │NEW USER VALIDATION                                                   │
  1153.     │                                                                      │
  1154.     │Verifying your number, please wait.                                   │
  1155.     │[xtern_dos]@\SENTRY\SENTRY.EXE \SENTRY\SENTRY.CFG -v                  │
  1156.     │[AE Normal]Passed validation![goto Done]                              │
  1157.     │Your number has failed validation because:                            │
  1158.     │  [link]\SENTRY\FAILED.TXT                                            │
  1159.     │                                                                      │
  1160.     │Please change your phone number, or request validation from the SysOp.│
  1161.     │<C>hange number <l>eave message or <q>uit to bbs [[C,l,q]? [menu]clq| │
  1162.     │[choice]q [goto Done]                                                 │
  1163.     │[choice]l [leave_comment goto Done]                                   │
  1164.     │[menu_cmd chg_phone]                                                  │
  1165.     │[goto Start][/Done]                                                   │
  1166.     └──────────────────────────────────────────────────────────────────────┘
  1167.  
  1168.      You may want to put the above in a separate script file and include an
  1169.      option for new users to access it from your main menu in case the
  1170.      validation fails the first time around.
  1171.  
  1172.  
  1173.  
  1174.      ┌════════════════════════┐
  1175.      │ [4.3] AFTER VALIDATION │
  1176.      └════════════════════════┘
  1177.  
  1178.  
  1179.      Your users may want to toggle their [AUTOPASSWORD] status themselves.
  1180.      To set that up, entering the following in your CHANGE menu in
  1181.      MAX\MENUS.CTL and re-SILT Max:
  1182.  
  1183.          ┌──MENUS.CTL─────────────────────────────────────────────────┐
  1184.          │Display_File   Misc\LogTogle   Limited   "Auto-Login Toggle"│
  1185.          └────────────────────────────────────────────────────────────┘
  1186.  
  1187.      and create and compile the file MAX\MISC\LOGTOGLE.MEC:
  1188.  
  1189.                   ┌──LOGTOGLE.MEC────────────────────────────┐
  1190.                   │[notkey]L AUTO-LOGIN has been toggled OFF.│
  1191.                   │[notkey]L [keyon]L [enter][quit]          │
  1192.                   │AUTO-LOGIN has been toggled ON.           │
  1193.                   │[keyoff]L [enter][quit]                   │
  1194.                   └──────────────────────────────────────────┘
  1195.  
  1196.  
  1197.  
  1198.      ┌════════════════════════════════════════════┐
  1199.      │ [4.4] ENSURING THE NUMBER IS KEPT ACCURATE │
  1200.      └════════════════════════════════════════════┘
  1201.  
  1202.  
  1203.      You can run Sentry in Update mode, which will make sure users who
  1204.      logged onto _prior_ to the installation of Sentry-CID will have their
  1205.      dataphone numbers updated with their current CID data.  Add this to
  1206.      your MAX\MISC\WELCOME.MEC file:
  1207.  
  1208.             ┌──WELCOME.MEC───────────────────────────────────────┐
  1209.             │[xtern_dos]@\SENTRY\SENTRY.EXE \SENTRY\SENTRY.CFG -u│
  1210.             └────────────────────────────────────────────────────┘
  1211.  
  1212.  
  1213.      The file LOGO.MEC will not be shown to a user who is logged on by
  1214.      Sentry-CID.  You can use this to catch users who start calling from a
  1215.      different number (blocked numbers or users sharing accounts?).  Place
  1216.      the following in your MAX\MISC\LOGO.MEC file:
  1217.  
  1218.                          ┌──LOGO.MEC─────────────────┐
  1219.                          │[open]UnKnown.DAT [open]nul│
  1220.                          └───────────────────────────┘
  1221.  
  1222.      and in MAX\MISC\WELCOME.MEC to nag users who login (and not new users):
  1223.  
  1224.    ┌──WELCOME.MEC──────────────────────────────────────────────────────────┐
  1225.    │[ifexist]UNKNOWN.DAT [GE Normal]You are calling from an unknown number!│
  1226.    │[delete]UNKNOWN.DAT                                                    │
  1227.    └───────────────────────────────────────────────────────────────────────┘
  1228.  
  1229.      Personally, I give users five chances (in a row) using Maximus keys to
  1230.      call from a wrong number, then they are denied access.  Your
  1231.      implementation should depend on the level of security your system
  1232.      requires.
  1233.  
  1234.      Suggestion for the strong-hearted: Use SCID's errorlevels in a batch
  1235.      file for a more powerful implementation of the above procedure (for
  1236.      example, so that legitimate callers who show up as "Out-of-Area" are
  1237.      not chastised, but "Private" callers are).
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.      M I S C E L L A N E O U S   I N F O R M A T I O N                     5
  1245.  
  1246.      _______________________________________________________________________
  1247.  
  1248.  
  1249.  
  1250.      ┌═════════════════════════════════┐
  1251.      │ [5.1] FREQUETLY ASKED QUESTIONS │
  1252.      └═════════════════════════════════┘
  1253.  
  1254.  
  1255.      Q. Is there a way to get Sentry to log all user names attached to the
  1256.         CID number in the log file?  Handy for tracking multiple aliases.
  1257.      A. Use LOGLEVEL 3 or higher.
  1258.  
  1259.  
  1260.      Q. Sentry reads the phone number but won't match it to the caller's
  1261.         number in the userbase.
  1262.      A. Make sure you have defined your AREACODE in the config file!
  1263.         Without it, Sentry will not strip off the areacodes of any phone
  1264.         numbers in the userbase.
  1265.  
  1266.  
  1267.      Q. Sentry doesn't give the user a message when they aren't in the
  1268.         userbase and FORCELIST hangs up on then.
  1269.      A. I haven't looked into writing to the COM port, perhaps I will for
  1270.         a future release (at least for the OS/2 version).
  1271.  
  1272.  
  1273.      Q. After the "Nmbr" string, Binkley says "No Answer" and then answers
  1274.         as normal?
  1275.      A. This is cosmetic and doesn't affect Binkley's operation.  Bink's
  1276.         "ModemRinging" feature is colliding with it's answering function.
  1277.         Use "RingTries 7" in your config to get rid of this response.
  1278.  
  1279.  
  1280.      Q. Is the Cyrix bug fixed yet?
  1281.      A. No.  The *DOS* executable is still unstable on a Cyrix processor.
  1282.  
  1283.  
  1284.  
  1285.      ┌══════════════════┐
  1286.      │ [5.2] KNOWN BUGS │
  1287.      └══════════════════┘
  1288.  
  1289.  
  1290.      There was a report that the DOS executable does not run properly
  1291.      with a Cyrix CPU (something to do with no available memory).  I am
  1292.      looking into this one, but so far it has me stumped..  Could have
  1293.      something to do with the Pentium optimization routines by the
  1294.      Watcom compiler.
  1295.      
  1296.  
  1297.  
  1298.      ┌════════════════════┐
  1299.      │ [5.3] FUTURE PLANS │
  1300.      └════════════════════┘
  1301.  
  1302.  
  1303.      In future versions I may include:
  1304.      
  1305.           ■ reading of MAX\ACCESS.CTL for user-defined security levels
  1306.      
  1307.           ■ reading of RA\EXITINFO.BBS and RA\USER.BBS for on-line
  1308.             validation with the Remote Access BBS system.  I attempted
  1309.             to put this into Sentry v2.00, but the pascal structures
  1310.             for RA frustrated me too much!  Not to mention there isn't
  1311.             much incentive, because I am a big fan of SJD's Maximus.
  1312.      
  1313.  
  1314.  
  1315.      ┌════════════════════════════════════┐
  1316.      │ [5.4] SOFTWARE UPDATES AND SUPPORT │
  1317.      └════════════════════════════════════┘
  1318.  
  1319.  
  1320.      I will release new versions of this software package as new ideas hit
  1321.      me or as bug reports come in (knock on silicon) :)  New releases will
  1322.      be found at the BBS or URL listed below.  Registered users of
  1323.      Sentry-CID will receive notices from me when new versions are
  1324.      available.
  1325.  
  1326.  
  1327.  
  1328.      ┌══════════════════════════════┐
  1329.      │ [5.5] SENTRY'S PGP SIGNATURE │
  1330.      └══════════════════════════════┘
  1331.  
  1332.  
  1333.      To capture my public key to your public key ring and check the
  1334.      validity of the executables, run:
  1335.  
  1336.           pgp sentry.doc [filename]
  1337.  
  1338.      Substitute SENTRY.EXE for [filename] on the first pass, then run
  1339.      pgp again with SENTRYP.EXE for the second pass.  On the first
  1340.      pass you should see:
  1341.  
  1342.           Text is assumed to be in file 'sentry.exe'.
  1343.           Good signature from user "Jason Hendriks".
  1344.           Text is assumed to be in file 'sentry.exe'.
  1345.           WARNING: Bad signature, doesn't match file contents!
  1346.  
  1347.      .. and on the second pass:
  1348.  
  1349.           Text is assumed to be in file 'sentryp.exe'.
  1350.           WARNING: Bad signature, doesn't match file contents!
  1351.           Text is assumed to be in file 'sentryp.exe'.
  1352.           Good signature from user "Jason Hendriks".
  1353.  
  1354.      Do not run the executables if either pass reports BAD Signature
  1355.      for both packets!  The executables may be hacked or corrupted.
  1356.  
  1357.      (The "WARNING: Bad signature" above is expected ONCE per pass
  1358.      because PGP checks both the packets below against the same executable
  1359.      and has to fail on the packet which wasn't created for it.)
  1360.      
  1361.  
  1362. -----BEGIN PGP PUBLIC KEY BLOCK-----
  1363. Version: 2.6.i
  1364.  
  1365. mQCNAjAS9Z0AAAEEANf+B0l0Cy/80td2CW9oREAA9ZCPh1YKWZADdygxR8nZW+Uy
  1366. MMZ2r3exYJbZTBa9DSG/wfoRFXpW7sx5v+38KdjiAFV6KilcBX4xiOcD2yRPYT4E
  1367. EfpMx0zXUbAGZ3stzu4wB7pGfgnPF6wF+ObGHIzcf5Ctaj4yTDYhNdf0Y5Q1AAUR
  1368. tCdKYXNvbiBIZW5kcmlrcyA8M2poaDNAcWxpbmsucXVlZW5zdS5jYT4=
  1369. =QS2F
  1370. -----END PGP PUBLIC KEY BLOCK-----
  1371.  
  1372. -----BEGIN PGP MESSAGE (SENTRY.EXE SIG)-----
  1373. Version: 2.6.2
  1374.  
  1375. iQCVAwUAMsn6cDYhNdf0Y5Q1AQHHNQP9GBj1zmh8GWkp4bHumU5D2FCWVMY+LHPD
  1376. 5tr9xBydkuEQd0oUfVSpgwfWpHw2orpkcypncyLZwZA0c+f90eA9x/bfAWKxcoB2
  1377. 0zQ0Iu4iGfso726ZMLzht0eSuGM1oBQoFoNoNufwKSwP04qSnt0Fi+PA3lYzoo1o
  1378. l/KlFQ25kDU=
  1379. =aS/I
  1380. -----END PGP MESSAGE-----
  1381.  
  1382. -----BEGIN PGP MESSAGE (SENTRYP.EXE SIG)-----
  1383. Version: 2.6.2
  1384.  
  1385. iQCVAwUAMsn6dzYhNdf0Y5Q1AQE0uQQAiOHJwbT2isy90tom8DS37f/3Y4NY8jG+
  1386. hA3efRuObTLDzZA0nai2YSLC2yPLo85mr9q+EFz3rjU1Blf47wpYXNAh/yYzpyr2
  1387. kl3EWdAZy0pugwSDX2U2Yau7ziNFenyDRbmywhp8ZpZJvgELJDiqwiT4K2ksKdvd
  1388. WiHr78pGCUE=
  1389. =n4qJ
  1390. -----END PGP MESSAGE-----
  1391.  
  1392.  
  1393.  
  1394.      ┌═════════════════════════════┐
  1395.      │ [5.6] CONTACTING THE AUTHOR │
  1396.      └═════════════════════════════┘
  1397.  
  1398.  
  1399.      I welcome all comments, suggestions and praise :)  If you are reporting
  1400.      a bug you've found, please also include a snippet of the mailer log
  1401.      which caused the error and a copy of SCID's output log in debug mode.
  1402.  
  1403.      Or maybe you'll just want to write me to say hi or offer me a
  1404.      high-paying job.  When I'm not hanging out in FIDO.BINKLEY or
  1405.      FIDO.OS2PROG, I can be reached at:
  1406.  
  1407.  
  1408.            ┌──────────────────────────────────────────────────────────┐
  1409.          ┌─┴────────────────────────────────────────────────────────┐ │
  1410.          │    E-Mail: 3jhh3@qlink.queensu.ca                        │ │
  1411.          │            Jason.Hendriks@cyberspace.crp.kingston.on.ca  │ │
  1412.          │       URL: http://qlink.queensu.ca/~3jhh3/software/      │ │
  1413.          │                                                          │ │
  1414.          │  Net-Mail: Cyberspace/2 BBS - FidoNet [1:249/117]        │ │
  1415.          │       BBS: Node1 - 1:249/117 (14.4k) [613-542-3120]      │ │
  1416.          │            Node2 - 1:249/119 (33.6k) [613-542-4119]      │ │
  1417.          │            Queen's University, Kingston/Ont, CANADA      │ │
  1418.          │                                                          │ │
  1419.          │Snail-Mail: Jason Hendriks                                │ │
  1420.          │            580 Armstrong Rd #410                         │ │
  1421.          │            Kingston, Ontario                             │ │
  1422.          │            K7M 8M3                                       │ │
  1423.          │            CANADA                                        ├─┘
  1424.          └──────────────────────────────────────────────────────────┘
  1425.  
  1426.  
  1427.      Made in Canada, eh?
  1428.  
  1429.  
  1430.      ---
  1431.  
  1432.      &:-) JtG in '97!
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.      Ω
  1440.