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)     <h3>What is a signature and why should I check it?</h3>
16)     <hr>
17) 
18)     <p>How do you know that the Tor program you have is really the
19)     one we made? Many Tor users have very real adversaries who might
20)     try to give them a fake version of Tor &mdash; and it doesn't matter
21)     how secure and anonymous Tor is if you're not running the real Tor.</p>
22) 
23)     <p>An attacker could try a variety of attacks to get you to download
24)     a fake Tor. For example, he could trick you into thinking some other
25)     website is a great place to download Tor. That's why you should
26)     always download Tor from <b>https</b>://www.torproject.org/. The
27)     https part means there's encryption and authentication between your
28)     browser and the website, making it much harder for the attacker
29)     to modify your download. But it's not perfect. Some places in the
30)     world block the Tor website, making users try somewhere else. Large
31)     companies sometimes force employees to use a modified browser,
32)     so the company can listen in on all their browsing. We've even <a
33)     href="https://blog.torproject.org/blog/diginotar-debacle-and-what-you-should-do-about-it">seen</a>
34)     attackers who have the ability to trick your browser into thinking
35)     you're talking to the Tor website with https when you're not.</p>
36) 
37)     <p>Some software sites list <a
38)     href="http://en.wikipedia.org/wiki/Cryptographic_hash_function">sha1
39)     hashes</a> alongside the software on their website, so users can
40)     verify that they downloaded the file without any errors. These
41)     "checksums" help you answer the question "Did I download this file
42)     correctly from whoever sent it to me?" They do a good job at making
43)     sure you didn't have any random errors in your download, but they
44)     don't help you figure out whether you were downloading it from the
45)     attacker. The better question to answer is: "Is this file that I
46)     just downloaded the file that Tor intended me to get?"</p>
47) 

48)     <p>Each file on <a href="<page download/download>">our download
49)     page</a> is accompanied by a file with the same name as the
50)     package and the extension ".asc". These .asc files are GPG
51)     signatures. They allow you to verify the file you've downloaded
52)     is exactly the one that we intended you to get. For example,
53)     tor-browser-<version-torbrowserbundle>_en-US.exe is accompanied by

54)     tor-browser-<version-torbrowserbundle>_en-US.exe.asc. For a list
55)     of which developer signs which package, see our <a href="<page
56)     docs/signing-keys>">signing keys</a> page.</p>

57) 

58)     <h3>Windows</h3>

59)     <hr>

60) 

61)     <p>You need to have GnuPG installed before
62)     you can verify signatures. Download it from <a
63)     href="http://gpg4win.org/download.html">http://gpg4win.org/download.html</a>.</p>

64) 
65)     <p>Once it's installed, use GnuPG to import the key that signed your
66)     package. Since GnuPG for Windows is a command-line tool, you will need
67)     to use <i>cmd.exe</i>. Unless you edit your PATH environment variable,
68)     you will need to tell Windows the full path to the GnuPG program. If
69)     you installed GnuPG with the default values, the path should be
70)     something like this: <i>C:\Program Files\Gnu\GnuPg\gpg.exe</i>.</p>

71) 

72)     <p>Erinn Clark signs the Tor Browser Bundles. Import her key
73)     (0x63FEE659) by starting <i>cmd.exe</i> and typing:</p>

74) 

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

76) 

77)     <p>After importing the key, you can verify that the fingerprint
78)     is correct:</p>

79) 

80)     <pre>C:\Program Files\Gnu\GnuPg\gpg.exe --fingerprint 0x63FEE659</pre>
81) 
82)     <p>You should see:</p>
83)     <pre>
84)     pub   2048R/63FEE659 2003-10-16
85)           Key fingerprint = 8738 A680 B84B 3031 A630  F2DB 416F 0610 63FE E659
86)     uid                  Erinn Clark &lt;erinn@torproject.org&gt;
87)     uid                  Erinn Clark &lt;erinn@debian.org&gt;
88)     uid                  Erinn Clark &lt;erinn@double-helix.org&gt;
89)     sub   2048R/EB399FD7 2003-10-16
90) </pre>

91) 

92)     <p>To verify the signature of the package you downloaded, you will need
93)     to download the ".asc" file as well. Assuming you downloaded the
94)     package and its signature to your Desktop, run:</p>

95) 

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

97) 
98)     <p>The output should say "Good signature": </p>
99) 
100)     <pre>
101)     gpg: Signature made Wed 31 Aug 2011 06:37:01 PM EDT using RSA key ID 63FEE659
102)     gpg: Good signature from "Erinn Clark &lt;erinn@torproject.org&gt;"
103)     gpg:                 aka "Erinn Clark &lt;erinn@debian.org&gt;"
104)     gpg:                 aka "Erinn Clark &lt;erinn@double-helix.org&gt;"
105)     gpg: WARNING: This key is not certified with a trusted signature!
106)     gpg:          There is no indication that the signature belongs to the owner.
107)     Primary key fingerprint: 8738 A680 B84B 3031 A630  F2DB 416F 0610 63FE E659
108)     </pre>
109) 
110)     <p>
111)     Notice that there is a warning because you haven't assigned a trust
112)     index to this person. This means that GnuPG verified that the key made
113)     that signature, but it's up to you to decide if that key really belongs
114)     to the developer. The best method is to meet the developer in person and
115)     exchange key fingerprints.
116)     </p>

117) 

118)     <h3>Mac OS X</h3>

119)     <hr>

120) 

121)     <p>You need to have GnuPG installed before you can verify
122)     signatures. You can install it from <a
123)     href="http://macgpg.sourceforge.net/">http://macgpg.sourceforge.net/</a>.
124)     </p>

125) 

126)     <p>Once it's installed, use GnuPG to import the key that signed
127)     your package. Erinn Clark signs the Tor Browser Bundles. Import her
128)     key (0x63FEE659) by starting the terminal (under "Applications")
129)     and typing:</p>

130) 

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

132) 

133)     <p>After importing the key, you can verify that the fingerprint
134)     is correct:</p>
135) 
136)     <pre>gpg --fingerprint 0x63FEE659</pre>

137) 

138)     <p>You should see:</p>
139)     <pre>

140)     pub   2048R/63FEE659 2003-10-16
141)           Key fingerprint = 8738 A680 B84B 3031 A630  F2DB 416F 0610 63FE E659
142)     uid                  Erinn Clark <erinn@torproject.org>
143)     uid                  Erinn Clark <erinn@debian.org>
144)     uid                  Erinn Clark <erinn@double-helix.org>
145)     sub   2048R/EB399FD7 2003-10-16
146)     </pre>

147) 

148)     <p>To verify the signature of the package you downloaded, you will need
149)     to download the ".asc" file as well. Assuming you downloaded the
150)     package and its signature to your Desktop, run:</p>

151) 

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

153) 

154)     <p>The output should say "Good signature": </p>

155) 

156)     <pre>

157)     gpg: Signature made Wed 31 Aug 2011 06:37:01 PM EDT using RSA key ID 63FEE659
158)     gpg: Good signature from "Erinn Clark <erinn@torproject.org>"
159)     gpg:                 aka "Erinn Clark <erinn@debian.org>"
160)     gpg:                 aka "Erinn Clark <erinn@double-helix.org>"

161)     gpg: WARNING: This key is not certified with a trusted signature!
162)     gpg:          There is no indication that the signature belongs to the owner.

163)     Primary key fingerprint: 8738 A680 B84B 3031 A630  F2DB 416F 0610 63FE E659

164)     </pre>

165) 

166)     <p>
167)     Notice that there is a warning because you haven't assigned a trust
168)     index to this person. This means that GnuPG verified that the key made
169)     that signature, but it's up to you to decide if that key really belongs
170)     to the developer. The best method is to meet the developer in person and
171)     exchange key fingerprints.
172)     </p>

173) 

174)     <h3>Linux</h3>
175)     <hr>

176) 

177)     <p>For <b>RPM-based distributions</b> you can manually verify the
178)     signatures on the RPM packages by:</p>
179)     <pre>rpm -K filename.rpm</pre>

180) 

181)     <p>For <b>Debian</b>, you should read the instructions on <a
182)     href="<page docs/debian>#packages">importing these keys to
183)     apt</a>.</p>

184) 

185)     <p>If you wish to learn more about GPG, see <a
186)     href="http://www.gnupg.org/documentation/">http://www.gnupg.org/documentation/</a>.</p>

187) 

188)   </div>
189)   <!-- END MAINCOL -->
190)   <div id = "sidecol">
191) #include "side.wmi"
192) #include "info.wmi"
193)   </div>
194)   <!-- END SIDECOL -->
195) </div>
196) <!-- END CONTENT -->