ftp.wwiv.com/ftp.wwiv.com.zip/ftp.wwiv.com/pub/BBS/DSADJ20.ZIP/DSADJ.DOC

Text File | 1994-08-24 | 6KB | 150 lines

                 ╓─────────────────────────────────────────╖
                 ║  DSADJ v2.0 -- Security Level Adjuster  ║
                 ║  For DOOR.SYS Files.  by Kevin Cummins  ║
                 ╙─────────────────────────────────────────╜


What is DSADJ?
═══════════════
DSADJ is a program that is designed to run prior to a door program that
reads DOOR.SYS, and adjusts the user's security level to whatever you
may configure. The door that reads DOOR.SYS will then use the
modified security leve. Before a user's security level is modified, their
name must be found in a file called SPECIAL.TXT that you create. DSADJ
then writes the modified DOOR.SYS upon exit.

DSADJ also returns errorlevel based on a correct match of a user's name.
One use of this might be in the SFLOGON.BAT file for the Spitfire sysop,
maybe other....? This would allow you to branch to a certain level in a
batch file based on what user is online.

Why DSADJ?
═══════════
DSADJ was written from a need to establish a way to allow certain users
access to a particular message conference, without altering the complete
security structure of the BBS. You may find other uses for this program
since DOOR.SYS is somewhat a 'generic' door info file.

Installation
═════════════
There should be four files included in this archive:

      DSADJ.EXE     ->  The Executable file.
      DSADJ.DOC     ->  What you are reading.
      SPECIAL.TXT   ->  Sample File with names of 'special' users.
      DSADJ.CFG     ->  Sample Config File with the 'change-to'
                        security level, and path to DOOR.SYS.


In this version, DSADJ looks for SPECIAL.TXT, and DSADJ.CFG in the
current directory when executed. So, you basically have a couple options
of where to locate the above files.

The one I prefer, (and the one I will document) is putting them in the
same directory as the door you are going to run. This option
would allow you to use DSADJ on more than one door, if need be. I run
this utility prior to the Jetmail QWK door for Spitfire, so this
explanation will follow that setup.

Now that you have all the files in the Jetmail directory, you need to
edit the two files, SPECIAL.TXT, and DSADJ.CFG

SPECIAL.TXT is a plain ascii text file that you create, with the names
of each user you wish to be allowed security level upgrade via DSADJ.
Dont worry about case-sensitivity, as DSADJ converts the names to all
uppercase characters at runtime. The only rule for creating this file,
is that each name must be on its own line, with NO blank lines allowed
in the file, or at the end. Refer to the sample SPECIAL.TXT.

DSADG.CFG is also a plain ascii text file. The first line is the
security level that DSADJ will upgrade users to. The second line is the
path to DOOR.SYS that your door program (Jetmail in this case) will
read. Normally, this will be the home BBS directory, but could be
different depending on how your door is installed.

The sample files, DSADJ.CFG and SPECIAL.TXT, are included for example
only. You must create these to fit your system!

Now the only thing left is adding it to the door batch file. Mine looks
like this:

        CD\DOORS\JETMAIL
        DSADJ
        JETMAIL C:\SF\DOOR.SYS JETMAIL.CNF
        CD\SF

As you can see, the only change I made was to add 'DSADJ' on the line
above my Jetmail command line.

NOTE: This security level change only remains in effect while the user
is in the door. When they return to the BBS, their regular security
level is once again in effect.

Errorlevel
══════════
If you want to use the errorlevel feature of DSADJ, you simply set up
your batch file to branch to a desired level. DSADJ returns an errorlevel
of 0 when the user's name does not exist in SPECIAL.TXT, and returns an
errorlevel of 1 if it does exist. Below is an example of how I use DSADJ
in my SFLOGON.BAT for my Spitfire BBS:


@echo off
dsadj
if errorlevel 1 goto MAIL
if errorlevel 0 goto CONTINUE

:MAIL
  cd\doors\jet
  jetmail c:\sf\door.sys jetmail.cnf
  cd\sf
:CONTINUE
  callers callers.cfg
  SFBLTN /LOG=C:\sf\CALLERS.TMP
  cd\sf
:END


I use the above to branch anyone logging on to relay QWK mail directly
into the mail door. OK, you say you can simply set up a SFSECxx.BAT file,
right? Right, but if you have any utilities in your SFLOGON.BAT file,
that security level will still have to contend with those things using
the SFSECxx.BAT method. As you can see above, if a user is found in
SPECIAL.TXT, then they are thrown directly into the mail door, and THEN
they will continue thru the rest of the items in your SFLOGON.BAT only if
they exit the mail door and continue on.

Also, when using the above, I am not using the change security level
feature of DSADJ, only the errorlevel capability. When used in this
manner, just set the security level in DSADJ.CFG to that level those
callers whose names you place in SPECIAL.TXT already have. That way, no
change in security level will take place.

Distribution:
═════════════
This program is FREEWARE, to be distributed freely as long as it remains
unmodified. If you do use the program, I'd appreciate a note letting me
know how you have applied it if different than the method below.

Disclaimer:
═══════════
Use of this program acknowledges this disclaimer of warranty: "This
program is supplied as is.  Kevin Cummins disclaims all warranties,
express or implied, including, without limitation, the warranties of
merchantability and of fitness of this program for any purpose.
Kevin Cummins also assumes no liability for damages direct or
consequential, which may result from the use of this program."


That is about it. Pretty simple, huh? If you do have any questions, I
can be reached via:
                         RIME Network
                         PhileoNet Christian Network

Or, you can call Crimson Cross BBS at 618-253-3608  USR HST DUAL 28.8


Spitfire is Copyright(c) by Mike Woltz
Jetmail is Copyright(c) by DJ Chuang