tor-webwml.git

1) ## translation metadata
2) # Revision: $Revision$

3) # Translation-Priority: 2-medium

4) 
5) #include "head.wmi" TITLE="Verifying Signatures" CHARSET="UTF-8"
6) 
7) <div class="main-column">
8) 

9) <h2>How to verify signatures for packages</h2>

10) <hr />
11) 
12) <p>Each file on <a href="<page download>">our download page</a> is accompanied

13) by a file with the same name as the package and the extension

14) ".asc". These .asc files are GPG signatures. They allow you to verify
15) the file you've downloaded is exactly the one that we intended you to
16) get. For example, vidalia-bundle-0.2.1.25-0.2.7.exe is accompanied by
17) vidalia-bundle-0.2.1.25-0.2.7.exe.asc.</p>

18) 

19) <p>Of course, you'll need to have our GPG keys in your keyring: if you don't
20) know the GPG key, you can't be sure that it was really us who signed it. The

21) signing keys we use are:</p>

22) <ul>
23) <li>Roger's (0x28988BF5) typically signs the source code file.</li>

24) <li>Nick's (0x165733EA, or its subkey 0x8D29319A).</li>

25) <li>Andrew's (0x31B0974B) typically signs packages for windows and mac.</li>

26) <li>Peter's (0x94C09C7F, or its subkey 0xAFA44BDD).</li>
27) <li>Matt's (0x5FA14861).</li>

28) <li>Jacob's (0xE012B42D).</li>

29) <li>Erinn's (0x63FEE659) and (0xF1F5C9B5) typically signs the linux packages.</li>

30) <li>Mike's (0xDDC6C0AD) signs the Torbutton xpi.</li>

31) </ul>
32) 
33) <h3>Step Zero: Install GnuPG</h3>
34) <hr />
35) <p>You need to have GnuPG installed before you can verify
36) signatures.</p>
37) 
38) <ul>
39) <li>Linux: see <a
40) href="http://www.gnupg.org/download/">http://www.gnupg.org/download/</a>
41) or install <i>gnupg</i> from the package management system.</li>
42) <li>Windows: see <a
43) href="http://www.gnupg.org/download/">http://www.gnupg.org/download/</a>. Look
44) for the "version compiled for MS-Windows" under "Binaries".</li>
45) <li>Mac: see <a
46) href="http://macgpg.sourceforge.net/">http://macgpg.sourceforge.net/</a>.</li>

47) </ul>

48) 

49) <h3>Step One:  Import the keys</h3>
50) <hr />

51) <p>The next step is to import the key. This can be done directly from
52) GnuPG. Make sure you import the correct key. For example, if you
53) downloaded a Windows package, you will need to import Andrew's key.</p>
54) 
55) <p><b>Windows:</b></p>
56) <p>GnuPG for Windows is a command line tool, and you will need to use
57) <i>cmd.exe</i>. Unless you edit your PATH environment variable, you will
58) need to tell Windows the full path to the GnuPG program. If you installed GnuPG
59) with the default values, the path should be something like this: <i>C:\Program
60) Files\Gnu\GnuPg\gpg.exe</i>.</p>
61) 
62) <p>To import the key 0x28988BF5, start <i>cmd.exe</i> and type:</p>

63) 

64) <pre>C:\Program Files\Gnu\GnuPg\gpg.exe --recv-keys 0x28988BF5</pre>

65) 

66) <p><b>Mac and Linux</b></p>
67) <p>Whether you have a Mac or you run Linux, you will need to use the terminal
68) to run GnuPG. Mac users can find the terminal under "Applications". If you run
69) Linux and use Gnome, the terminal should be under "Applications menu" and
70) "Accessories". KDE users can find the terminal under "Menu" and "System".</p>

71) 

72) <p>To import the key 0x28988BF5, start the terminal and type:</p>

73) 

74) <pre>gpg --recv-keys 0x28988BF5</pre>

75) 

76) <h3>Step Two:  Verify the fingerprints</h3>
77) <hr />

78) <p>After importing the key, you will want to verify that the fingerprint is correct.</p>
79) 
80) <p><b>Windows:</b></p>
81) <pre>C:\Program Files\Gnu\GnuPg\gpg.exe --fingerprint (insert keyid here)</pre>
82) 
83) <p><b>Mac and Linux</b></p>

84) <pre>gpg --fingerprint (insert keyid here)</pre>

85) 

86) The fingerprints for the keys should be:

87) 
88) <pre>
89) pub   1024D/28988BF5 2000-02-27
90)       Key fingerprint = B117 2656 DFF9 83C3 042B  C699 EB5A 896A 2898 8BF5

91) uid                  Roger Dingledine <arma@mit.edu>

92) 
93) pub   3072R/165733EA 2004-07-03
94)       Key fingerprint = B35B F85B F194 89D0 4E28  C33C 2119 4EBB 1657 33EA

95) uid                  Nick Mathewson <nickm@alum.mit.edu>
96) uid                  Nick Mathewson <nickm@wangafu.net>
97) uid                  Nick Mathewson <nickm@freehaven.net>

98) 
99) pub  1024D/31B0974B 2003-07-17
100)      Key fingerprint = 0295 9AA7 190A B9E9 027E  0736 3B9D 093F 31B0 974B

101) uid                  Andrew Lewman (phobos) <phobos@rootme.org>

102) uid                  Andrew Lewman <andrew@lewman.com>
103) uid                  Andrew Lewman <andrew@torproject.org>
104) sub   4096g/B77F95F7 2003-07-17

105) 
106) pub   1024D/94C09C7F 1999-11-10
107)       Key fingerprint = 5B00 C96D 5D54 AEE1 206B  AF84 DE7A AF6E 94C0 9C7F
108) uid                  Peter Palfrader

109) uid                  Peter Palfrader <peter@palfrader.org>
110) uid                  Peter Palfrader <weasel@debian.org>

111) 
112) pub   1024D/5FA14861 2005-08-17
113)       Key fingerprint = 9467 294A 9985 3C9C 65CB  141D AF7E 0E43 5FA1 4861

114) uid                  Matt Edman <edmanm@rpi.edu>
115) uid                  Matt Edman <Matt_Edman@baylor.edu>
116) uid                  Matt Edman <edmanm2@cs.rpi.edu>

117) sub   4096g/EA654E59 2005-08-17

118) 

119) pub   1024D/9D0FACE4 2008-03-11 [expires: 2010-10-07]

120)       Key fingerprint = 12E4 04FF D3C9 31F9 3405  2D06 B884 1A91 9D0F ACE4

121) uid                  Jacob Appelbaum <jacob@appelbaum.net>

122) sub   4096R/F8D04B59 2010-03-11 [expires: 2010-10-07]

123) 
124) pub   2048R/63FEE659 2003-10-16
125)       Key fingerprint = 8738 A680 B84B 3031 A630  F2DB 416F 0610 63FE E659
126) uid                  Erinn Clark <erinn@torproject.org>

127) uid                  Erinn Clark <erinn@debian.org>
128) uid                  Erinn Clark <erinn@double-helix.org>

129) sub   2048R/EB399FD7 2003-10-16
130) 
131) pub   1024D/F1F5C9B5 2010-02-03
132)       Key fingerprint = C2E3 4CFC 13C6 2BD9 2C75  79B5 6B8A AEB1 F1F5 C9B5

133) uid                  Erinn Clark <erinn@torproject.org>

134) sub   1024g/7828F26A 2010-02-03
135) 

136) pub   1024D/DDC6C0AD 2006-07-26
137)       Key fingerprint = BECD 90ED D1EE 8736 7980  ECF8 1B0C A30C DDC6 C0AD

138) uid                  Mike Perry <mikeperry@fscked.org>
139) uid                  Mike Perry <mikepery@fscked.org>

140) sub   4096g/AF0A91D7 2006-07-26
141) 

142) </pre>
143) 

144) <h3>Step Three:  Verify the downloaded package</h3>
145) <hr />

146) <p> To verify the signature of the package you downloaded, you will need
147) to download the ".asc" file as well.</p>
148) 
149) <p>In the following examples, the user Alice downloads packages for
150) Windows, Mac OS X and Linux and also verifies the signature of each
151) package. All files are saved on the desktop.</p>
152) 
153) <p><b>Windows:</b></p>
154) <pre>C:\Program Files\Gnu\GnuPg\gpg.exe --verify C:\Users\Alice\Desktop\vidalia-bundle-0.2.1.25-0.2.7.exe.asc C:\Users\Alice\Desktop\vidalia-bundle-0.2.1.25-0.2.7.exe</pre>
155) 
156) <p><b>Mac:</b></p>
157) <pre>gpg --verify /Users/Alice/vidalia-bundle-0.2.1.25-0.2.7-i386.dmg.asc /Users/Alice/vidalia-bundle-0.2.1.25-0.2.7-i386.dmg</pre>
158) 
159) <p><b>Linux</b></p>
160) <pre>gpg --verify /home/Alice/Desktop/tor-0.2.1.25.tar.gz.asc /home/Alice/Desktop/tor-0.2.1.25.tar.gz</pre>
161) 
162) <p>After verifying, GnuPG will come back saying something like "Good
163) signature" or "BAD signature". The output should look something like
164) this:</p>

165) 
166) <pre>

167) gpg: Signature made Tue 16 Mar 2010 05:55:17 AM CET using DSA key ID 28988BF5

168) gpg: Good signature from "Roger Dingledine <arma@mit.edu>"

169) gpg: WARNING: This key is not certified with a trusted signature!
170) gpg:          There is no indication that the signature belongs to the owner.
171) Primary key fingerprint: B117 2656 DFF9 83C3 042B  C699 EB5A 896A 2898 8BF5
172) </pre>
173) 
174) <p>

175) Notice that there is a warning because you haven't assigned a trust
176) index to this person. This means that GnuPG verified that the key made
177) that signature, but it's up to you to decide if that key really belongs
178) to the developer. The best method is to meet the developer in person and
179) exchange key fingerprints.

180) </p>
181) 
182) <p>For your reference, this is an example of a <em>BAD</em> verification. It

183) means that the signature and file contents do not match. In this case,
184) you should not trust the file contents:</p>

185) 
186) <pre>

187) gpg: Signature made Tue 20 Apr 2010 12:22:32 PM CEST using DSA key ID 28988BF5

188) gpg: BAD signature from "Roger Dingledine <arma@mit.edu>"

189) </pre>
190) 
191) <p>If you are running Tor on Debian you should read the instructions on

192) <a href="<page docs/debian>#packages">importing these keys to apt</a>.</p>
193) 
194) <p>If you wish to learn more about GPG, see <a
195) href="http://www.gnupg.org/documentation/">http://www.gnupg.org/documentation/</a>.</p>