home *** CD-ROM | disk | FTP | other *** search
/ Internet Publisher's Toolbox 1.0 / Image.iso / toolbox / pidaho11 / pidaho.txt < prev    next >
Encoding:
Text File  |  1995-01-12  |  10.8 KB  |  287 lines
  1. Private Idaho version 1.1 (January 12, 1995) - Freeware
  2. copyright 1995, Joel McNamara (joelm@eskimo.com)
  3.  
  4. What it does
  5. --------------
  6. Private Idaho makes private e-mail easier.  It simplifies using
  7. PGP and the cypherpunk anonymous remailers.  Although the program
  8. is designed to work with QUALCOMM's freeware Eudora for Windows
  9. (I'm using 1.4.4) e-mail software, it can be used by other Windows
  10. e-mail applications.
  11.  
  12.  
  13. What it doesn't do
  14. --------------------
  15. Private Idaho isn't e-mail software.  It can't send the messages you
  16. create with it.  Think of it as an e-mail premailing tool.
  17.  
  18. Private Idaho doesn't automatically keep track of which remailers
  19. are active.  The list of remailers and USENET gateways included is
  20. current as of January 4, 1995.  You'll need to manually keep the
  21. text file updated to stay current.  To see a list of anonymous 
  22. remailers, finger remailer-list@kiwi.cs.berkeley.edu or via the
  23. Web http://www.cs.berkeley.edu/~raph/remailer-list.html.
  24.  
  25. Private Idaho isn't a PGP shell.  It is just meant to make sending
  26. private e-mail easier.  Don't expect sophisticated key management and
  27. access to all of PGP's features.
  28.  
  29.  
  30. Requirements
  31. --------------
  32. Microsoft Windows 3.x
  33. Visual Basic runtime file (VBRUN300.DLL - not included)
  34. QUALCOMM Eudora for Windows (optional, for the most part)
  35. PGP (Pretty Good Privacy - 2.6.2 is the latest MIT version)
  36.  
  37.  
  38. Installation
  39. --------------
  40. Copy the following files to the directory that contains Eudora:
  41.  
  42. PIDAHO.EXE    the application
  43. CPMAILER.TXT    the cypherpunk remailer list
  44. USENET.TXT    the list of mail to USENET newsgroup gateways
  45. PIDAHO.TXT    this file
  46.  
  47. Copy the following file to the directory (or disk) that contains PGP:
  48.  
  49. PIPGP.PIF    for easy shelling to DOS PGP
  50.  
  51. If you don't use Eudora, copy all of the files to the PGP directory.
  52.  
  53. Add PIDAHO.EXE to a Windows program group of your choice.  You're ready
  54. to go...
  55.  
  56.  
  57. To encrypt a message:
  58. -----------------------
  59. 1. Enter the e-mail address of the person you want to send the
  60.    encrypted message to.  (Since most people will use their e-mail
  61.    address as part of their PGP user ID, Private Idaho will search
  62.    through the public key ring looking for a match.  If it finds
  63.    a match, it will encrypt off of that key.  If it can't find a
  64.    match, user IDs in the public key ring are displayed, and you
  65.    select one.)
  66.  
  67. 2. Compose the message you want to encrypt in the message box.
  68.  
  69. 3. Choose the "Encrypt message" command from the PGP menu.
  70.  
  71. Private Idaho will create a temporary file containing the message,
  72. shell out to PGP and encrypt the file with ASCII armor, copy the
  73. encrypted text to the message box, and delete the temporary file
  74. with the PGP wipe command (yes, wipe only performs a single pass
  75. at overwriting the data before deleting, if you need more security,
  76. try a shareware memory resident app called Real Delete).
  77.  
  78.  
  79. To encrypt and sign a message:
  80. --------------------------------
  81. Same as encrypting a message (only you choose the "Encrypt and sign
  82. message" command from the PGP menu).
  83.  
  84.  
  85. To sign a message:
  86. --------------------
  87. Same steps as encrypting a message (only you choose the "Clear sign
  88. message" command from the PGP menu).  This adds your signature to the 
  89. text contained in the message box.  The text is not encrypted.
  90.  
  91.  
  92. To decrypt a message:
  93. -----------------------
  94. 1. Paste the encrypted message you received to the message box.
  95.  
  96. 2. Choose the "Decrypt message" command from the PGP menu.  You
  97.    will be prompted for your passphrase.
  98.  
  99. Private Idaho will create a temporary file containing the message,
  100. shell out to PGP and decrypt the file, copy the decrypted text to the 
  101. message box, and delete the temporary file with the PGP wipe command. 
  102.  
  103.  
  104. To set PGP options:
  105. ---------------------
  106.  
  107. 1. Choose the "Options..." command from the PGP menu.
  108.  
  109. Not that many options to select really.  Just the PGP path (which is
  110. extracted from the PGPPATH environment variable - which you should
  111. have set if you followed the PGP installation instructions) and
  112. your PGP user ID.  You can use the entire user ID (i.e. Joel McNamara
  113. <joelm@eskimo.com>) or a portion of it.  You are prompted for this
  114. when Private Idaho starts.  Both of these options are stored in the
  115. PIDAHO.INI file (which Private Idaho creates when you first run it).
  116.  
  117.  
  118. To send mail through one anonymous remailer:
  119. ----------------------------------------------
  120.  
  121. 1. Compose the message and specify who you want to send the mail to
  122.    in the To: line.
  123.  
  124. 2. Select a remailer from the Remailer: combo list.
  125.  
  126. 3. Choose the "Append info to message" command from the Remailer menu.
  127.  
  128. The appropriate remailer instructions are added to the contents of the
  129. message box.  The remailer address is passed to Eudora when you choose
  130. the "To Eudora" command from the Transfer menu.  If you don't use Eudora,
  131. you'll need to manually enter this address in your e-mail software.
  132.  
  133.   
  134. To chain a message (send it through multiple remailers):
  135. ----------------------------------------------------------
  136. 1. Follow the same steps as above, but choose "chain" from the Remailer:
  137.    combo list box.
  138.  
  139. 2. A list of remailers is displayed.  Select the ones you wish to chain.
  140.  
  141. 3. Choose the "Append info to message" command from the Remailer menu.
  142.  
  143. The appropriate remailer instructions are added to the contents of the
  144. message box.
  145.  
  146. You might notice that if you chain say 5 remailers, only 4 appear in
  147. the message box.  This is because Private Idaho stores the first
  148. and appends it to the To: line when the information is transferred to
  149. Eudora.  If you're not using Eudora, you can copy the contents of
  150. the message box and paste it into your own e-mail software, but
  151. you'll need to manually enter the first remailer in the To: line.
  152.  
  153.  
  154. To encrypt mail and send it through an anonymous mailer:
  155. ----------------------------------------------------------
  156. 1. Encrypt the message first.
  157.  
  158. 2. Select the appropriate remailer(s) and choose the "Append info to 
  159.    message" command from the Remailer menu.
  160.  
  161. If you don't follow this order, you'll end up encrypting the remailer
  162. instructions.  The remailers are smart, but not that smart.
  163.  
  164.  
  165. To send anonymous mail to a newsgroup:
  166. ----------------------------------------
  167. 1. Select the gateway from the To: combo box.  Edit the gateway
  168.    address by deleting "group.name" and entering the appropriate 
  169.    newsgroup name, i.e. "alt.2600".  (The "Anonymous USENET
  170.    Gateways" item is just a place holder and is not a valid
  171.    address.)
  172.  
  173. 2. Select a remailer (or "chain") from Remailer: list box.
  174.  
  175. 3. Choose the "Append info to message" command from the "Remailer"
  176.    menu.
  177.  
  178. IMPORTANT NOTE: Sending an e-mail message to one of the gateways
  179. will not anonymize the mail.  You must send it through a remailer
  180. first.  Please test by sending mail to someplace like alt.test
  181. before doing it for real.
  182.  
  183.  
  184. To get all of the cool cypherpunk data back into Eudora:
  185. ----------------------------------------------------------
  186. 1. Make sure Eudora is running and the New Message window is
  187.    displayed in front (has focus).  Use the "New Message" command in
  188.    the Message menu.  The cursor should be on the To: line.
  189.  
  190. 2. In the Private Idaho "Transfer" menu, choose the "To Eudora"
  191.    command.
  192.  
  193. This transfers the address information and message contents you entered
  194. in Private Idaho to Eudora.
  195.  
  196. Technically, this is a pretty dumb operation.  It does a series of
  197. Clipboard copies and pastes (with SendKeys) to Eudora.  Poor man's
  198. DDE or OLE.  If you don't have the New Message window open or the
  199. cursor is somewhere other than the To: line, Private Idaho will
  200. happily try to paste the data in whatever Eudora window is active.
  201.  
  202.  
  203. Other stuff
  204. -------------
  205. When you run Private Idaho, the screen will go black, and depending
  206. on how slow your machine is, you may get a brief glimpse of the
  207. PGP DOS screen before the Windows app first appears.  This ugliness 
  208. occurs when Private Idaho shells out to PGP and redirects the contents 
  209. of the public ring to a text file named PUBKEYS.OUT.  Kind of cheesy,
  210. but effective since VB doesn't easily support redirected output from
  211. shelled DOS apps.
  212.  
  213. If you modify the remailers text file, please leave the "none" and
  214. "chain" entries alone.  Private Idaho needs them to work correctly.
  215.  
  216. You'll notice the To: line has a combo box.  If you are using Eudora,
  217. Private Idaho will read the contents from the RCPDBASE.TXT file.  This
  218. is where Eudora stores e-mail addresses you added as a recipient with
  219. the Add as recipient command in the Special menu.  USENET gateways
  220. that support posting to newsgroups are appended to this combo box.
  221. If you're not using Eudora, create a text file named RCPDBASE.TXT
  222. with commonly used mail address (i.e. joelm@eskimo.com) on
  223. each line.  Put this file in the same directory as Private Idaho.
  224.  
  225. Practical limitation of text in the message box, approximately 32K.
  226.  
  227. Total anonymous mailers to list for chaining, 30.
  228.  
  229. Private Idaho currently does not offer any features that work with
  230. remailers that support automatic PGP encryption (where you supply the
  231. public key for the remailer).
  232.  
  233. The name Private Idaho comes from a catchy B-52s song.  No deep social
  234. meaning, just had a nice ring to it.
  235.  
  236. This is a whole lot of text for a pretty simple app, but hey, once
  237. a tech writer, always a tech writer.
  238.  
  239.  
  240. Command summary
  241. -----------------
  242. File
  243.      Exit - just what it sounds like
  244. Edit
  245.      Cut - standard
  246.      Copy - standard
  247.      Paste - standard
  248.      Clear message - clears any text in the message box
  249.      Copy message - copies any text in the message box to the Clipboard
  250.      Paste messages - pastes Clipboard text to the message box
  251. PGP
  252.      Encrypt message - encrypts text in the message box
  253.      Encrypt and sign message - encrypts and signs text in the message box
  254.      Clear sign message - attaches a signature to text in the message box
  255.      Decrypt message - decrypts PGP ciphertext in the message box
  256.      Options - sets PGP path and your user ID
  257. Remailer
  258.      Append info to message - adds remailer info to message box text
  259. Transfer
  260.      To Eudora - transfers data to Eudora new message
  261. Help
  262.      About... - brief info
  263.      Information... - displays this file
  264.  
  265.  
  266. Future versions
  267. -----------------
  268. As mentioned before, Private Idaho is meant to be simple.  I didn't
  269. want to clutter it up.  However, some obvious cypherpunk things 
  270. Private Idaho doesn't support that will likely be added in future 
  271. versions include:
  272.  
  273. Selective remailer chaining order
  274. Cut-marks
  275. Latent-time
  276. ## Headers
  277. Remailer encryption with PGP public keys
  278. User configurable for other Windows e-mail software
  279. "Real" app that doesn't require the VB runtime
  280.  
  281.  
  282. Release history
  283. -----------------
  284. 1/5/95        1.0 release
  285. 1/12/95        1.1 release
  286.             fixed path and .INI problems in load routine
  287.             cosmetic changes to the interface