/[winpt]/trunk/README
ViewVC logotype

Diff of /trunk/README

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 129 by twoaday, Fri Dec 30 13:56:10 2005 UTC revision 218 by twoaday, Wed May 24 07:53:24 2006 UTC
# Line 1  Line 1 
1                          The Windows Privacy Tray                          WinPT - The Windows Privacy Tray
2                               Version 0.5.5  
                               
                         *** WARNING: this file is obsolete ***  
3    
4  Index  Index
5       1. Notice       1. Note
6       2. Bugs and improvements       2. Bugs and improvements
7         2.1 Legacy Windows versions
8       3. What is WinPT?       3. What is WinPT?
9       4. Install       4. Install
10        4.1 Keyserver config file        4.1 Keyserver config file
# Line 26  Index Line 25  Index
25        13.2.4 Sign        13.2.4 Sign
26        13.2.5 Revoke cert        13.2.5 Revoke cert
27        13.2.6 Check sigs        13.2.6 Check sigs
       13.2.7 List trust path  
28      13.3 Keyserver      13.3 Keyserver
29       13.3.1 Keyserver searching       13.3.1 Keyserver searching
30       13.3.2 Proxy support       13.3.2 Proxy support
31      14. Debug mode      14. Debug mode
     15. Agent support  
32      16. Features of the dialogs      16. Features of the dialogs
33      16. Features of the dialogs      16. Features of the dialogs
34    
35    
36  1. Notice  1. Note
37  ---------  ---------
38    
39  This is only a quick guide for WinPT. For the moment the program is its own  This is only a quick guide for WinPT. For the moment the program is its own
40  documentation. This is subject to change. Please note, this text needs many  documentation. This is subject to change.
 improvements, because English isn't my native lanuage ;-(. Please feel free  
 to send me spelling corrections.  
41    
42    
43  2. Bugs and improvements  2. Bugs and improvements
44  ------------------------  ------------------------
45    
46  I have tried to thoroughly debug this program, but if you've found a bug,  I have tried to thoroughly test this program, but if you've found a bug,
47  please send me a message with a full error description!  please send me a message with a full error description or go directly
48    to http://wald.intevation.org and use the WinPT bug tracking system.
49    
50  Please include as much detail as possible including OS version, WinPT  Please include as much detail as possible including OS version, WinPT
51  version, and GPG version in use. Please summarize your gpg configuration  version, and GPG version in use. Please summarize your gpg configuration
# Line 59  I try to fix bugs as quickly as possible Line 55  I try to fix bugs as quickly as possible
55  http://www.winpt.org  http://www.winpt.org
56    
57    
58    2.1 Legacy Windows versions
59    
60    I know a lot of people still user old versions of WinPT but it is very
61    hard to test the code on all these platforms and thus I decided to
62    obsolete the support for these OS versions: Win95, WinME/98. The code
63    works on 98/ME without known limitations but if you will encounter
64    a serious problem, I doubt I can fix it without having this OS and
65    this is the major problem!
66    
67    
68  3. What is WinPT?  3. What is WinPT?
69  -----------------  -----------------
70    
71  WinPT is a tool to protect your privacy! Because I'm NOT a crypto expert,  WinPT is a front-end for the GNU Privacy Guard. It just provides
72  I use another program, the GNU Privacy Guard for the cryptographic  a convinient interface to GPG while GPG does the actual (cryptographic) work.
 functionality.  
73    
74  GnuPG was written by Werner Koch and is GNU Open Source. GnuPG contains all  GnuPG was written by Werner Koch and is Free Software. GnuPG contains all
75  of the functions WinPT uses for data encrypting and e-signatures and  of the functions WinPT uses for data encrypting, e-signatures and
76  key management.  key management.
77    
78  WinPT is a Windows utility that sits on the taskbar. In the Windows  WinPT is a Windows utility that sits on the taskbar. In the Windows
79  Clipboard, you can encrypt, sign, decrypt and verify data. You can also  Clipboard, you can encrypt, sign, decrypt and verify data. You can also
80  import and export keys to the Clipboard.  import and export keys to the Clipboard.
81    
82  Practically, WinPT is a taskbar front-end for GnuPG. Without GnuPG, WinPT  Practically, WinPT is a taskbar front-end for GnuPG. Without GnuPG, WinPT
83  doesn't work! Currently not all GnuPG functions are supported. Because of  wouldn't work! Currently not all GnuPG functions are supported. With
84  all the new features, WinPT is more then just an universal e-mail plugin.  all its key edit functions and file operations, WinPT is more than just
85  Together with the filemanager and the keymanager, it's like a real GUI.  an universal e-mail plugin. Together with the filemanager and the keymanager,
86    it's like a real graphical GPG user interface.
87    
88    
89  4. Install  4. Install
90  ----------  ----------
91    
92  First you should install the GPG binary into C:\GNUPG (Version 1.0.5 or  First you should install the GPG binary, version 1.4.x or later.
93  later.) (If you want to use a directory other than C:\GNUPG you must modify  (If you want to use a directory other than the default you must modify
94  the preferences in the WinPT program at Preferences->GPG Prefs.  the preferences in the WinPT program at Preferences->GPG Preferences).
   
   
 ** GPG 1.0.5 is needed for WinPT but because of the security problem  
    with this version, it's recommend to use 1.0.6! **  
95    
96  Next, download the WinPT binary package from the Internet. You can find the  Next, download the WinPT binary package from the Internet. You can find the
97  latest WinPT version at http://www.winpt.org/download.html. Create a  latest WinPT version at http://www.winpt.org. Create a directory and
98  directory and extract all WinPT releated files.  extract all WinPT files from the archive.
   
   
 With the 0.5.0 version of WinPT, all modules are now integrated in  
 the main package. So you don't need the wipe-ext.dll or the ldap-ext.dll!  
99    
100    
101  4.1 Keyserver config file  4.1 Keyserver config file
# Line 110  keyservers. Of course it's possible to a Line 108  keyservers. Of course it's possible to a
108  at the hints inside the file how to format the entries. If there no file,  at the hints inside the file how to format the entries. If there no file,
109  the format can be described like this: 'DNS-Name=IP-Address'. Each line  the format can be described like this: 'DNS-Name=IP-Address'. Each line
110  of the file contains such an entry.  of the file contains such an entry.
111    But it is recommend that you modify the file directly with the keyserver
112    dialog in WinPT to keep this file consistent.
113    
114    
115  5. Verify the packet signature  5. Verify the packet signature
# Line 120  verify the package signature with GnuPG. Line 120  verify the package signature with GnuPG.
120  my OpenPGP public key. If you don't have it, please take a look at  my OpenPGP public key. If you don't have it, please take a look at
121  http://www.winpt.org/twoaday.asc  http://www.winpt.org/twoaday.asc
122    
123  # gpg --verify WinPT-x.x.x-exe.zip.asc  # gpg --verify winpt-x.x.x-exe.zip.asc
124  # gpg --verify WinPT-x.x.x-src.zip.asc  # gpg --verify winpt-x.x.x-src.zip.asc
125    
126  gpg should output that the signature was correct and that the signature  gpg should output that the signature was correct and that the signature
127  was created by me.  was created by me.
128    
129  My key ID is 0xBF3DF9B4: 'Timo Schulz <[email protected]>'.  My key ID is 0xBF3DF9B4: 'Timo Schulz <[email protected]>' or
130                 0x27F36D14: 'Timo Schulz (Laptop Key) <[email protected]>
131    
132    
133  6. Native language support  6. Native language support
# Line 150  do the following: Line 151  do the following:
151    
152  For the moment, WinPT supports these languages:  For the moment, WinPT supports these languages:
153    
     * Italian winpt-it.mo  
     * French winpt-fr.mo  
154      * German winpt-de.mo      * German winpt-de.mo
155      * Spanish winpt-es.mo      * Japanese winpt-jp.mo
     * Russian winpt-ru.mo  
     * Portuguese (Brazilian) winpt-pt_BR.mo  
     * Portuguese winpt-pt_PT.mo  
     * Hungarian winpt-hu.mo  
     * Chinese winpt-zh_CN.mo  
     * Czech winpt-ch.mo  
156    
157  If you are interested in translating WinPT in your native language, please  If you are interested in translating WinPT in your native language, please
158  let me know :-). It's not much work and you do NOT need to be a developer!  let me know :-). It's not much work and you do NOT need to be a developer!
# Line 179  http://www.gnupg.org Line 172  http://www.gnupg.org
172  General questions (look first at the topic point), can be sent to one of the  General questions (look first at the topic point), can be sent to one of the
173  mailing lists. All GnuPG lists are in English.  mailing lists. All GnuPG lists are in English.
174    
175  PGP User list (German) [email protected]  GPG user list [email protected]
176  GPG User list (English) [email protected]  GPG developer list [email protected]
 GPG Developer list (English) [email protected]  
177    
178  At the moment the only available documentation for WinPT is this file. In  At the moment the only available documentation for WinPT is this file. In
179  future releases I will include HTML documentation.  future releases I will include HTML documentation.
# Line 192  future releases I will include HTML docu Line 184  future releases I will include HTML docu
184    
185  If you want to get the latest information, reports, or discussions about  If you want to get the latest information, reports, or discussions about
186  WinPT you can subscribe to one of the WinPT mailing lists. There is a list  WinPT you can subscribe to one of the WinPT mailing lists. There is a list
187  for users and one for developers. Both lists are in English! To subscribe  for users and one for developers. All lists are in English! To subscribe
188  send a message to '[email protected]' with "subscribe listname" in the  visit http://wald.intevation.org and go to the WinPT project site.
189  body.  
190    Please, before you send a message to the list take a look at the FAQ,
191  Example: subscribe winpt-name_of_thelist  the README files and the list archives. It's possible that your question
192    is already answered there!
 [email protected]    - The developer list  
 [email protected]  - The users list  
   
 Please, before you send a message to the list take a look at the FAQ  
 or the README files. It's possible that your question is already answered  
 there!  
193    
194    
195  9. Hotkey for common commands  9. Hotkey for common commands
# Line 221  Sign Clipboard           CTRL+ALT+s Line 207  Sign Clipboard           CTRL+ALT+s
207  Export Clipboard         CTRL+ALT+x  Export Clipboard         CTRL+ALT+x
208  Import Clipboard         CTRL+ALT+i  Import Clipboard         CTRL+ALT+i
209    
210  In the event of an error, it's possible that another program already uses  In case of an error, it's possible that another program already uses
211  some of the hotkeys. WinPT will tell you which hotkey wasn't installed properly  some of the hotkeys. WinPT will tell you which hotkey wasn't installed properly
212  so it's easier to figure out which hotkey caused the problem.  so it's easier to figure out which hotkey caused the problem.
213    
# Line 232  so it's easier to figure out which hotke Line 218  so it's easier to figure out which hotke
218  WinPT allows you to use the main operations (sign and encrypt)  WinPT allows you to use the main operations (sign and encrypt)
219  within the current window. This only works if the current window contains  within the current window. This only works if the current window contains
220  text. For example, a mailer window with the message, a text editor or a  text. For example, a mailer window with the message, a text editor or a
221  simple edit field. There are some kind of windows that are NOT supported  simple edit field. There are some kind of windows that are NOT
222  yet!  supported.
223    
224  The easiest way to access this feature is using the hotkeys. Note: if  The easiest way to access this feature is using the hotkeys. Note: if
225  you use this feature the text will automatically be cut, encrypted  you use this feature the text will automatically be cut, encrypted
# Line 256  the value for this feature in the prefer Line 242  the value for this feature in the prefer
242  to use this feature, you only need to set the value to "0".  to use this feature, you only need to set the value to "0".
243    
244    
245  12.Default keyid for signing  12. Default keyid for signing
246  ----------------------------  ----------------------------
247    
248  There are two ways to set the default keyid. The best solution is to  There are two ways to set the default keyid. The best solution is to
249  set the "default-key" entry in the GPG options file. Alternative you can  set the "default-key" entry in the GPG options file.
250  also use "encrypt-to" for the default keyid.  The second solution is that you use the Key Manager to set a default
251  The second solution is to let WinPT figure out it from the secret key cache,  key. If no default key was found, WinPT uses the first useable key in
252  the first key in this cache is the default keyid. Warning, with this method  the secret key cache.
 it's possible that another keyid is chosen (because of the order in which the keyring  
 was read!).  
253    
254    
255  13. Commands  13. Commands
# Line 295  Here you access some of the "edit-key" c Line 279  Here you access some of the "edit-key" c
279  line.  line.
280    
281    
 13.2.2 UserID  
 -------------  
   
 Gives you an overview about all user id's from a public key. The validity  
 of each is also listed.  
   
   
282  13.2.3 Delete  13.2.3 Delete
283  -------------  -------------
284    
# Line 320  This is an interface to sign a public ke Line 297  This is an interface to sign a public ke
297  Generate a revocation certificate for the chosen key.  Generate a revocation certificate for the chosen key.
298    
299    
 13.2.6 List trust path  
 ----------------------  
   
 TODO.  
   
   
300  13.2.7 Check sigs  13.2.7 Check sigs
301  -----------------  -----------------
302    
# Line 357  from this list by select the key and pre Line 328  from this list by select the key and pre
328  --------------------  --------------------
329    
330  If you are not able to connect directly to the internet, you can  If you are not able to connect directly to the internet, you can
331  use the proxy settings. To enable proxy support, you need to add  use the proxy settings. To enable proxy support, you need to start
332  "use_proxy=xx.xx.xx.xx:port" to your keyserver.conf. Then restart  the keyserver dialog and use the "change" button to set a proxy.
333  WinPT. Now the keyserver code uses the proxy instead of the direct  Now the keyserver code uses the proxy instead of the direct connection.
 connection.  
334    
335  If your proxy needs some kind of authentification, you can use  If your proxy needs some kind of authentification, you can use
336  "proxy_user" and "proxy_pass". Then for each request the data  "proxy_user" and "proxy_pass". Then for each request the data
# Line 388  Which file you'll send depends on the oc Line 358  Which file you'll send depends on the oc
358  mode for your usual work; it slows down both GPG and WinPT.  mode for your usual work; it slows down both GPG and WinPT.
359    
360    
 15. Agent support  
 -----------------  
   
 To use the Windows GPG Agent, you must start the process BEFORE running  
 WinPT. When there was no error, WinPT runs in a passphrase-less mode. All  
 passphrase requests are send to the client. As a result the sign and  
 sign & encrypt dialogs contain NO passphrase items! To force WinPT to use  
 the internal passphrase routines, you can use the "--no-agent" option on  
 the command line.  
   
   
361  16. Features of the dialogs  16. Features of the dialogs
362  ----------------------------  ----------------------------
363    
Legend:
Removed from v.129  
changed lines
  Added in v.218
[email protected]
 ViewVC Help
Powered by ViewVC 1.1.26