home *** CD-ROM | disk | FTP | other *** search
/ The Best of Mecomp Multimedia 1 / Mecomp-CD.iso / amiga / tools / boot / amistation / amistation.doc < prev    next >
Encoding:
Text File  |  1996-04-07  |  9.3 KB  |  233 lines
  1.                       AmiStation - The Amiga Workstation
  2.                       ----------------------------------
  3.  
  4.                             Version 1.0, 08/04/1992
  5.  
  6.  
  7.                                 by Duane Fields
  8.  
  9.                     Any suggestions or bug reports welcome:
  10.  
  11.                 EMAIL : dkf8117@tamsun.tamu.edu (Internet)
  12.                 USMAIL: Box 1315, College Station TX 77841 USA
  13.  
  14.  
  15. DISCLAIMER:
  16.  
  17. This software is provided as is.  No representations or warranties are made
  18. with respect to the software's performance.  You use this software at your own
  19. risk.  The author assumes no responsibility or liability whatsoever with
  20. respect to your use or inability to use this software. So there!
  21.  
  22. ------------------------------------------------------------------------------
  23.  
  24. Introduction
  25. ------------
  26.  
  27. Do you get tired of your roomates always using your computer?  Are you
  28. afraid that your children or coworkers might accidentally destroy your data
  29. or beat your hi-score at Tetris while you're not around?  AmiStation
  30. provides a way of not only protecting your machine from casual users, but
  31. also gives your Amiga the look and feel of a hi-cost workstation machine.
  32.  
  33. AmiStation is a security program that restricts use, and can also track it.
  34. Each "trusted" user is assigned a login name and password.  At bootup they
  35. are presented with a login panel, ala a NeXT workstation where they must
  36. enter their assigned username and password.  The system then records the
  37. date and time of their login, so if someone screws up your system you'll
  38. know who to blame.
  39.  
  40.  
  41. Version:
  42. --------
  43.      (1.0) This is the evaluation version, and thus ANY password will be
  44.      accepted at the login panel.  See registration for more details.
  45.  
  46.  
  47. Author:
  48. -------
  49.      Duane K. Fields
  50.      PO Box 1315
  51.      College Station, TX 77841 USA
  52.  
  53.  
  54. Requirements:
  55. -------------
  56.      KickStart 2.x is REQUIRED!
  57.      Has been tested on A500/A2000/A3000 and with the 68000,6030,68040
  58.      ETC: and ENV: must be defined (more later)
  59.  
  60.  
  61. Purpose:
  62. --------
  63.    o Provide somewhat of a multi-user environment
  64.    o Make your Amiga look a little bit more professional looking
  65.    o Limit machine access (to the less knowledgeable user)
  66.  
  67.  
  68. Features:
  69. ---------
  70.    o Login panel (ala NeXT) at startup, unique username and password 
  71.      are required to access machine.
  72.    o Logs user's access
  73.    o Utility to add/remove/edit users (password protected)
  74.    o Finger utility to display user information
  75.    o Unix like user data
  76.    o Backdoor maintenance password
  77.    o Passwords are encrypted within the data files
  78.  
  79.  
  80. Possible Future Plans:
  81. ----------------------
  82.    o Maintain separate system preferences for each user
  83.    o "Email" between users
  84.    o Message-of-the-Day displayed at login
  85.    o Non-interlace option
  86.    o Load a custom login panel from disk
  87.    o Screen Blanker for the login screen
  88.  
  89.  
  90. Installation:
  91. -------------
  92.    o Add the following lines close to the beginning of your s:startup-sequence
  93.      They key here is to run AmiStation BEFORE any output is generated by
  94.      the startup-sequence.  Output causes a shell window to open up, and a
  95.      Control-D will abort the script.  The 2nd or 3rd line should usually
  96.      be all right.
  97.  
  98.         C:assign ENV: RAM:      
  99.         C:assign ETC: (wherever)
  100.         C:AmiStation (or wherever the executable is located)
  101.  
  102.    o ETC: is where AmiStation will store the passwd and usagelog files.
  103.      You should probably assign this to its own directory someplace where
  104.      it will not be tampered with. ENV: is required by some of the font
  105.      routines and should be assigned to RAM:
  106.  
  107.    o Next copy the AmiStation fonts to the FONTS: device.  Assuming you
  108.      are in the AmiStation directory, type this:
  109.  
  110.         copy fonts to FONTS: all
  111.  
  112.    o You may want to "crunch" the AmiStation executable with a program
  113.      like Imploder or PowerPacker.  AmiStation contains a lot of graphics
  114.      data and will crunch down about 80%.
  115.  
  116.  
  117. Backdoor Password:
  118. ------------------
  119.      At any password prompt you can use the backdoor (maintenance) password.
  120.      The password is hard coded and can not be changed.  This will let you have
  121.      access in the event the password file is deleted.  The current password is
  122.      defined to be "amistation".  Registered users can get a custom password.
  123.  
  124.     
  125. Usage:
  126. ------
  127.      The main program for the AmiStation package is "AmiStation".  To run
  128.      AmiStation you simply run the executable.  You can optionally use a
  129.      "-l" flag to disable the usage logging function with "AmiStation -l"
  130.      With no options AmiStation will append a line to ETC:usagelog upon any
  131.      successful login.  The file can be viewed with any text reader, or the
  132.      AmigaDOS "type" command.  You may want to cut down or delete the
  133.      etc:usagelog file on occasion, if it gets too large.
  134.  
  135.      When requested enter a username and password in the appropriate
  136.      requesters.  If the system does not let you on then you have entered
  137.      an incorrect username/password combination.  The backdoor password
  138.      must be used if no password file has been set up.  It IS CASE
  139.      SENSITIVE! (Keeping with the Unix workstation flavor)
  140.  
  141.      While at the login panel, clicking anywhere within the left half
  142.      will pop-up an information window, which will close when clicked on.
  143.      The information window will give you the program's version number,
  144.      author's name, and whom it is registered to.
  145.  
  146.      To create a password file, you must use the EdUser utility.  You will
  147.      want to create an account with the login name of "root".  The root
  148.      account is thought of by convention to be the manager or owner of the
  149.      system.  Anyone who knows the root password will be able to add,
  150.      delete, and edit users.
  151.  
  152.  
  153. EdUser:
  154. -------
  155.      EdUser is an included utility that lets you create, remove, and add
  156.      users.  To add, remove, or edit users you must have root access on
  157.      the machine.  When you run the program it will prompt you to enter
  158.      the root password.  If you do not have a password file, or you have
  159.      forgotten the root password, the backdoor password will work.  EdUser
  160.      has options to change a user's full name, a user's password, remove
  161.      users, and add users.  To change a user password you must know either
  162.      the password associated with the username, the root password, or the
  163.      backdoor password.  This allows a user to change his or her own password.
  164.      When changing the user's full name the current name will appear in
  165.      brackets.  Hitting return without any options will cause no changes to
  166.      be made.  The syntax of EdUser is:
  167.  
  168.      "EdUser -option username" where option is one of the following:
  169.               a   add user 'username' to system
  170.               f   change full name of 'username'
  171.               p   change password of 'username'
  172.               r   remove 'username' from system
  173.  
  174.      Running EdUser without any options will give you a syntax listing.
  175.      
  176.      Usernames and passwords are limited to 20 characters in length, while
  177.      a user's full name can be up to 35 characters long.  The program will
  178.      give you an error message and ask you to re-enter the request if you
  179.      specify too long a string.
  180.  
  181.  
  182. Finger:
  183. -------
  184.      The finger utility allows any user to get information on any other
  185.      user that has an account on the system.  Finger will show their
  186.      username, their full name, and the last date and time they logged in.
  187.      The syntax for finger is "finger name" or "finger -a".  "finger name"
  188.      will display information for all users matching the substring name in
  189.      either their username or their full name.  It is NOT case sensitive.
  190.      Using the "finger -a" command will display a list of ALL user accounts
  191.      that exist on the machine.
  192.  
  193.  
  194. Limitations:
  195. ------------
  196.      AmiStation does NOT fully protect your machine.  Although you can not
  197.      "break out" of AmiStation, there are several ways to get around it.
  198.      The Amiga is not meant to be a multi-user machine and thus has no
  199.      good way of file protection, everyone has access to everything.
  200.      Fortunately, most of the casual users that you are trying to keep
  201.      away will not know how to gain access to it.
  202.  
  203.  
  204. Registering:
  205. ------------
  206.      AmiStation is ShareWare.  The evaluation version may be freely
  207.      distributed, of course, but you must register to get the full release
  208.      version.  To register, print out the included orderform and mail it to
  209.      the address shown.
  210.  
  211.      Benefits of registering:
  212.  
  213.           o The login will require a valid username/password
  214.         o The backdoor password will be changed
  215.         o The login panel can have a custom logo or graphic
  216.         o First shot at updates
  217.         o Input into future program design
  218.  
  219.      Registered users will be notified by mail of any updates.  Updates
  220.      can be obtained by several methods:
  221.  
  222.         o By mailing me a SASE and a diskette
  223.         o Send me $2 to cover mailing and disk expenses ($5 to mail overseas)
  224.         o Via email if you have an internet address
  225.        
  226.      If you do not like the default login panel image, you can create your
  227.      own.  Included with this archive is an iff image of the panel which
  228.      you may edit with your favorite paint program.  Note that you should
  229.      leave the string gadget boxes where they are and DO NOT change the
  230.      dimensions.  You may change the palette, but leave the first four
  231.      colors intact.  If you wish a custom image, please include a copy of
  232.      the image file with your registration.
  233.