tor-webwml.git

1) ## translation metadata

2) # Revision: $Revision$

3) # Translation-Priority: 2-medium
4) 
5) #include "head.wmi" TITLE="Tor Project: Verifying Signatures" CHARSET="UTF-8"
6) <div id="content" class="clearfix">
7)   <div id="breadcrumbs">

8)     <a href="<page index>">Home &raquo; </a>

9)     <a href="<page docs/verifying-signatures>">Verifying Signatures</a>
10)   </div>

11)   <div id="maincol">

12)     <h1>How to verify signatures for packages</h1>

13)     <hr>

14) 

15)     <p>Each file on <a href="<page download/download>">our download page</a> is accompanied
16)     by a file with the same name as the package and the extension
17)     ".asc". These .asc files are GPG signatures. They allow you to verify
18)     the file you've downloaded is exactly the one that we intended you to

19)     get. For example, tor-browser-<version-torbrowserbundle>_en-US.exe is accompanied by
20)     tor-browser-<version-torbrowserbundle>_en-US.exe.asc.</p>

21) 

22)     <p>Of course, you'll need to have our GPG keys in your keyring: if you don't
23)     know the GPG key, you can't be sure that it was really us who signed it. The
24)     signing keys we use are:</p>
25)     <ul>
26)     <li>Roger's (0x28988BF5) typically signs the source code file.</li>
27)     <li>Nick's (0x165733EA, or its subkey 0x8D29319A).</li>

28)     <li>Andrew's (0x31B0974B) typically signed older packages for windows and mac.</li>

29)     <li>Peter's (0x94C09C7F, or its subkey 0xAFA44BDD).</li>
30)     <li>Matt's (0x5FA14861).</li>
31)     <li>Jacob's (0xE012B42D).</li>

32)     <li>Erinn's (0x63FEE659) and (0xF1F5C9B5) typically signs all windows, mac, and most linux packages.</li>

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

34)     <li>Karsten's (0xF7C11265) signs the metrics archives and tools.</li>

35)     <li>Robert Hogan's (0x22F6856F) signs torsocks release tarballs and tags.</li>

36)     </ul>

37) 

38)     <h3>Step Zero: Install GnuPG</h3>

39)     <hr>

40)     <p>You need to have GnuPG installed before you can verify
41)     signatures.</p>

42) 

43)     <ul>
44)     <li>Linux: see <a
45)     href="http://www.gnupg.org/download/">http://www.gnupg.org/download/</a>
46)     or install <i>gnupg</i> from the package management system.</li>
47)     <li>Windows: see <a
48)     href="http://www.gnupg.org/download/">http://www.gnupg.org/download/</a>. Look
49)     for the "version compiled for MS-Windows" under "Binaries".</li>
50)     <li>Mac: see <a
51)     href="http://macgpg.sourceforge.net/">http://macgpg.sourceforge.net/</a>.</li>
52)     </ul>

53) 

54)     <h3>Step One:  Import the keys</h3>

55)     <hr>

56)     <p>The next step is to import the key. This can be done directly from
57)     GnuPG. Make sure you import the correct key. For example, if you

58)     downloaded a Windows package, you will need to import Erinn's key.</p>

59) 

60)     <p><b>Windows:</b></p>
61)     <p>GnuPG for Windows is a command line tool, and you will need to use
62)     <i>cmd.exe</i>. Unless you edit your PATH environment variable, you will
63)     need to tell Windows the full path to the GnuPG program. If you installed GnuPG
64)     with the default values, the path should be something like this: <i>C:\Program
65)     Files\Gnu\GnuPg\gpg.exe</i>.</p>

66) 

67)     <p>To import the key 0x28988BF5, start <i>cmd.exe</i> and type:</p>

68) 

69)     <pre>C:\Program Files\Gnu\GnuPg\gpg.exe --keyserver hkp://keys.gnupg.net --recv-keys 0x28988BF5</pre>

70) 

71)     <p><b>Mac and Linux</b></p>
72)     <p>Whether you have a Mac or you run Linux, you will need to use the terminal
73)     to run GnuPG. Mac users can find the terminal under "Applications". If you run
74)     Linux and use Gnome, the terminal should be under "Applications menu" and
75)     "Accessories". KDE users can find the terminal under "Menu" and "System".</p>

76) 

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

78) 

79)     <pre>gpg --keyserver hkp://keys.gnupg.net --recv-keys 0x28988BF5</pre>

80) 

81)     <h3>Step Two:  Verify the fingerprints</h3>

82)     <hr>

83)     <p>After importing the key, you will want to verify that the fingerprint is correct.</p>

84) 

85)     <p><b>Windows:</b></p>
86)     <pre>C:\Program Files\Gnu\GnuPg\gpg.exe --fingerprint (insert keyid here)</pre>

87) 

88)     <p><b>Mac and Linux</b></p>
89)     <pre>gpg --fingerprint (insert keyid here)</pre>

90) 

91)     The fingerprints for the keys should be:

92) 

93)     <pre>
94)     pub   1024D/28988BF5 2000-02-27
95)           Key fingerprint = B117 2656 DFF9 83C3 042B  C699 EB5A 896A 2898 8BF5
96)     uid                  Roger Dingledine &lt;arma@mit.edu&gt;

97) 

98)     pub   3072R/165733EA 2004-07-03
99)           Key fingerprint = B35B F85B F194 89D0 4E28  C33C 2119 4EBB 1657 33EA
100)     uid                  Nick Mathewson <nickm@alum.mit.edu>
101)     uid                  Nick Mathewson <nickm@wangafu.net>
102)     uid                  Nick Mathewson <nickm@freehaven.net>

103) 

104)     pub  1024D/31B0974B 2003-07-17
105)          Key fingerprint = 0295 9AA7 190A B9E9 027E  0736 3B9D 093F 31B0 974B
106)     uid                  Andrew Lewman (phobos) <phobos@rootme.org>
107)     uid                  Andrew Lewman <andrew@lewman.com>
108)     uid                  Andrew Lewman <andrew@torproject.org>
109)     sub   4096g/B77F95F7 2003-07-17

110) 

111)     pub   1024D/94C09C7F 1999-11-10
112)           Key fingerprint = 5B00 C96D 5D54 AEE1 206B  AF84 DE7A AF6E 94C0 9C7F
113)     uid                  Peter Palfrader
114)     uid                  Peter Palfrader <peter@palfrader.org>
115)     uid                  Peter Palfrader <weasel@debian.org>

116) 

117)     pub   1024D/5FA14861 2005-08-17
118)           Key fingerprint = 9467 294A 9985 3C9C 65CB  141D AF7E 0E43 5FA1 4861
119)     uid                  Matt Edman <edmanm@rpi.edu>
120)     uid                  Matt Edman <Matt_Edman@baylor.edu>
121)     uid                  Matt Edman <edmanm2@cs.rpi.edu>
122)     sub   4096g/EA654E59 2005-08-17

123) 

124)     pub   4096R/E012B42D 2010-05-07
125)           Key fingerprint = D8C9 AF51 CAA9 CAEA D3D8  9C9E A34F A745 E012 B42D

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

127)     uid                  Jacob Appelbaum <jacob@torproject.org>
128)     sub   4096R/7CA91A52 2010-05-07 [expires: 2011-05-07]

129) 

130)     pub   2048R/63FEE659 2003-10-16
131)           Key fingerprint = 8738 A680 B84B 3031 A630  F2DB 416F 0610 63FE E659
132)     uid                  Erinn Clark <erinn@torproject.org>
133)     uid                  Erinn Clark <erinn@debian.org>
134)     uid                  Erinn Clark <erinn@double-helix.org>
135)     sub   2048R/EB399FD7 2003-10-16

136) 

137)     pub   1024D/F1F5C9B5 2010-02-03
138)           Key fingerprint = C2E3 4CFC 13C6 2BD9 2C75  79B5 6B8A AEB1 F1F5 C9B5
139)     uid                  Erinn Clark <erinn@torproject.org>
140)     sub   1024g/7828F26A 2010-02-03

141) 

142)     pub   1024D/DDC6C0AD 2006-07-26
143)           Key fingerprint = BECD 90ED D1EE 8736 7980  ECF8 1B0C A30C DDC6 C0AD
144)     uid                  Mike Perry <mikeperry@fscked.org>
145)     uid                  Mike Perry <mikepery@fscked.org>
146)     sub   4096g/AF0A91D7 2006-07-26

147) 

148)     pub   1024D/F7C11265 2007-03-09 [expires: 2012-03-01]
149)           Key fingerprint = FC8A EEF1 792E EE71 D721  7D47 D0CF 963D F7C1 1265
150)     uid                  Karsten Loesing <karsten.loesing@gmx.net>
151)     sub   2048g/75D85E4B 2007-03-09 [expires: 2012-03-01]
152) 

153)     pub   1024D/22F6856F 2006-08-19
154)           Key fingerprint = DDB4 6B5B 7950 CD47 E59B  5189 4C09 25CF 22F6 856F
155)     uid                  Robert Hogan <robert@roberthogan.net>
156)     sub   1024g/FC4A9460 2006-08-19
157) 

158)     </pre>

159) 

160)     <h3>Step Three:  Verify the downloaded package</h3>

161)     <hr>

162)     <p> To verify the signature of the package you downloaded, you will need
163)     to download the ".asc" file as well.</p>

164) 

165)     <p>In the following examples, the user Alice downloads packages for
166)     Windows, Mac OS X and Linux and also verifies the signature of each
167)     package. All files are saved on the desktop.</p>

168) 

169)     <p><b>Windows:</b></p>

170)     <pre>C:\Program Files\Gnu\GnuPg\gpg.exe --verify C:\Users\Alice\Desktop\<file-win32-bundle-stable>.asc C:\Users\Alice\Desktop\<file-win32-bundle-stable></pre>

171) 

172)     <p><b>Mac:</b></p>

173)     <pre>gpg --verify /Users/Alice/<file-osx-x86-bundle-stable>.asc /Users/Alice/<file-osx-x86-bundle-stable></pre>

174) 

175)     <p><b>Linux</b></p>

176)     <pre>gpg --verify /home/Alice/Desktop/<file-source-stable>.asc /home/Alice/Desktop/<file-source-stable></pre>

177)     

178) 

179)     <p>After verifying, GnuPG will come back saying something like "Good
180)     signature" or "BAD signature". The output should look something like
181)     this:</p>

182) 

183)     <pre>
184)     gpg: Signature made Tue 16 Mar 2010 05:55:17 AM CET using DSA key ID 28988BF5
185)     gpg: Good signature from "Roger Dingledine &lt;arma@mit.edu&gt;"
186)     gpg: WARNING: This key is not certified with a trusted signature!
187)     gpg:          There is no indication that the signature belongs to the owner.
188)     Primary key fingerprint: B117 2656 DFF9 83C3 042B  C699 EB5A 896A 2898 8BF5
189)     </pre>

190) 

191)     <p>
192)     Notice that there is a warning because you haven't assigned a trust
193)     index to this person. This means that GnuPG verified that the key made
194)     that signature, but it's up to you to decide if that key really belongs
195)     to the developer. The best method is to meet the developer in person and
196)     exchange key fingerprints.
197)     </p>

198) 

199)     <p>For your reference, this is an example of a <em>BAD</em> verification. It
200)     means that the signature and file contents do not match. In this case,
201)     you should not trust the file contents:</p>

202) 

203)     <pre>
204)     gpg: Signature made Tue 20 Apr 2010 12:22:32 PM CEST using DSA key ID 28988BF5
205)     gpg: BAD signature from "Roger Dingledine &lt;arma@mit.edu&gt;"
206)     </pre>

207) 

208)     <p><b>RPM-based distributions :</b></p>
209)     <p>In order to manually verify the signatures on the RPM packages, you must use the
210)     <code>rpm</code> tool like so: <br />
211)     
212)     <pre>rpm -K filename.rpm</pre></p>
213)     <p></p>
214)     
215)     <p><b>Debian:</b></p>

216)     <p>If you are running Tor on Debian you should read the instructions on
217)     <a href="<page docs/debian>#packages">importing these keys to apt</a>.</p>

218) 

219)     <p>If you wish to learn more about GPG, see <a
220)     href="http://www.gnupg.org/documentation/">http://www.gnupg.org/documentation/</a>.</p>
221)   </div>
222)   <!-- END MAINCOL -->
223)   <div id = "sidecol">
224) #include "side.wmi"
225) #include "info.wmi"
226)   </div>
227)   <!-- END SIDECOL -->
228) </div>
229) <!-- END CONTENT -->