home *** CD-ROM | disk | FTP | other *** search
/ C/C++ User's Journal & Wi…eveloper's Journal Tools / C-C__Users_Journal_and_Windows_Developers_Journal_Tools_1997.iso / unikey / readme.txt < prev    next >
Text File  |  1996-06-19  |  8KB  |  202 lines
  1.                                   ***************
  2.                                 ******************
  3.                                ****INTRODUCTION****
  4.                                 ******************
  5.                                   ***************
  6.  
  7.     Test Drive is a demo version of the UniKey AEGIS system. It has
  8.     similar features to the regular version. The only difference is that 
  9.     demo AEGIS uses a powered printer to emulate the UniKey protection 
  10.     device.
  11.  
  12.     AEGIS is a ready-made encryption and protection package that works in
  13.      combination with special versions of Software Security hardware keys
  14.     to provide complete protection for your software application and
  15.     data files.
  16.  
  17.     There are separate versions of AEGIS to protect DOS and Windows or
  18.      Windows NT applications. The DOS version of AEGIS is called DOS AEGIS,
  19.     the Windows version is called WIN AEGIS, and the NT version is called
  20.     NT AEGIS. Test Drive contains only the WIN AEGIS. The Windows 3.x, 95,
  21.     and NT versions are available with our full Developer's kit.
  22.  
  23.     AEGIS takes the application program that you input and encrypts its
  24.      executable code. Next, it builds a set of secure, application
  25.     specific interrogation routines for your application. Finally, AEGIS
  26.      bundles the interrogation routines together with your encrypted
  27.      executable and creates a new executable file. The new executable is
  28.      enclosed in a highly-secure protective wrapper called a "shell".
  29.  
  30.     The interrogation routines check for the presence of a designated
  31.      hardware key for your application. If the correct key is found, AEGIS
  32.      decrypts your application in memory only and executes the application.
  33.     If no hardware key is found or if the wrong one is attached to the
  34.     user's computer, AEGIS will neither decrypt nor execute your
  35.     application. In the demo version of AEGIS, a printer connected to the 
  36.     the parallel port (on/off) emulates the hardware key (connected/
  37.     disconnected, respectively). 
  38.  
  39.     The following instructions are an overview for using the demo version
  40.     of AEGIS Test Drive. Our full AEGIS documentation is available with the full
  41.     Developer's kit. The file called BOUNCE.EXE has been included in the
  42.     directory \testd\ for you to test with.
  43.  
  44.  
  45.                                 *******************
  46.                                *********************
  47.                               ****RUNNING WIN AEGIS****
  48.                                *********************
  49.                                 *******************
  50.  
  51.     This section contains information and instructions for setting up
  52.      AEGIS protection for your Windows application. At the RUN command
  53.     line, type C:\testd\winaegis.exe and click OK or ENTER assuming
  54.      C: is where Test Drive has been installed.
  55.  
  56.     AEGIS will now begin a series of screen prompts.
  57.  
  58.     NOTE: To exit AEGIS at any time, press ESC. The system will prompt
  59.           you for confirmation.
  60.  
  61.  
  62. ************
  63. *INPUT FILE*
  64. ************
  65.  
  66.     At the INPUT FILE prompt, enter the name of the application you want
  67.      to protect. This must be a .EXE or .COM file, although you do not
  68.     need to enter the extension.
  69.  
  70.     NOTE: be sure to include the path with the filename.
  71.  
  72.  
  73. *********
  74. *OVERLAY*
  75. *********
  76.  
  77.     If you are protecting an application that contains an embedded
  78.     overlay, the system displays the OVERLAY prompt for you to choose
  79.     whether or not to encrypt the overlay part of your code.
  80.  
  81.     Software Security recommends encrypting the overlay, especially if
  82.      your application uses a 386-extender bounded program.
  83.  
  84.     AEGIS decodes the overlay code on the fly at run time.
  85.  
  86.  
  87. *************
  88. *OUTPUT FILE*
  89. *************
  90.  
  91.     At the OUTPUT FILE prompt, enter the new path and file name for the
  92.      protected application. By default the system uses the same extension
  93.      as the original program.
  94.  
  95.     NOTE: Use a name that is not already in the specified directory. The
  96.            system will not overwrite an existing file with the same name.
  97.  
  98.  
  99. **********************
  100. *ENCRYPTED DATA FILES*
  101. **********************
  102.  
  103.     Use this prompt to select the data files you want to encrypt. When
  104.      you encrypt data files, the system decrypts them on the fly at
  105.     runtime. However, you need the Developer's kit to use the encrypted 
  106.     file feature. File encryption is not available in the demo version.
  107.  
  108.           
  109.        FILE TYPES:
  110.     You can encrypt the following types of data files:
  111.  
  112.         Database files
  113.         Parameter files
  114.         Language-specific message files
  115.         External overlay code
  116.  
  117.     NOTE: Completing this prompt does not initiate the data file
  118.           encryption process. You must use a separate program,
  119.           DATENCR.EXE that is described in the full documentation.
  120.           (MANUAL.DOC)
  121.  
  122.  
  123. **********
  124. *MESSAGES*
  125. **********
  126.  
  127.     Use the MESSAGES selection box to select the appropriate language
  128.     for the AEGIS error messages. If your application fails to start,
  129.     the system displays an error message in the language you choose.
  130.     You may also create your own user-defined error message.
  131.  
  132.     Options are: ENGLISH, GERMAN, SPANISH or USER-DEFINED.
  133.  
  134.  
  135. ***********
  136. *SELF-TEST*
  137. ***********
  138.  
  139.     Use the SELF-TEST selection box to indicate whether to include a
  140.      self-test in your application. This test is useful for virus
  141.     detection. It is run each time an end user starts your program.
  142.  
  143.     The self-test uses a checksum to determine whether the application
  144.      code has been modified. If a modification exists, the program
  145.     terminates with an error message.
  146.  
  147.  
  148. **********
  149. *RESIDENT*
  150. **********
  151.  
  152.     Use the RESIDENT selection box to keep a 6K routine resident in
  153.      memory while your application runs to check for the presence of
  154.     the AEGIS UniKey at a regular interval. Selecting "Yes" ensures that
  155.     the application will not continue to run if the AEGIS UniKey is
  156.     removed    from its port. The execution is halted and resumes operation
  157.     when the device is reattached. This prevents users from running your
  158.     application on more than one computer at a time.
  159.  
  160.     The 6K routine is removed from memory when the user terminates your
  161.      application.
  162.  
  163.  
  164. *************
  165. *EXPERT MODE*
  166. *************
  167.  
  168.     You may select  EXPERT MODE to increase security by removing
  169.     instructions from the beginning of your application code and
  170.     inserting them in the shell encryption or by modifying your
  171.     application code. EXPERT MODE is not an option in the demo
  172.     version.
  173.  
  174.  
  175.              *****************************************
  176.            *******************************************
  177.               ****TESTING YOUR APPLICATION'S PROTECTION****
  178.                 *******************************************
  179.                     *****************************************
  180.  
  181.     To test your application, disconnect printer from the parallel port
  182.      on your computer. Next, enter the executable file name that starts
  183.      your application. The computer should issue the message:
  184.  
  185.                    This program requires AEGIS to run **
  186.  
  187.     Reattach the printer and run your application. If you selected
  188.     Resident Mode and the hardware key is removed when the application
  189.     is running, the program halts after the selected time-out period.
  190.     Reattaching the key resumes execution. In Resident Mode, the key
  191.     must be attached at all times for your application to run.
  192.  
  193.     If you did not select Resident Mode, the system will check for the
  194.      hardware key at start up only. In this case, your application will
  195.      continue to run if the hardware key is removed during program
  196.     execution.
  197.  
  198.     REMINDER: The output filename is the protected executable.
  199.  
  200.  
  201.        **NOTE AEGIS IS THE DEFAULT MESSAGE
  202.