home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / aplog / aplog100.txt next >
Encoding:
Text File  |  1993-08-16  |  9.4 KB  |  261 lines
  1. ***************************************************************************
  2.  
  3. APLogin - Replacement Login program for IBM TCP/IP.
  4.  
  5. Version 1.00ß
  6.  
  7.  
  8.  
  9. Copyright (c)1993 Andy Collins, Eric D. Mudama, All Rights Reserved
  10.  
  11. ***************************************************************************
  12.  
  13. INCLUDED FILES:
  14.  
  15. READ.ME            -The file you should already have read...  :-)
  16. install.txt        -This file that you are reading
  17. bin.zip            -This includes the following:  Note that by
  18.              unpacking bin.zip, you agree to the terms below.
  19.              (See DISCLAIMER)
  20.  
  21.     -aplogin.exe    -Replacement login program
  22.     -adduser.exe    -Utility to add users to your passwd file
  23.     -greeting.txt    -Sample Greeting message file
  24.     -welcome.txt    -Sample Welcome message file
  25.     -badlogin.txt    -Sample Badlogin message file
  26.  
  27.  
  28. ***************************************************************************
  29.  
  30. INSTALLATION:
  31.  
  32. To install APLogin, use the following procedure:
  33.  
  34. 1.    Rename the LOGIN.EXE that is included with IBM TCP/IP to
  35.     another name.  This allows you to return to the old state
  36.     if you decide not to use APLogin.
  37.  
  38. 2.    Create a directory to hold APLogin.  We recommend that
  39.     APLogin and its support files be contained in their own
  40.     directory.
  41.  
  42. 3.    Using a PKUNZIP 2.x compatible program, unzip the included
  43.     BIN.ZIP into this directory.  This will unpack aplogin.exe,
  44.     adduser.exe, as well as the included sample text files.
  45.  
  46. 4.    Add the following environment variables to your config.sys
  47.     file:
  48.  
  49. Variable:               Used for:
  50. ===========================================================================
  51. ATLPAC_PASSWD_FILE        location of passwd file    (required)
  52. ATLPAC_GREETING_FILE        location of greeting file (optional)
  53. ATLPAC_WELCOME_FILE        location of welcome file (optional)
  54. ATLPAC_BADLOGIN_FILE        location of badlogin file (optional)
  55. ATLPAC_LOG_FILE            location of event log (optional)
  56.  
  57.  
  58. Example:
  59. ===========================================================================
  60. SET ATLPAC_PASSWD_FILE=C:\TCPIP\APLOGIN\PASSWD
  61. SET ATLPAC_GREETING_FILE=C:\TCPIP\APLOGIN\GREETING.TXT
  62. SET ATLPAC_WELCOME_FILE=C:\TCPIP\APLOGIN\WELCOME.TXT
  63. SET ATLPAC_BADLOGIN_FILE=C:\TCPIP\APLOGIN\BADLOGIN.TXT
  64. SET ATLPAC_LOG_FILE=c:\TCPIP\APLOGIN\MYLOG.TXT
  65.  
  66.  
  67. 5.    Copy the APLOGIN.EXE file to LOGIN.EXE in your TCPIP\BIN directory.
  68.     This replaces the existing LOGIN.EXE, so be sure that you copied
  69.     the old one to another location.
  70.  
  71. 6.    Reboot your computer, to set the environment variables.  Enjoy!
  72.  
  73. ***************************************************************************
  74.  
  75. OPERATION:
  76.  
  77. The following section describes how this software works:
  78.  
  79. APLogin replaces your existing LOGIN.EXE program, and includes a login
  80. procedure that supports multiple users with an encrypted password file.
  81.  
  82. We saw how the original TCP/IP login program only asked for a password,
  83. which was contained in plain text in your config.sys file.  We thought
  84. that this could be improved, so we wrote APLOGIN.EXE.
  85.  
  86. Note that this does not secure the actual operation of your system, once
  87. someone has successfully logged in.  Behavior of your system after login
  88. will not change by the use of this program.
  89.  
  90. The passwd file is a plain text file, like on any normal unix system.
  91. Nobody, including root, can read another user's password from this file,
  92. nor can a password be decoded.  We believe that this program cannot be
  93. broken unless someone has your actual username and password.
  94.  
  95. To allow for customization, we have included the ability to use your own
  96. message files.  These could announce any rules on your system, bulletins,
  97. or current events to each person who logged in.
  98.  
  99. The first of these files, greeting.txt, is displayed before the user is
  100. prompted for a username and a password.  If a login is successful,
  101. welcome.txt is displayed and the user is given a command prompt on your
  102. system.  This will usually be CMD.EXE.  (Unless you have changed your
  103. default command interpreter to 4OS2, or something else.)  If a user fails
  104. to get a correct password in three tries, the file badlogin.txt is
  105. displayed and the connection is terminated.  This file will usually just
  106. say "Maximum retries exceeded." or something similiar.  You are free to
  107. customize these files as you wish.  Keep in mind that these message files
  108. are optional.  If the files are not found, simple default messages will be
  109. displayed.
  110.  
  111. Once you have installed the software, set the environment variables, and
  112. rebooted your computer, it is time to create the passwd file.  Move to the
  113. location specified by the environment variable ATLPAC_PASSWD_FILE and type
  114. 'adduser'.  If a passwd file does not exist here, one will be created. 
  115. Adduser will prompt you for a username and a password, which is hidden,
  116. then it will prompt you to confirm the password.  If the two passwords
  117. match, it will add the user to the end of the password file.  If the two
  118. passwords do not match, the program will notify you of this and exit.
  119.  
  120. Also, adduser does not check to see if a user already exists.  To change a
  121. user's password, use any text editor to delete the line beginning with
  122. their username.  Then run adduser to add them to this file.
  123.  
  124. Once you have set up a user or two, you can try the program out, to
  125. simulate a login, by typing 'aplogin' at the prompt.  What is displayed is
  126. that same information that someone 'telneting' into your machine will see.
  127.  
  128. Once you are satisfied with how it looks, you are ready to allow other
  129. users to use your system.
  130.  
  131. If you wish to enable event logging, set the ATLPAC_LOG_FILE variable to a
  132. text file of your choice.  If this file does not exist, it will be created
  133. at run time.  This option allows logging of all successful and
  134. unsuccessful logins to this file.
  135.     
  136.                 -Enjoy,
  137.                   Eric D. Mudama and Andy Collins
  138.   
  139.  
  140. ***************************************************************************
  141.  
  142. REGISTRATION:
  143.  
  144. To register this software, please send check or money order for $5.00 to
  145. either of the following addresses:
  146.  
  147.     Eric D. Mudama            Andy Collins
  148.     119 Bay State Road        12564 Scully Avenue
  149.     Boston, MA  02215        Saratoga, CA  95070
  150.  
  151. Please include the following form with your payment:  It allows us to
  152. enter you as a user in our database, and will get you upgrades in the
  153. future.  Also, if you don't include this form, we will have no idea what
  154. the money is meant for.  Thanks for your time...
  155.  
  156.  
  157. ====================== APLogin Registration Form ==========================
  158.  
  159. Name:______________________________________________________________________
  160.  
  161. Address:___________________________________________________________________
  162.  
  163. City:_______________________________  State:_________  Zip:________________
  164.  
  165. Internet E-Mail:___________________________________________________________
  166.  
  167. Host Address where it will be used: (optional)  ______.______.______.______
  168.  
  169. Version of APLogin:______________________________________________   (1.00ß)
  170.  
  171. # of copies of APLogin in use:_____________  x $5.00 =  ___________________
  172.  
  173.                         Total:  ___________________
  174.  
  175. OPTIONAL:
  176.  
  177. Where did you get this copy of APLogin?
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188. How did you hear about APLogin?
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200. What suggestions do you have for future copies of APLogin?
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212. ================== End of APLogin Registration Form =======================
  213.  
  214. ***************************************************************************
  215.  
  216. If you like this software, let us know.  If you don't, let us know too.
  217. We have a couple of other projects in mind, so some encouragement would be
  218. great.
  219.  
  220. If this software does not work with your setup, let us know.  We will
  221. devote what time we can to getting it to work with your machine.  Note that
  222. this software has been tested under OS/2 2.1, and therefore ought to work
  223. under OS/2 2.0, but this cannot be guaranteed.  Also, it ought to work
  224. with any recent release of IBM's base TCP/IP package.  
  225.  
  226. Also note that this software is a 32-bit application, and therefore will
  227. not work with versions of OS/2 prior to OS/2 2.0.
  228.  
  229.  
  230. Thank you for your time,
  231.  
  232.     Eric D. Mudama (edmudama@athena.mit.edu)
  233.     Andy Collins (acollins@uclink.berkeley.edu)
  234.  
  235. ***************************************************************************
  236.  
  237. COPYRIGHT NOTICE AND DISCLAIMER:
  238.  
  239. Andy Collins and Eric D. Mudama disclaim all warranties, whether expressed
  240. or implied, including without limitation, warranties of fitness and
  241. merchantability with resspect to this software and the accompanying
  242. documentation.  Neither Andy Collins nor Eric D. Mudama, nor any other
  243. people associated with us are responsible for any damages incurred through
  244. the use of or the inability to use this software.  By using this software,
  245. you agree to these terms.
  246.  
  247. This software is shareware.  If you like it, or decide to continue to use
  248. this software beyond the 15-day trial period, a $5 registration fee is
  249. required.  By registering this software, you will recieve notification of
  250. new releases of this software, and be entitled to free upgrades forever
  251. when they become available.  
  252.  
  253. This software may be distributed freely, provided that there is no fee
  254. charged for the program, and that all of the original files are included
  255. in the distribution without modifications.  A distribution fee may be
  256. charged, provided that no special fee is charged for this software.
  257.  
  258. Copyright (c)1993 Andy Collins, Eric D. Mudama, All Rights Reserved
  259.  
  260. *************************** End of Document *******************************
  261.