home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / lspw119.zip / README < prev    next >
Text File  |  1996-01-31  |  12KB  |  295 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                         LAN Server PassWord  Utility
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                             by: Keith Luken
  14.  
  15.                            (c)copyright 1996
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22. KL-LSPW is a utility for environments that include IBM's LAN SERVER and
  23. LOTUS' cc:MAIL messaging system. This utility allows you to fully automate
  24. the restting of lost or forgotten LAN Server Passwords. The utility requires
  25. that you have REXX installed on you OS/2 system that will be running KL-LSPW
  26. as well as access to the cc:MAIL .DLL files as well as the Post Office
  27. directory. This usually means you will want to run KL-LSPW from a workstation
  28. that is logged on the LAN as a LAN Administrator with access to cc:MAIL.
  29. *Note: With multiple domain support you do NOT have to leave workstation logged
  30. on as administrator. See Domain configuration info below!
  31.  
  32. The utility is very straight forward. You must have the LSRXUTL.DLL that comes
  33. with LAN Server as well as the REXXVIM.DLL supplied with KL-LSPW in a directory
  34. that is in your LIBPATH.  You also need to
  35. have the OS/2 VIM interface loaded on the workstation that you run KL-DIR on.
  36. You can download the LOTUS VIM files from CIS and Lotus' BBS as VDLOS2.ZIP.
  37. Just place the files in your \OS2\DLL directory and you will NOT need to have
  38. cc:MAIL client installed!
  39.  
  40.  
  41.  
  42. When you start KL-LSPW you will see the inital versions of the associated
  43. support files and systems. This data will be very important if you ahve
  44. any bugs to report. It will also display the delay until the initial check.
  45. To give a workstation time to boot and logon the LAN the first check will be
  46. between 5 and 15 minutes. This initial delay will be randomly generated as
  47. to not clash with other automated events that may be starting.
  48.  
  49.  
  50. Usage:
  51. KL-LSPW is a simple utility that periodically checks a cc:MAIL ID for
  52. messages. It takes the subject of the message and assumes that the subject is
  53. an IBM LAN Server ID and it attempts to reset that ID. It then sends a cc:MAIL
  54. message to the ID that requested the password rest acknowledging whther or not
  55. the action was completed. The LAN workstation you run KL-LSPW from must be
  56. logged on the LAN with ADMINISTRATOR authority. The program NO LONGER assumes
  57. that the ID to be reset is on the current DOMAIN. You must define each DOMAIN
  58. (including the default if you want to use it) to KL-LSPW.
  59.  
  60.  
  61.  
  62. Configuration Options:
  63.  
  64. When you start KL-LSPW for the first time on a system it should take you
  65. directly into the configuration screen. This data is very straight forward.
  66. The PO Path is the path from the system that KL-LSPW is running on.
  67. The PO Name is the PO Name that KL-LSPW will be a USER on and will check for
  68. mail. The PO Password is the password of the Post Office that KL-LSPW will be
  69. using. LSPW cc:MAIL ID is the cc:MAIL Id that KL-LSPW will be checking for
  70. messages. LSPW ID Password is the Password assigned to the ID on cc:MAIL that
  71. KL-LSPW will be using. There is NO VALIDITY CHECKING DONE!! It is YOUR
  72. RESPONSIBILTY to make sure the information you provide on the configuration
  73. pages is of the proper lenghts and syntax for cc:MAIL. The Check Interval
  74. is the interval, in minutes, between when KL-LSPW checks for messages. The
  75. maximum is 720 (12 Hours). If you want it to only check once a day let me know
  76. and I'll raise this. I suspect that most people will want this to check at
  77. least once an hour.
  78. The permissions are also very straight forward. This allows you to limit who
  79. can rest passwords. Most installations will want only authorized users to be
  80. able to reset passwords. If a users is defined to KL-LSPW (see next section)
  81. as an administrator then regardless of which option you pick for permissions
  82. and administrator can always have a password reset. Some people may ask why
  83. would you select ANY USER FOR OWN ID ONLY since if the user does not have
  84. their LAN password they can not access cc:MAIL. Well there is the possibility
  85. that an LAN administrator may have GUEST access set up for cc:MAIL so that a
  86. user may not be able to log on as themselves, but they can log on as a guest
  87. with limited access and at least get to cc:MAIL to send a message. For those
  88. LAN Administrators that are wreckless and very trusting of their users you can
  89. also set a permission of ANY USER FOR ANY ID. This allows ANY cc:MAIL user to
  90. RESET ANY LAN Password. This is not recommended, but I knew if I didn't
  91. include it that someone would ask for it!!
  92.  
  93.  
  94. User Configuration:
  95. The Users page is also very straight forward. It is a container with several
  96. columns. If you allow any USER to reset ANY ID then KL-LSPW does not even
  97. look at this USER list.
  98.  
  99. The first column is NAME. This is not used for anything other than a
  100. method of sorting and viewing the users in KL-LSPW. This NAME does NOT have to
  101. be their cc:MAIL or LAN ID since it is NOT used for anything other than to
  102. allow you to display and sort names in a format you desire. Since this column
  103. is sorted it is advisable to list users in LAST NAME then first name.
  104. The nect column is the cc:MAIL ID. This is the cc:MAIL ID that KL-LSPW will
  105. use as validation before resetting any passwords. LAN ID is the LAN Server ID
  106. that corresponds to the User defined. This field is only used to validate
  107. permissions of ANY USER OWN ID ONLY. This is how KL-LSPW determines if the
  108. requested ID to be reset is truly the users own ID. ADMIN is whether or not
  109. this cc:MAIL ID is a PASSWORD Administrator. This does NOT mean they are a LAN
  110. Server administrator, only that you allow this cc:MAIL ID to reset ANY LAN
  111. Password.
  112.  
  113. ID that you have listed on this screen can be directly edited by holding ALT
  114. and then clicking mouse button 1 (usually the left button) once. You will see
  115. that the field is now in direct edit mode. Again NO VALIDATION is doen, it is
  116. up to you to make sure you enter VAILD DATA! The ADMIN field will allow you to
  117. enter anything you want, but KL-LSPW look for a single letter Y. If when you
  118. save the configuration a ADMIN field contains something other than a Y (upper
  119. or lower case) then it will be set to a N for non-ADMIN authority.
  120.  
  121. WRITE User List will prompt you for a file name and will then dump a list of
  122. all the users you have defined to KL-LSPW in a ~ delimited file. The fields in
  123. the file correspond to the fields in the USERS container.
  124.  
  125. READ User List will prompt you for the file to read in and ask you if you want
  126. to delte the current users first. The file is in the same ~ delimted format
  127. that the WRITE USER List option creates. LAN ID and ADMIN fields will
  128. automatically be converted to upper case.
  129.  
  130.  
  131.  
  132. DOMAIN Configuration:
  133. If you only need to have LSPW reset ids on a single domain or only on the default
  134. domain then do NOT add any items to the DOMAIN page. If you want KL-LSPW to attempt
  135. to RESET passwords on multiple domains then select ADD DOMAIN and add the 
  136. DOMAIN Controller's MACHINE NAME and a comment (i.e. \\DCNAME). You MUST include the
  137. begining double slash or the process will error out. If the user ID does not exist on
  138. one of the domains you list then you will get an error, but it is an informational error.
  139. It will still continue processing and return a message with the status of the password
  140. reset for each domain.
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147. To save changes you simply ALT-F4 or couble click in upper left box to close.
  148. You will be asked if you want to save the changes. Changes do NOT become
  149. effective until you SAVE the changes!
  150.  
  151.  
  152. The SHAREWARE version has the following limitations:
  153.  
  154.     - WRITE & READ USER Lists disabled
  155.     - No LOG file support
  156.     - Start Minimized is disabled
  157.     - Check Interval is FIXED at 120 regardless of what you set it to
  158.     - Maximum of 2 USERS can be defined
  159.  
  160.  
  161. Registration:
  162.  
  163.  
  164. KL-LSPW can be registered for $50.  The registration is also good for 
  165. any other PHANTASM Software Commercial products. I will be releasing 
  166. several other cc:MAIL and LAN products over the next few months and 
  167. those products (commercial class) are a seperate line from
  168. my consumer oriented line (KL-ZIP, KLBENCH, Schedule-IT!)
  169.  
  170. If you already have an ID for the consumer line it will be recognized
  171. as valid for the commercial line until 1/1/96.
  172.  
  173.  
  174.  
  175. LICENSE
  176.  
  177. This software is shareware and may be used for 30 days after which you must
  178. stop using it unless you register it. Registration entitiles you to have only
  179. one copy of this program running at any time. You may install this software
  180. on as many systems as you like as long as only one copy is running!!
  181. If you run more than one copy on a single system you need to license 
  182. EACH RUNNING COPY!
  183. Unlimited corporate licenses start as low as $500 for single release and
  184. $1000 for all future releases. Volume discounts for 5 or more copies are 
  185. negotiagted individually and start as low as $100.
  186.  
  187.  
  188. To contact me it is best to leave me, Keith Luken, messages on 
  189. OS/2 Shareware BBS or you may fax me at 770-977-2263.
  190. I generally check my Compuserve ID (75627,563) 3-4 times a week so this is the
  191. best way to get me fast!
  192.  
  193. To register send check or money order to:
  194.  
  195. Keith Luken
  196. 3930 Shoemaker Court
  197. Marietta, Georgia   30062
  198.  
  199. I generally only process registrations every 10-14 days so if you
  200. want you ID number faster include a FAX number and I will fax your
  201. registration to you.
  202.  
  203. If you have a COMPUSERVE ID you may register this application online by
  204. entering: GO SWREG   and then the REGISTRATION ID for KL-LSPW is:
  205.  
  206.  
  207. My Compuserve ID is: Keith Luken 75627,563
  208.  
  209. Once you register online I receive a message. I generally check in with CIS
  210. 2-3 times a week. Once I receive notification of your registrarion
  211. I will send you MAIL on COMPUSERVE with your registration number!
  212.  
  213.  
  214.  
  215. Release History:
  216.  
  217.  
  218. 0.90 08/95
  219. -------------
  220. - Released inital beta version.
  221.  
  222. 0.92 08/08/95
  223. -------------
  224. - Minor restructuring of timer code
  225.  
  226. 0.95 08/09/95
  227. -------------
  228. - Fixed bug when adding users app would terminate
  229.  
  230. 1.00 08/13/95
  231. -------------
  232. - Released initial version
  233.  
  234.  
  235. 1.01 08/31/95
  236. -------------
  237. - Refreshed readme to provide some additional details. 
  238.   Added Silent mode to remove chime when processing!
  239.  
  240.  
  241. 1.10 09/19/95 
  242. -------------
  243. - Fixed error if a user sent message to reset own ID.
  244. - Lowered minimum interval to 2 min. But inital will still be at 
  245.   least 5-10 min. to allow for boot process and requester to finish.
  246. - Added multiple DOMAIN support. See text above for operation.
  247.   (I need feedback on this to make sure it works well, I do not
  248.     have access to a multiple-Domain environment for testing)
  249. - Added "Single Run Immediate" MODE! If you pass a command line argument
  250.   of IMMEDIATE then approximately 20-30 seconds after starting KL-DIR will
  251.   check the mail ID and process any pending actions and EXIT when complete.
  252.   This allows you to use an external utility (i.e. Schedule-IT!) to schedule
  253.   when you process requests!
  254.  
  255.  
  256. 1.11 09/20/95
  257. -------------
  258. - Added option to have RESET password set to EXPIRED immediately. This prevents
  259.   users from abusing the reset function. The RESET function used essentially
  260.   resets the USER ID's PASSWORD history and resets any expiration counter. By
  261.   having it EXPIRE immediately you force the user to pick a new password
  262.   right away!!
  263.  
  264.  
  265. 1.12 10/16/95
  266. -------------
  267. - Adjusted immediate mode to spin-off within 5 seconds of program startup.
  268.  
  269. 1.15 11/01/95
  270. -------------
  271. - Minor changes. Removed split bar from containers. Doc changes.
  272.  
  273. 1.16 12/25/95
  274. -------------
  275. - Fixed a problem with all KL-DIR, KL-LSPW and KL-VIRUS that was casuing
  276.   each run to reload some .DLL files that was casuing a memory lock after
  277.   repeated runs without a reboot.
  278.  
  279. 1.17 1/17/96
  280. -------------
  281. - Recompiled with new version of software
  282.  
  283. 1.18 1/19/96
  284. -------------
  285. - Software no longer changes password on default domain! This was done to
  286.   prevent KL-LSPW from changing passwords on a WARP Connect system that was
  287.   may not have been logged on the LAN properly and would then change 
  288.   passwords on the PEER system instead.
  289.  
  290. 1.19 1/31/96
  291. -------------
  292. - Fixed cosmetic bug where log and returned message did not properly process
  293.   the configured domains
  294.  
  295.