home *** CD-ROM | disk | FTP | other *** search
/ PC-Online 1998 February / PCOnline_02_1998.iso / filesbbs / os2 / pgpmr102.arj / PGPMR2.ZIP / PGPMR2.INF (.txt) < prev    next >
OS/2 Help File  |  1996-08-14  |  21KB  |  582 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4. Welcome to PGP for MR/2 ICE!!!
  5.  
  6. This is just a little GUI program to interface PGP & MR/2 ICE.
  7.  
  8. As of right now it is FREE!!! But of course the best things in life are free.
  9.  
  10. The best beer is free, the best food is free, the best women are free and the 
  11. best PGP front end is free.
  12.  
  13. I may at some time in the future ask for some small contribution nothing major 
  14. just your first born & a sworn statement that you will vote for me when I run 
  15. for the position of dictator of the world (look out Bill Gates I want that job 
  16. too.) ROTFL.
  17.  
  18. <sigh> For those of you that did not find the above paragraph funny call a cop 
  19. because someone has stolen you sense of humor. :)
  20.  
  21. I may need to change the name of the program sometime in the future. I am 
  22. currently corresponding with ViaCrypt (now owned by Phil Zimmerman) as far as 
  23. the trademark restrictions regarding the use of PGP.
  24.  
  25. Enjoy the program and don't mind this help file. It's a prime example of why 
  26. you should not write helpfiles after a six pack or two.
  27.  
  28.  
  29. ΓòÉΓòÉΓòÉ 1.1. Copyright ΓòÉΓòÉΓòÉ
  30.  
  31. Well let's see. Hmmmm.... Where to start??
  32.  
  33. PGP is copyrighted by Phil Zimmerman and may be trademarked. Basically it's his 
  34. program. I make no claims to the program PGP, the name PGP. The use of the name 
  35. PGP is strictly for information purposes. This program is merely an interface 
  36. between MR/2 ICE. & PGP. No cryptology code is contained in this program & no 
  37. code from PGP or MR/2 ICE.
  38.  
  39. MR/2 & MR/2 ICE are the intellectual property of Nick Night. I would imagine 
  40. that his program is also copyrighted & trademarked.
  41.  
  42. OS/2 & Rexx are IBM's which are copyrighted & trademarks of International 
  43. Business Machines, blah, blah, blah.
  44.  
  45. Dr. Dialog is copyrighted by IBM & written by David C. Morrill. Nice program 
  46. just wish he hadn't given up on it. :(
  47.  
  48. PGPMR2 & PGP for MR/2 are mine. It's my code so don't steel it!! You are not 
  49. allowed to use any of this in your program in any way shape or form without the 
  50. explicit WRITTEN consent of the author (That's ME).
  51.  
  52. You may use this program unaltered for it's intended purpose as a GUI interface 
  53. for PGP & MR/2 ICE. Any other use is a violation of the copyright. So there :P.
  54.  
  55. This program is presented as is. Period, nothing else to say. If you don't like 
  56. it don't use it. I do not guarantee that it will work as described on your 
  57. system. Hell it may just randomly zap your hard drive. That's the chance you 
  58. take when you don't write your own programs.
  59.  
  60. Well now that I have gotten all that out of the way enjoy the program.
  61.  
  62. P.S. any lawyers that wish to write a copyright notice "pro-bono" fell free to 
  63. do so. Since I'm not charging anything for the program the above notice will 
  64. have to do. :)
  65.  
  66.  
  67. ΓòÉΓòÉΓòÉ 1.2. What is PGPMR2 ΓòÉΓòÉΓòÉ
  68.  
  69. What is PGPMR2?
  70.  
  71. PGPMR2 is a GUI ( Graphical User Interface ) to aide in the use of PGP with 
  72. MR/2 ICE.
  73.  
  74. Basically it makes it easier to encrypt & decrypt your e-mail messages while 
  75. using MR/2 ICE.
  76.  
  77. The program does not do any of the cryptology work itself that's left to PGP.
  78.  
  79. The program does not send or retrieve e-mail that's left to MR/2 ICE.
  80.  
  81. This program does try to make it easier to use the two programs together.
  82.  
  83. It is assumed that you know how to use PGP & MR/2 ICE. If not then go RTFM.
  84.  
  85.  
  86. ΓòÉΓòÉΓòÉ 1.3. How Does it do it ΓòÉΓòÉΓòÉ
  87.  
  88. PGPMR2 is written using a program called DR. Dialog which is similar to Vx-Rexx 
  89. or Gpf-Rexx or Visipro/Rexx which allow you to create pretty GUI windows for 
  90. your rexx code.
  91.  
  92. All the underlining code is Rexx. The rexx code is attached to "events".
  93.  
  94. An event can be may things:
  95.  
  96.      - The user hits a key 
  97.      - The user selects an option from a list 
  98.      - The user clicks on a check box 
  99.  
  100. You get the general idea.
  101.  
  102. PGPMR2 let's you select what you want to do with your message and creates the 
  103. PGP command to do it for you. I hope I have designed the GUI to be as straight 
  104. forward as possible so that you wouldn't have to spend many of time looking at 
  105. this help file.
  106.  
  107.  
  108. ΓòÉΓòÉΓòÉ 1.4. Who am I ΓòÉΓòÉΓòÉ
  109.  
  110.  
  111. ΓòÉΓòÉΓòÉ 2. Getting Started ΓòÉΓòÉΓòÉ
  112.  
  113. PGPMR2 is divided into 3 windows.
  114.  
  115. Your Main window where you will do most of your work.
  116.  
  117. Your Settings Window where you tell PGPMR2 the location of PGP & your keyrings.
  118.  
  119. Your Message Window where you can view the message you are working with.
  120.  
  121. The first time you start PGPMR2 a welcome window will pop-up. You can see this 
  122. window any time by selecting the Info menu option. Then the Settings window 
  123. will be displayed. There will be spaces to enter your PGP directory and the 
  124. file names of your Public & Private Keyrings.
  125.  
  126. After that you will be in the main window and ready to use PGP.
  127.  
  128.  
  129.  
  130. ΓòÉΓòÉΓòÉ 3. Main Dialog ΓòÉΓòÉΓòÉ
  131.  
  132. The Main Dialog Window is divided into several sections:
  133.  
  134. Private Key List:
  135.  
  136.   A list box that displays all of the Private Keys in your Private Keyring.
  137.  
  138. Public Key List:
  139.  
  140.   A list box that displays all of the Public Keys in your Public Keyring.
  141.  
  142. Message Info:
  143.  
  144.   Two lines above the Private Key List display the From: & To: address of the 
  145. message you are working with. The Subject of the message is displayed in the 
  146. window header.
  147.  
  148. Hint Box:
  149.  
  150.   One line in between the window header & the message info lines. This box 
  151. provides "hints" on the different options in the main window. The text in this 
  152. box will change depending on the location of your mouse cursor in the main 
  153. window. 
  154.  
  155. Encryption Options:
  156.  
  157. This is a group of 4 check boxes and one push button that let you select your 
  158. PGP encryption options. After checking your boxes and selecting your keys push 
  159. the Encryption button to encrypt your message.
  160.  
  161.  
  162. Decryption Options:
  163.  
  164. This is a group of 5 check boxes and one push button that lets you select your 
  165. PGP decryption options. After checking your boxes push the Encryption button to 
  166. decrypt your message.
  167.  
  168. Message Push Button:
  169.  
  170. This button will display the Message window. This window will display the 
  171. message you are working with in it's current form.
  172.  
  173. Quit Push Button 
  174.  
  175. This button will save your message in it's current form and return you to MR/2 ICE.
  176.  
  177. Menu Options:
  178.  
  179. There are only two menu options active at this time: Settings & Info.
  180.  
  181. Settings option will display the Settings window.
  182.  
  183. Info option will display the Welcome window.
  184.  
  185.  
  186. ΓòÉΓòÉΓòÉ 3.1. Public Keys ΓòÉΓòÉΓòÉ
  187.  
  188. This list box will let you select multiple public keys from your public key ring.
  189.  
  190. When you first start the program several keys may be selected. PGPMR2 looks at 
  191. the To:,Cc:,and Bcc: lines in your message header and tries to match all the 
  192. addresses to public keys. If PGPMR2 can not match all the addresses to public 
  193. keys a pop-up warning message will be displayed informing you that these keys 
  194. can not be found.
  195.  
  196. There are some limitations to this. If you are sending messages to a list it is 
  197. not likely that you will have a key for the list. Also if you are sending a 
  198. message to a group address PGPMR2 will not look for the addresses associated 
  199. with that group.
  200.  
  201. Before PGPMR2 will encrypt any messages you must have at least 1 public key selected.
  202.  
  203. To select all keys click on a key & then press [ctrl] & [/] at the same time. 
  204. To deselect all keys press [ctrl] & [\].
  205.  
  206.  
  207. ΓòÉΓòÉΓòÉ 3.2. Private Keys ΓòÉΓòÉΓòÉ
  208.  
  209. This list box let's you select one private key from you private key ring.
  210.  
  211. This key is used for signing messages only.
  212.  
  213. It will not be added to any message and is not used for decrypting messages.
  214.  
  215. The private key used for decrypting messages is determined by PGP at the time 
  216. of decryption.
  217.  
  218. PGPMR2 will not sign any messages unless a private key has been selected.
  219.  
  220.  
  221. ΓòÉΓòÉΓòÉ 3.3. Message Info ΓòÉΓòÉΓòÉ
  222.  
  223.  
  224. ΓòÉΓòÉΓòÉ 3.4. Encryption ΓòÉΓòÉΓòÉ
  225.  
  226. This group of check boxes & push buttons determine what encryption actions PGP 
  227. will perform on your message.
  228.  
  229.  
  230. ΓòÉΓòÉΓòÉ 3.4.1. Check Boxes ΓòÉΓòÉΓòÉ
  231.  
  232. There are 4 check boxes for encryption.
  233.  
  234.    - Encrypt 
  235.    - Sign 
  236.    - Add Key(s)
  237.    - Her Eyes Only 
  238.  
  239.  
  240. ΓòÉΓòÉΓòÉ 3.4.1.1. Encrypt ΓòÉΓòÉΓòÉ
  241.  
  242. This check box option tells PGPMR2 to use the -eat option to encrypt your message.
  243.  
  244. PGP will encrypt the message with all the public keys selected.
  245.  
  246.  
  247. ΓòÉΓòÉΓòÉ 3.4.1.2. Sign ΓòÉΓòÉΓòÉ
  248.  
  249. This check box option tells PGPMR2 to use the -sat option to clear sign your message.
  250.  
  251. PGP will sign the message with the private selected.
  252.  
  253.  
  254. ΓòÉΓòÉΓòÉ 3.4.1.3. Add Key(s) ΓòÉΓòÉΓòÉ
  255.  
  256. This check box option will tell PGPMR2 to use the -kxa option to extract the 
  257. selected public keys. It will then append these keys to the end of your message.
  258.  
  259.  
  260. ΓòÉΓòÉΓòÉ 3.4.1.4. Her Eyes Only ΓòÉΓòÉΓòÉ
  261.  
  262. This check box option adds the -m option when encrypting & signing messages.
  263.  
  264. Note:  the -m option prevents the decrypted message from being saved on the 
  265. receiver's machine. When the receiver decrypts the message it is displayed to 
  266. his screen rather than being saved to a file.
  267.  
  268.  
  269. ΓòÉΓòÉΓòÉ 3.4.2. Encrypt Push Button ΓòÉΓòÉΓòÉ
  270.  
  271. When the Encrypt button is pushed PGPMR2 looks at the selected check boxes & 
  272. selected key and calls PGP to process the message.
  273.  
  274. Messages are processed in the following order:
  275.  
  276.    -Add keys first.
  277.    -Clearsign messages second.
  278.    -Encrypt message third.
  279.  
  280.  
  281. ΓòÉΓòÉΓòÉ 3.5. Decryption ΓòÉΓòÉΓòÉ
  282.  
  283. This Group of checkboxes & push buttons determine what decryption actions PGP 
  284. will perform on your message.
  285.  
  286.  
  287. ΓòÉΓòÉΓòÉ 3.5.1. Check Boxes ΓòÉΓòÉΓòÉ
  288.  
  289. There are 5 check boxes for decryption.
  290.  
  291.    - Decrypt 
  292.    - Verify 
  293.    - Sig Remove 
  294.    - Add Key(s)
  295.    - Display to Screen 
  296.  
  297. These checkboxes will automatically be checked for you depending on the message.
  298.  
  299. As an example; a message that is signed & contains a public key PGPMR2 will 
  300. automatically check the Verify & 
  301. Add Key(s) check boxes for you.
  302.  
  303.  
  304. ΓòÉΓòÉΓòÉ 3.5.1.1. Decrypt ΓòÉΓòÉΓòÉ
  305.  
  306. This check box tells PGPMR2 to decrypt the encrypted message.
  307.  
  308.  
  309. ΓòÉΓòÉΓòÉ 3.5.1.2. Verify ΓòÉΓòÉΓòÉ
  310.  
  311. This option tells PGPMR2 to verify the PGP signature for the message.
  312.  
  313.  
  314. ΓòÉΓòÉΓòÉ 3.5.1.3. Sig Remove ΓòÉΓòÉΓòÉ
  315.  
  316. This option tells PGPMR2 to remove the signature from the message. If this 
  317. option is selected the verify option is also selected.
  318.  
  319.  
  320. ΓòÉΓòÉΓòÉ 3.5.1.4. Add Key(s) ΓòÉΓòÉΓòÉ
  321.  
  322. This option tells PGPMR2 to add any keys in your message to your public keyring 
  323. using the -ka option of PGP.
  324.  
  325.  
  326. ΓòÉΓòÉΓòÉ 3.5.1.5. Display to Screen ΓòÉΓòÉΓòÉ
  327.  
  328. This checkbox tells PGPMR2 to display your decrypted message to the screen only 
  329. using the -m PGP option.
  330.  
  331.  
  332. ΓòÉΓòÉΓòÉ 3.5.2. Decrypt Push Button ΓòÉΓòÉΓòÉ
  333.  
  334. When the Decrypt button is pushed PGPMR2 looks at the selected check boxes and 
  335. calls PGP to process the message.
  336.  
  337. Messages are processed in the following order:
  338.  
  339.    - Decrypt Message.
  340.    - Verify Signature.
  341.    - Remove Signature.
  342.    - Add Keys to public keyring.
  343.  
  344.  
  345. ΓòÉΓòÉΓòÉ 3.6. Current Push Button ΓòÉΓòÉΓòÉ
  346.  
  347. This push button will display your message with any changes you have made while 
  348. running PGPMR2.
  349.  
  350. The message dialog is read only. To change the text of your message you must 
  351. quit the program and edit it using the MR/2 ICE editor.
  352.  
  353. CAUTION:
  354. Do Not change the text of your message after signing it. If after signing a 
  355. message you need to change the text use the remove signature option then edit 
  356. the text then resign the message.
  357.  
  358.  
  359. ΓòÉΓòÉΓòÉ 3.7. Original Push Button ΓòÉΓòÉΓòÉ
  360.  
  361. This push button displays your message as it was before PGPMR2 was called.
  362.  
  363.  
  364. ΓòÉΓòÉΓòÉ 3.8. Quit Push Button ΓòÉΓòÉΓòÉ
  365.  
  366. This push button lets you return to MR/2 ICE without saving any changes made by PGPMR2.
  367.  
  368.  
  369. ΓòÉΓòÉΓòÉ 3.9. Save Push Button ΓòÉΓòÉΓòÉ
  370.  
  371. This push button returns you to MR/2 ICE saving all changes made using PGPMR2.
  372.  
  373.  
  374. ΓòÉΓòÉΓòÉ 3.10. Menu Options ΓòÉΓòÉΓòÉ
  375.  
  376.  
  377. ΓòÉΓòÉΓòÉ 3.10.1. File ΓòÉΓòÉΓòÉ
  378.  
  379. This menu option is not implemented at this time.
  380.  
  381.  
  382. ΓòÉΓòÉΓòÉ 3.10.2. Keys ΓòÉΓòÉΓòÉ
  383.  
  384. This Menu option is not implemented at this time.
  385.  
  386.  
  387. ΓòÉΓòÉΓòÉ 3.10.3. Settings ΓòÉΓòÉΓòÉ
  388.  
  389. This option displays the settings window.
  390.  
  391.  
  392. ΓòÉΓòÉΓòÉ 3.10.4. Info ΓòÉΓòÉΓòÉ
  393.  
  394. This menu option displays the pop-up program info message that was displayed 
  395. the first time the program was run.
  396.  
  397.  
  398. ΓòÉΓòÉΓòÉ 3.10.5. Help ΓòÉΓòÉΓòÉ
  399.  
  400. This menu option displays this help file PGPMR2.INF
  401.  
  402.  
  403. ΓòÉΓòÉΓòÉ 4. Settings Dialog ΓòÉΓòÉΓòÉ
  404.  
  405. The settings dialog is used to tell PGPMR2 where your PGP directory is located, 
  406. the names of your Public & Private keyrings, and the default settings of your 
  407. encryption check boxes. 
  408.  
  409. At current PGPMR2 only supports 1 public keyring & 1 private keyring. These 
  410. keyrings MUST be located in your PGP directory.
  411.  
  412. In future releases (warning potential vaporware promise) PGPMR2 will support 
  413. multiple keyrings in any location.
  414.  
  415.  
  416. ΓòÉΓòÉΓòÉ 5. Info Dialog ΓòÉΓòÉΓòÉ
  417.  
  418. This is a simple pop-up window that gives you the version number of PGPMR2. 
  419. That's it just a pretty little window that really doesn't do anything. It did 
  420. give me a chance to play with some dialog controls that I couldn't find an 
  421. excuse to put anywhere else. :)
  422.  
  423.  
  424. ΓòÉΓòÉΓòÉ 6. Warning Dialog ΓòÉΓòÉΓòÉ
  425.  
  426. This pop-up window will appear if PGPMR2 is started and it cannot match all the 
  427. addresses in your To:, Cc:, & Bcc: fields to keys in your public keyring.
  428.  
  429. This does not mean you don't have the keys you need. If the address you are 
  430. sending to does not match the address in the userid field of the key PGPMR2 has 
  431. no way of finding it. Just select it manually.
  432.  
  433. If you are sending to a list it is unlikely that you will have all the keys for 
  434. that list & it would be poor etiquette to send encrypted messages to it.
  435.  
  436. Currently PGPMR2 will not resolve Group addresses to their individual e-mail 
  437. addresses. I plan on adding this in a future release ( warning: another 
  438. potential vaporware promise <G>).
  439.  
  440. There is nothing in PGP that forces the user to use his e-mail address as his 
  441. user id for his key. It makes it easier but is not required. 
  442.  
  443.  
  444. ΓòÉΓòÉΓòÉ 7. Misc. Notes From the Author ΓòÉΓòÉΓòÉ
  445.  
  446. Well, I actually got through all this typing.
  447.  
  448. I think I have more lines in this help file than I do in source code. :)
  449.  
  450. Below is a list of options I would like to add to my program sometime in the 
  451. future: 
  452.  
  453.   - Multiple Keyring support 
  454.   - MIME comparable 
  455.   - Group Address Support 
  456.   - Multi Language Support 
  457.  
  458. Here are some things I am researching but don't know where they will lead:
  459.  
  460.   - Alternative encryption methods 
  461.  
  462.   - Steganography: (the hiding of data in graphics & sound  files).
  463.  
  464. I hope that you find the program of use.
  465.  
  466. Oh almost forgot the plug for my company. :)
  467.  
  468. I am the sole proprietor of Geiger Consulting.
  469.  
  470. I specialize in Data Processing & Telecommunications work.
  471.  
  472. I have the following areas of interest but am not limited to these:
  473.  
  474.    - OS/2, & IBM Lanserver platforms ( who knew? ) 
  475.  
  476.    - Internet application & development & ISP setup & design.
  477.  
  478.    - Medical Management.
  479.  
  480.    - Just about anything else to make a buck. :)
  481.  
  482. My web site is http://www.amaranth.com/~whgiii
  483.  
  484. E-Mail: whgiii@amaranth.com
  485.  
  486.  
  487. ΓòÉΓòÉΓòÉ 7.1. PGP ΓòÉΓòÉΓòÉ
  488.  
  489. Sorry I don't have the time to do these last two pages. :(
  490.  
  491. I will come out with an update to this help file and I will use these last two 
  492. pages to discuss PGP, Data Encryption, and Data Security issues.
  493.  
  494. If you are looking for info on PGP the best place to go is alt.security.pgp. I 
  495. post regularly there. I am also on #os/2 now and then when I have time usually 
  496. late at night (I am located in the US Central Time Zone +0500 during daylight savings)
  497.  
  498. When I get the time I will be creating a separate PGP page on my web site. With 
  499. PGP info & links to other sites.
  500.  
  501.  
  502. ΓòÉΓòÉΓòÉ 7.2. Security ΓòÉΓòÉΓòÉ
  503.  
  504.  
  505. ΓòÉΓòÉΓòÉ 8. Changes in PGPMR2 v. 1.01 ΓòÉΓòÉΓòÉ
  506.  
  507. The following changes have been made in version 1.01
  508.  
  509. Better public key handling.
  510. ======================
  511.  
  512. PGPMR2 was choking on some public keys most noted 
  513. was the handling of revoked keys. FIXED 
  514.  
  515. Gray Screen with 4OS2.
  516. ===================
  517.  
  518. After calling PGP PGPMR2 would be displayed with a blank gray screen when 
  519. running 4OS2. FIXED 
  520.  
  521. Querkus Rexx.
  522. ============
  523.  
  524. There were some syntax incomparability between Querkus Rexx & Standard Rexx. 
  525. FIXED 
  526.  
  527.  
  528. Known Bugs - Fixes in progress 
  529. ==========================
  530.  
  531. Sys3175 
  532. =======
  533.  
  534. Problem:  This error message appears after running PGPMR2 for the first time & 
  535. then closing the program. 
  536.  
  537. Fix:  Just call PGPMR2 again. You should not see this error message again after 
  538. the first time PGPMR2 is run.  You may have to shutdown MR/2 ICE and restart 
  539. then call PGPMR2.
  540.  
  541. I am working on a "true" Install routine that will eliminate this problem.
  542.  
  543. No Keys Displayed 
  544. ===============
  545.  
  546. Problem:  Public &/or Private keys not being displayed in PGPMR2.
  547.  
  548. Ensure that you have the correct drive & path for PGP in your settings window.
  549.  
  550. Only enter the file name for your Public & Private Keyrings.
  551.  
  552. Public & Private Keyrings MUST be located in your PGP Directory.
  553.  
  554. Make sure that you have the proper PGPPATH settings in your Config.sys file.
  555.  
  556.  
  557. MIME 
  558. ====
  559.  
  560. Problem: MIME attachments not properly displayed after signing message.
  561.  
  562. Solution: On messages you plan on signing/encrypting do not use MIME Attachments.
  563.  
  564. I am working on a fix for this with Nick. I hope to have a fully MIME 
  565. compatible version out soon after Nick's next release. (I hope). :)
  566.  
  567.  
  568. If you are experiencing any problems not in this list please let me know ASAP. 
  569. I am hard at work to squash these bugs while adding more features with added usability.
  570.  
  571.  
  572. ΓòÉΓòÉΓòÉ 9. Changes in PGPMR2 v. 1.02 ΓòÉΓòÉΓòÉ
  573.  
  574. Changes in version 1.02
  575. ===================
  576.  
  577. Only one "bug" fix in version 1.02.
  578.  
  579. In version 1.01 I had introduced a bug that caused the PGP window not to be 
  580. displayed when doing more than one PGP operation at the same time. 
  581.  
  582. This has been