home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / internet / rno30scrpt / ReadMe
PGP Signed Message  |  1994-05-18  |  6KB  |  152 lines
  1. -----BEGIN PGP SIGNED MESSAGE-----
  2.  
  3. The contents of this archive integrate PGP with ReadNews version 0.30.  It is
  4. possible that these scripts will also work with version 0.24, but this has
  5. not been checked.
  6.  
  7. Version 1.2, 18-May-1994.
  8.  
  9.  
  10. This file, the scripts and the BASIC program are copyright © Paul L. Allen,
  11. 1993, 1994 all rights reserved.  You may copy this archive and pass it on
  12. provided that no changes are made, and that you do not charge any money for
  13. doing so.
  14.  
  15.  
  16. Installation
  17. ============
  18.  
  19. Copy the scripts in the Scripts to !Rucp.Userhome.<username>.Scripts,
  20. substituting for <username> as appropriate.  You will have to do this for
  21. all users you wish to have access to PGP, although later versions of
  22. ReadNews may allow the scripts to be installed globally - check the latest
  23. ReadNews documentation.  ReadNews scans the scripts directory when you login
  24. as a particular user, alternatively you can tell ReadNews that the scripts
  25. exist by bringing up the script option from the main menu and clicking on it
  26. (do not follow the arrow if there is one, just click on the script menu
  27. entry) - this causes ReadNews to scan the scripts directory.
  28.  
  29. Copy Library.split_msg to wherever you put the library files that came with
  30. ReadNews (uud, uue and uux).  Normally this would be $.Library, but if you
  31. have more than one drive you may wish to do something clever with Run$Path -
  32. the file PGPhints which comes with the Archimedes PGP distribution gives
  33. more details on this.
  34.  
  35.  
  36. Scripts available
  37. =================
  38.  
  39.     PGPaddkey   Adds the public key in the current article to your public
  40.                 keyring.  This will not work if the whole article has been
  41.                 signed afterwards - you need to PGPdecrypt it first.
  42.     PGPchk-sig  Checks the signature on the current article.
  43.     PGPdecrypt  Decrypts the current article, and appends the cleartext to
  44.                 the end of the article.
  45.     PGPencrypt  Signs and encrypts a message.
  46.     PGPsign     Signs a cleartext message.
  47.     PGPview     Decrypts the current article and shows the original article
  48.                 with corresponding cleartext in an edit window.
  49.  
  50.  
  51. Usage
  52. =====
  53.  
  54. Make sure that !PGP has been seen by the filer before you try and use any
  55. of these scripts, or the script will complain that the !PGP application
  56. has not been seen.
  57.  
  58. Bring up the ReadNews main menu, and you will see a Script entry - follow
  59. the arrow and click on the appropriate entry (this assumes that you have
  60. installed the PGP scripts in the current user's scripts directory).  Note
  61. that PGP is run in a CLI window, so there is no multitasking - this minimizes
  62. the memory requirements for use and speeds up processing.
  63.  
  64. PGPaddkey, PGPchk-sig, PGPdecrypt and PGPview all apply to the current
  65. article - when you select them, the article is processed without further
  66. intervention (other than asking for your passphrase where necessary).
  67.  
  68. PGPencrypt and PGPsign apply to a message that you are about to mail or post
  69. (usually you sign news and either sign or encrypt mail).  Create a message
  70. (mail or news, original or reply) in the normal way.  When you are satisfied
  71. with your message, click on the appropriate script entry.  A dialogue box
  72. will appear: bring up the save box on your edit window and save the message
  73. to the script's dialogue box.  If you're encrypting, you must then enter
  74. the recipient(s) by hand (see below).  Then click on the `OK' button and the
  75. message will be encrypted and sent.
  76.  
  77.  
  78. Notes
  79. =====
  80.  
  81. Temporary files are used for decrypted text, so even though they're
  82. deleted after use, all scripts *including* PGPview will still leave
  83. sensitive data on your disc which may be recoverable with a disc sector
  84. editor until the filing system re-uses the relevant sectors.  You have been
  85. warned.
  86.  
  87. The reason PGPencrypt wants you to enter the recipient(s) yourself is because
  88. mail expects a comma-separated list of recipients and PGP can't cope with
  89. that.  Although it would be possible to take the recipients from the mail
  90. header and convert the format with an external program, there appears to be
  91. no way to pass this information back to the ReadNews script so it can invoke
  92. PGP automatically.  Yes, I know ReadNews scripts can handle environmental
  93. variables, but not if you want to display the contents in a dialogue box
  94. (which is vital so the user can tweak the list if necessary).
  95.  
  96. PGPencrypt now presents a menu for the list of recipients, and allows spaces
  97. in recipient's names without having to quote them - you enter multiple
  98. recipients as follows:
  99.  
  100.     user1@foo.bar.com
  101.     Joe Bloggs
  102.     Fred Bloggs
  103.     user2@fubb.org
  104.  
  105. and the script takes care of putting in the necessary quote marks behind
  106. the scenes and passing the information in a form PGP can handle.
  107.  
  108. PGPdecrypt appends the cleartext to the current article rather than replacing
  109. the encrypted text for a number of reasons:
  110.   1) If something goes wrong, you don't lose the original.
  111.   2) The original may consist of an encrypted portion and an unencrypted
  112.      portion.
  113.   3) You may want to retain the original so you can later prove its validity
  114.      to a third party from the digital signature.
  115.  
  116. PGPencrypt and PGPsign will not complain about !PGP not having been seen
  117. until *after* you click on OK button of the dialogue box - this is due to
  118. an annoying misfeature of the script language.
  119.  
  120.  
  121. Revision History
  122. ================
  123.  
  124. Version 1, 11-Apr-1993
  125.     Initial release.
  126.  
  127. Version 1.1, 05-Mar-1993
  128.     Scripts modified to check if PGPpath variable has been seen, and abort
  129.     with an error message if not - this avoids having PGP fire up only to
  130.     complain that it cannot find the public key file.
  131.  
  132.     Consequential changes to this ReadMe file.
  133.  
  134. Version 1.2, 18-May-1994
  135.     Scripts modified to cope with the new OLE protocol used by ReadNews 0.30
  136.     which broke the earlier versions.  PGPencrypt changed to handle multiple
  137.     recipients via a menu and to accept spaces in recipient names without
  138.     quotation marks.  PGPview now includes the whole of the original article
  139.     in case there are unencrypted portions you wish to examine.
  140.  
  141.     Consequential changes to this ReadMe file.
  142.  
  143. -----BEGIN PGP SIGNATURE-----
  144. Version: 2.3a
  145.  
  146. iQCVAgUBLdpMPGv14aSAK9PNAQEN/AP/R5J1B3I+NfvUydKaEeKLFHJyAGboErKn
  147. GWxpxIdED5HWz5FXFsUBq2+H6B1UyIMuI/nWGcIWD8/tardpqcMu9EEvTlv3oA1b
  148. muutzR6LlIi50cJ0xUjp0PRlUhHHHc8ttplt/j+c6+5tW4UpEawavPWJc/3MzM5B
  149. d1uWm2kz5DM=
  150. =mmem
  151. -----END PGP SIGNATURE-----
  152.