Cypher ver. 1.0 by John Stiwinter 1995 A simple but effective encryption program.  Disclaimer: ----------- Cypher should not be used where the need is for protection of highly sensitive files. Any first year cryptanalyst can break the encrypted files that Cypher produces. IMO calling this an encryption program is a stretch of the imagination. The source code is included so you may make any modifications you wish. I do this because my government seems to be up in the air (and sometimes nasty) when it comes to exporting encryption devices. Of course my personal copy uses a more sound coding procedure. This is more of an exercise in programing in ACE than anything else, I hope you find it useful or at least fun. Installation: ------------- Copy the following files to a directory of your choice; Cypher Cypher.info Cypher.doc Cypher.doc.info If you choose to modify the source code you will need to use the object module WBarg.o. Both WBarg.o and WBarg.h are included as well as a 'make' script. Many thanks to David Benn for this subprogram library module, it has made it possible for this program to operate in the manner I had hoped for. In short WBarg.o contains the subprograms to handle WB arguments, and WBarg.h provides the external declarations for these subprograms. I would suggest getting the wbarg.lha archive from the ACE ftp site if you wish to understand this in more detail. Usage: ------ Cypher may be invoked from the CLI or WB. When invoked from the CLI a small window will open with a text gadget requesting a key code from the user. This key code is then saved in the file KCS and located in the ENV: directory. Here it will remain until the user re-boots or powers down the computer. This is handy if the program is called during the Startup-Sequence so the user need not enter the key code every time a file is accessed. The program must use a project icon when run from the WB. This icon must also have the default tool set to "Cypher". You may copy and rename the Cypher.info icon, just remember to set the default tool to "Cypher", or you may use one of your own icons. DO NOT SET THE DEFAULT TOOL IN THE ORIGINAL CYPHER ICON. Four tool types must also be set, which are as follows; PROG = String type. Include path & program name. Example - PROG=SYS:Utilities/More (read the file with the program "More") KEY = Boolean type. Set to "YES" or "NO". Example - KEY=YES (open the key code gadget) If set to "NO" then the key code is read from ENV:KCS. If no key code is provided the Cypher will end. QUIET = Boolean type. Set to "YES" or "NO". Example - QUIET=NO (open the window with the encryption gauge) REQUEST = Boolean type. Set to "YES" or "NO". Example - REQUEST=YES (call up file requester) If set to "YES" then a standard file requester is invoked so the user may select file(s) to encrypt. Once "CANCEL" is selected the program will end. This is used to encrypt select files only, the "PROG" tool type will be ignored and the program will end. Operation: ---------- Upon double clicking the file's icon a small window will open and a fuel type gauge will be displayed to show the program's progress. After the file is decrypted the program specified with the "PROG" tooltype will be called to access the file. Upon the completion of the called program Cypher will encrypted the file. The user may set the tooltypes as desired, if you're not into watching gauges, simply set the "QUIET" tooltype to equal "YES", and no window will open. Also if you wish to use a different key code for a specific file just set the "KEY" tooltype to "YES" and the text gadget will open to accept the key code sequence for that file. (This will not alter the key code sequence in ENV:KCS). Notes: ------ It would be highly recommended that you do not forget your key code. If by chance you do and you REALLY need that file don't mess with the file and drop me a line. Tell me the type of file that is encrypted, i.e.. text, program, etc., and I _may_ be able to recover it. But I am not making any promises. An example document is provided for you so you can learn how to set up and use Cypher (see Example.doc). Please follow the directions found in "Example.readme" step by step for this purpose. Regards; John Stiwinter