home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / misc / crypter / Help
Text File  |  1996-11-10  |  6KB  |  151 lines
  1.                             Help for pgp !crypter
  2.                             
  3.                                     by
  4.                                     
  5.                            Mike Williams (MEWsoft)
  6.                            
  7.                                Sept 22nd 1995
  8.                            
  9.  !Crypter is designed to simplify the task of decrypting, encrypting and
  10.  signing text files primarily for e-mail, using pgp (Pretty Good Privacy).
  11.  
  12.  This application is useless by itself. To make use of it you need an Acorn
  13.  version of pgp. There is an excellent !pgp version (2.6.2i) by Gareth
  14.  McCaughan which is currently available on hensa, or in the mirror on Demon.
  15.  (There is an earlier version of pgp (2.3) which I do not recommend.)
  16.  
  17.  !pgp is in pub/mirror/micros/arch/riscos/a/a304.
  18.  
  19.  There is also a useful front end which simplifies the process of creating and
  20.  handling keys. It is !PGPwimp by Peter Gaunt and can be obtained from Demon
  21.  in the pub/archimedes directory.
  22.  
  23.  Both of the above applications come with full documentation so I assume you
  24.  are reasonably familiar with the principles underlying pgp.
  25.  
  26.  
  27.  Installation:
  28.  ============
  29.  !Crypter is best stored with !pgp because it needs to have seen !pgp so that
  30.  it knows where to find the keys and other files.
  31.  
  32.  
  33.  Running:
  34.  =======
  35.  Running !Crypter installs it on the Icon Bar and opens its main window.
  36.  
  37.  1   To decrypt a document:
  38.  
  39.    a The document to be decrypted can be either a file on disc, or you can 
  40.      drag the save icon from a newsreader such as !TTFN  onto the !Crypter
  41.      Window.
  42.      If the document is indeed encrypted then the decrypt icon on the window
  43.      should be automatically set and the document name inserted into the name
  44.      icon at the bottom.
  45.      Drag the text icon to a directory where you want the decrypted document
  46.      to go. If you keep the same name and drag the icon to the same directory 
  47.      then the decrypted file will overwrite the encrypted file.
  48.      
  49.    b The Task Window opens and pgp displays its messages. This part of the
  50.      proceedings is under the control of pgp and !Crypter is no longer
  51.      involved. Close the Task Window when decryption is complete.
  52.      
  53.  2   To encrypt, or to encryt and sign a document:
  54.  
  55.    a The document to be encrypted must exist as a text file on disc.Typically
  56.      you will have written an e-mail using !Edit or !Zap and now wish to
  57.      encrypt it prior to sending it.
  58.      
  59.    b Drag the file onto the !Crypter Window.
  60.      Select Encrypt or Encrypt and Sign.
  61.      Select the User ID whose public key you have,and to whom you are going to
  62.      send the e-mail (the Target's ID). Either write the ID in the icon or 
  63.      click on the selection button on the right. This uses a file inside the 
  64.      Resources directory inside !Crypter which you can edit yourself.
  65.      
  66.      (Choosing the Full List option on the name menu gives a full listing of
  67.      all of the public keys on your key ring. This list is created each time
  68.      the program runs. If however you add a key while the program is running 
  69.      you will need to exit and restart the program if you wish to use that key
  70.      other than by manually entering the name yourself in the ID icon.)
  71.      
  72.      Drag the text icon to a directory as described in 1.a above.
  73.      
  74.      Proceed as in 1.b
  75.      
  76.  3   To Sign a document without encrypting.
  77.  
  78.    a As 2a above
  79.    
  80.    b Drag the file onto the !Crypter Window.
  81.      Select Sign. 
  82.      Drag the text icon to a directory as described in 1.b above.
  83.      
  84.      Proceed as in 1.b 
  85.      
  86.      The name of the signed file ends with "/S"
  87.  
  88.                                      NOTES
  89.  
  90.   Viewing the output directly
  91.   
  92.   If you wish to view the output from !Crypter without saving it, drag the
  93.   output icon onto a text editor such as !zap. It is best to drag it onto the
  94.   text editor icon on the icon bar. The text can then be read and/or saved
  95.   as required.
  96.   So a typical sequence might be:
  97.     Encounter a PGP encoded e-mail while using !TTFN.
  98.     Save the file (with or without header) directly into !Crypter.
  99.     Drag the !Crypter output onto the !zap icon on the icon bar.
  100.     After pgp does its work the decoded file should appear in a text window.
  101.     
  102.   NB: This process produces some Scrap files inside !Crypter which are deleted
  103.   when !Crypter is exited. If your mail was confidential then you should make
  104.   sure that you do not leave the machine with !Crypter still running.  
  105.   
  106.   
  107.   IDEA only encryption
  108.   
  109.   This option allows you to encrypt a file into a very compact binary file
  110.   using a pass word or pass phrase and not using your keys. It is a usefull
  111.   option if you want to store sensitive information on disc (as long as you
  112.   remember the pass phrase). It is not part of the public key system and is
  113.   not designed for sending e-mail puroposes.
  114.  
  115.  
  116.   Verbose Messages
  117.   
  118.   pgp (until a more Acorn orientated version is produced) opens a task window
  119.   and outputs messages describing its progress. If you have the Verbose
  120.   Message option selected then the messages are indeed a bit wordy. By
  121.   deselecting Verbose you cut the messages down to the essentials. 
  122.   
  123.   
  124.   Automatic Password
  125.   
  126.   You can avoid the tedium of entering your password every time by editing the
  127.   !Run file inside !Crypter.
  128.   
  129.   The line:       |SET PGPPASS "password"      should be amended.
  130.   So if your password is "Bambi Lives" then the line should read
  131.   
  132.   SET PGPPASS "Bambi Lives"
  133.   
  134.   This obviously compromises your security if other people have access to your
  135.   computer. Ways of getting around this are described in the pgp documentation
  136.   along with pgp.
  137.   
  138.   
  139.   
  140.   My thanks to Bob Bayford and to Gareth J. McCaughan for beta-testing and 
  141.   useful suggestions.
  142.   
  143.   
  144.   Mike Williams  (mike@mediajpn.demon.co.uk)
  145.   
  146.   Public Key available from pgp-public-keys@pgp.ox.ac.uk 
  147.   
  148.   
  149.   
  150.   
  151.