[dl_bitmask_net.git] / public / signature-verification / index.en.html
1 <!DOCTYPE html>
2 <html lang='en'>
3 <head>
4 <title>
5 Signature Verification - Bitmask Downloads
6 </title>
7 <meta content='width=device-width, initial-scale=1.0' name='viewport'>
8 <meta charset='utf-8'>
9 <link href='/assets/bootstrap.min.css' rel='stylesheet'>
10 <link href='/assets/font-awesome/css/font-awesome.min.css' rel='stylesheet'>
11 <link href='/assets/style.css' rel='stylesheet'>
12 <script src='/assets/js/jquery.min.js'></script>
13 </head>
14 <body>
15 <a class='bm-masthead' href='/'></a>
16 <div class='bm-bar'>
17 Bitmask Downloads
18 </div>
19 <div class='bm-main container'>
20 <div id="TOC"><ol>
21   <li>
22     <a href="#import-leaps-key">Import LEAP’s key</a>
23     <ol>
24       <li>
25         <a href="#option-1-wget">Option 1 – wget</a>
26       </li>
27       <li>
28         <a href="#option-2-search-keyservers">Option 2 – search keyservers</a>
29       </li>
30     </ol>
31   </li>
32   <li>
33     <a href="#download-signature-file">Download signature file</a>
34   </li>
35   <li>
36     <a href="#verify-signature">Verify signature</a>
37   </li>
38 </ol></div>
40 <p>Many of the files available for download from this site have been signed. This page will walk you through what you need to do in order to verify these signatures. This process is entirely optional.</p>
41 <p><code>NOTE:</code> Installation of Android and Mac apps will have their signatures verified automatically. However, we provide signatures for these files if you wish to verify them manually with the process below.</p>
42 <h2><a name="import-leaps-key"></a>Import LEAP’s key</h2>
43 <p>All the files have been signed with the &#8220;<span class="caps">LEAP</span> archive signing key&#8221;. The first step is to import this key into your local keyring. These instructions will use <code>gpg</code>, a free implementation of OpenPGP that works on Mac, Windows, and Linux.</p>
44 <h3><a name="option-1-wget"></a>Option 1 – wget</h3>
45 <p>The easiest way to get the <span class="caps">LEAP</span> archive signing key is to just download it from the bitmask.net website and import into your keyring:</p>
46 <pre><code>wget -O- <a href="https://dl.bitmask.net/apt.key">dl.bitmask.net/apt.key</a> | gpg --import</code></pre>
47 <p>You should see output that looks like this:</p>
48 <pre><code>gpg: key 0x1E34A1828E207901: public key "LEAP archive signing key &lt;<a href="mailto:sysdev&#064leap&#046;se">sysdev&#064leap&#046;se</a>&gt;" imported
49 gpg: Total number processed: 1
50 gpg:               imported: 1  (RSA: 1)
51 gpg: 3 marginal(s) needed, 1 complete(s) needed, classic trust model
52 gpg: depth: 0  valid:   4  signed:   7  trust: 0-, 0q, 0n, 0m, 0f, 4u
53 gpg: depth: 1  valid:   7  signed:  22  trust: 6-, 1q, 0n, 0m, 0f, 0u</code></pre>
54 <h3><a name="option-2-search-keyservers"></a>Option 2 – search keyservers</h3>
55 <p>Alternately, you can import the <span class="caps">LEAP</span> archive signing key by fetching from a keyserver:</p>
56 <pre><code>gpg --recv-key 1E453B2CE87BEE2F7DFE99661E34A1828E207901</code></pre>
57 <p>If you want to make the keyserver connection use <span class="caps">TLS</span>, you can use the sks-keyserver pool. To use this keyserver pool, you will need to <a href="https://sks-keyservers.net/sks-keyservers.netCA.pem">download the sks-keyservers.net CA</a> and save it somewhere on your machine. Additionally, you can <a href="https://sks-keyservers.net/verify_tls.php">verify the certificate’s finger print</a>.</p>
58 <p>Once you have downloaded the <span class="caps">SKS</span> keyserver pool CA, the <code>recv-key</code> command looks like this:</p>
59 <pre><code>gpg --keyserver hkps://pool.sks-keyservers.net --keyserver-options 'ca-cert-file=sks-keyservers.netCA.pem' --recv-key 1E453B2CE87BEE2F7DFE99661E34A1828E207901</code></pre>
60 <p>Assuming you saved the CA certificate to the file <code>sks-keyservers.netCA.pem</code>. For more information, see this <a href="https://help.riseup.net/en/gpg-best-practices">OpenPGP best practices page</a>.</p>
61 <p>There is absolutely no guarentee that the key just imported with <code>recv-key</code> is the one you just requested. To confirm, you need to manually check the fingerprint:</p>
62 <pre><code>gpg --fingerprint 1E453B2CE87BEE2F7DFE99661E34A1828E207901</code></pre>
63 <p>Which should produce output like so:</p>
64 <pre><code>pub   4096R/0x1E34A1828E207901 2013-02-06 [expires: 2015-02-07]
65       Key fingerprint = 1E45 3B2C E87B EE2F 7DFE  9966 1E34 A182 8E20 7901
66 uid                 [  undef ] LEAP archive signing key &lt;<a href="mailto:sysdev&#064leap&#046;se">sysdev&#064leap&#046;se</a>&gt;</code></pre>
67 <h2><a name="download-signature-file"></a>Download signature file</h2>
68 <p>The signature file for each download has the same name as the file but with <code>.asc</code> appended.</p>
69 <p>For a listing of the available signature files, see:</p>
70 <ul>
71         <li><a href="https://dl.bitmask.net/client/android/">All Android files</a></li>
72         <li><a href="https://dl.bitmask.net/client/linux/">All Linux files</a></li>
73         <li><a href="https://dl.bitmask.net/client/osx/">All Mac files</a></li>
74         <li><a href="https://dl.bitmask.net/client/windows/">All Windows files</a></li>
75 </ul>
76 <p>Make sure you put the signature file and the download you want to authenticate in the same directory, and that they have the same name (other than the .asc suffix for the signature file).</p>
77 <h2><a name="verify-signature"></a>Verify signature</h2>
78 <p>Now, just run this command:</p>
79 <pre><code>gpg --verify FILE.asc</code></pre>
80 <p>Where <span class="caps">FILE</span> is the name of the download you want to authenticate.</p>
81 <p>You should see some output like so:</p>
82 <pre><code>gpg: Signature made Mon 15 Sep 2014 07:49:07 AM PDT
83 gpg:                using RSA key 0x1E34A1828E207901
84 gpg: Good signature from "LEAP archive signing key &lt;<a href="mailto:sysdev&#064leap&#046;se">sysdev&#064leap&#046;se</a>&gt;" [unknown]
85 gpg: WARNING: This key is not certified with a trusted signature!
86 gpg:          There is no indication that the signature belongs to the owner.
87 Primary key fingerprint: 1E45 3B2C E87B EE2F 7DFE  9966 1E34 A182 8E20 7901</code></pre>
88 <p>If you have trusted one of the keys that has signed the <span class="caps">LEAP</span> key, then you will not see the warning.</p>
89 <p>If you do not see the text <code>Good signature from "LEAP archive signing key &lt;<a href="mailto:sysdev&#064leap&#046;se">sysdev&#064leap&#046;se</a>&gt;"</code> then something is wrong and you should not run the application you downloaded.</p>
90 </div>
91 <footer>
92 <div>
93 (c) 2014-2018 LEAP Encryption Access Project
94 </div>
95 <div>
96 Everything available for download on this site is free and open source software.
97 <br>
98 Source code available from
99 <a href="https://leap.se/git/">https://leap.se/git</a>
100 or
101 <a href="https://github.com/leapcode">https://github.com/leapcode</a>.
102 </div>
103 </footer>
104 </body>
105 </html>