home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 604b.lha / DABPass_v1.1 / DABPass.doc.pp / DABPass.doc
Encoding:
Text File  |  1992-01-31  |  4.1 KB  |  95 lines
  1. DABPass (V1.1 © DAB) - System Security for the Amiga
  2. --------------------------------------------------
  3.  
  4. Written by DAB - an English Import
  5.  
  6. (D.Bridges) who can be found on :-
  7. Amagination 
  8. Genie 
  9. Compuserve  (but not as often - it's too expensive!)
  10.  
  11. Copyright (the boring bit)
  12. --------------------------
  13.   The source code for this program is copyright by me but the executable is
  14. shareware provided you don't change it without my written permission (who
  15. knows, you could introduce some bugs & I'd get the blame...)
  16.  
  17.  
  18. Philosophy
  19. ----------
  20.   This program is an attempt to provide some form of front-end security
  21. for your Amiga. It was written in the wonderful HiSoft Basic language
  22. (who needs C ?) and developed on an expanded A500.
  23. The program is primarily for use by Scripts (AmigaDos/ARexx). I have
  24. included a fragment of a startup-sequence to show how it can be used.
  25.  
  26. Contents of Archive
  27. -------------------
  28.   The archive should contain the following:-
  29.  
  30.   DABPass           - the Password checker/changer program
  31.   DABSetPass        - the Password setting program.
  32.   startup-example   - example startup-sequence fragment
  33.   PSW               - the Password file (encrypted)
  34.  
  35. How to use DABPass
  36. ------------------
  37.   To use DABPass, the following has to be performed.
  38.  
  39. 1) The files DABPass and PSW Must be copied to the same directory or the
  40.    program won't work.
  41.  
  42. 2) Look at the startup-sequence fragment for an example of how to invoke
  43.    the program and test for the entry of the correct password.
  44.  
  45. 3) When the software has been copied it can be tested either by typing
  46.    DABPass from a CLI command line after CD-ing to the directory, or by
  47.    clicking on the DABPass icon from the workbench.
  48.  
  49. 4) A small window will appear at the top of the screen, prompting for
  50.    a password. The initial password I have set is PASSWORD (it can be
  51.    typed in upper or lower case as DABPass is case insensitive).
  52.  
  53. 5) If the password is entered incorrectly the program will tell you.
  54.    It allows three attempts and on the third incorrect attempt the 
  55.    program will exit. The password entered is compared against the one
  56.    held in the PSW file.
  57.  
  58. 6) If the password has been correctly entered, the program will ask you
  59.    if you wish to change the current password. Type Y or y and press enter
  60.    to change the password, or just press enter if you do not wish to change
  61.    it. If you elected to change the password you will be prompted to enter
  62.    the new version. You will need to enter it twice for confirmation.
  63.    Note: a password cannot be less then 4 characters. The program will
  64.    write the new password to the PSW file, encrypting it in the process.
  65.  
  66. What happens if I forget my password?
  67. -------------------------------------
  68.  
  69.   If you forget your password I have provided another program, DABSetPass,
  70. which will enable you to overwrite the existing password with a new 
  71. password without the chacks made in the DABPass program. This program
  72. looks the same as the change password section of the DABPass program and
  73. can be run from the CLI or just click on its Icon.
  74. Note: this program should be kept on a separate disk from the password
  75. protected one, to prevent 'undesirables' from tinkering with your existing
  76. setup.
  77.  
  78. How does it work?
  79. -----------------
  80.  
  81.   The program works by testing for the existence of the file DABOK in the
  82. RAM: disk. When the DABPass program is run the first thing it does is 
  83. check for the existence of the DABOK file in the RAM: disk. If it is found
  84. it is deleted. The program then prompts for the password, comparing user
  85. input against the password held in the PSW file (having first decrypted it).
  86. If the passwords don't match the user is allowed two more attempts before
  87. the program terminates. If the password has been entered correctly however,
  88. the program creates the DABOK file on the RAM: disk before terminating.
  89. The existence of the file can be tested for by DOS & ARexx scripts (as well
  90. as most other languages) and can thus be used as an indicator of whether or
  91. not to continue - it's simple but it works!
  92.  
  93. If you have any problems/queries please contact me on the BBS's listed at
  94. the beginning of this document. 
  95.