ua: Initial commit. Copied ua/ from en/. A few changes to the esd-ua.po. Getting...
[enc.git] / ua / kitchen / index.t.html
CommitLineData
5ec82b3f
A
1<!-- include virtual="head.html" -->
2
3<!-- ~~~~~~~~~ GnuPG Header and introduction text ~~~~~~~~~ -->
4<header class="row" id="header"><div>
5
6<h1>Email Self-Defense</h1>
7
8<!-- include virtual="translist.html" -->
9
10<ul id="menu" class="os">
11<!-- START DELETION 01, KEEP IN index -->
12<li class="spacer"><a href="index.html" class="current">GNU/Linux</a></li>
13<li><a href="mac.html">Mac OS</a></li>
14<li><a href="windows.html">Windows</a></li>
15<li class="spacer"><a href="workshops.html">Teach your friends</a></li>
16<!-- END DELETION 01 -->
17<!-- START DELETION 02, KEEP IN mac -->
18<li class="spacer"><a href="index.html">GNU/Linux</a></li>
19<li><a href="mac.html" class="current">Mac OS</a></li>
20<li><a href="windows.html">Windows</a></li>
21<li class="spacer"><a href="workshops.html">Teach your friends</a></li>
22<!-- END DELETION 02 -->
23<!-- START DELETION 03, KEEP IN windows -->
24<li class="spacer"><a href="index.html">GNU/Linux</a></li>
25<li><a href="mac.html">Mac OS</a></li>
26<li><a href="windows.html" class="current">Windows</a></li>
27<li class="spacer"><a href="workshops.html">Teach your friends</a></li>
28<!-- END DELETION 03 -->
29<li class="spacer"><a
30href="https://fsf.org/share?u=https://u.fsf.org/zb&amp;t=Email encryption for everyone via %40fsf">
31Share&nbsp;
32<img src="//static.fsf.org/nosvn/enc-dev0/img/gnu-social.png" class="share-logo"
33alt="[GNU Social]" />&nbsp;
34<img src="//static.fsf.org/nosvn/enc-dev0/img/mastodon.png" class="share-logo"
35alt="[Mastodon]" />&nbsp;
36<img src="//static.fsf.org/nosvn/enc-dev0/img/reddit-alien.png" class="share-logo"
37alt="[Reddit]" />&nbsp;
38<img src="//static.fsf.org/nosvn/enc-dev0/img/hacker-news.png" class="share-logo"
39alt="[Hacker News]" /></a></li>
40</ul>
41
42<!-- ~~~~~~~~~ FSF Introduction ~~~~~~~~~ -->
43<div id="fsf-intro">
44
45<h3><a href="http://u.fsf.org/ys"><img
46alt="Free Software Foundation"
47src="//static.fsf.org/nosvn/enc-dev0/img/fsf-logo.png" />
48</a></h3>
49
50<div class="fsf-emphasis">
51
52<p>We fight for computer users' rights, and promote the development of free (as
53in freedom) software. Resisting bulk surveillance is very important to us.</p>
54
55<p><strong>Please donate to support Email Self-Defense. We need to keep
56improving it, and making more materials, for the benefit of people around
57the world taking the first step towards protecting their privacy.</strong></p>
58
59</div>
60
61<p><a
62href="https://crm.fsf.org/civicrm/contribute/transact?reset=1&amp;id=14&amp;pk_campaign=email_self_defense&amp;pk_kwd=guide_donate"><img
63alt="Donate"
64src="//static.fsf.org/nosvn/enc-dev0/img/en/donate.png" /></a></p>
65
66</div><!-- End #fsf-intro -->
67
68<!-- ~~~~~~~~~ Guide Introduction ~~~~~~~~~ -->
69<div class="intro">
70
71<p><a id="infographic" href="infographic.html"><img
72src="//static.fsf.org/nosvn/enc-dev0/img/en/infographic-button.png"
73alt="View &amp; share our infographic &rarr;" /></a>
74Bulk surveillance violates our fundamental rights and makes free speech
75risky. This guide will teach you a basic surveillance self-defense skill: email
76encryption. Once you've finished, you'll be able to send and receive emails
77that are scrambled to make sure a surveillance agent or thief intercepting
78your email can't read them. All you need is a computer with an Internet
79connection, an email account, and about forty minutes.</p>
80
81<p>Even if you have nothing to hide, using encryption helps protect the privacy
82of people you communicate with, and makes life difficult for bulk surveillance
83systems. If you do have something important to hide, you're in good company;
84these are the same tools that whistleblowers use to protect their identities
85while shining light on human rights abuses, corruption and other crimes.</p>
86
87<p>In addition to using encryption, standing up
88to surveillance requires fighting politically for a <a
89href="http://gnu.org/philosophy/surveillance-vs-democracy.html">reduction
90in the amount of data collected on us</a>, but the essential first step is
91to protect yourself and make surveillance of your communication as difficult
92as possible. This guide helps you do that. It is designed for beginners, but
93if you already know the basics of GnuPG or are an experienced free software
94user, you'll enjoy the advanced tips and the <a href="workshops.html">guide
95to teaching your friends</a>.</p>
96
97</div><!-- End .intro -->
98</div></header><!-- End #header -->
99
100<!-- ~~~~~~~~~ Section 1: Get the pieces ~~~~~~~~~ -->
101<section class="row" id="section1"><div>
102
103<!-- ~~~~~~~~~ section introduction: interspersed text ~~~~~~~~~ -->
104<div class="section-intro">
105
106<h2><em>#1</em> Get the pieces</h2>
107
108<!-- START DELETION 04, KEEP IN index -->
109<p class="notes">This guide relies on software which is <a
110href="https://www.gnu.org/philosophy/free-sw.html">freely licensed</a>;
111it's completely transparent and anyone can copy it or make their
112own version. This makes it safer from surveillance than proprietary
113software (like Windows). Learn more about free software at <a
114href="https://u.fsf.org/ys">fsf.org</a>.</p>
115
116<p>Most GNU/Linux operating systems come with GnuPG installed on them,
117so you don't have to download it. Before configuring GnuPG though, you'll
118need the IceDove desktop email program installed on your computer. Most
119GNU/Linux distributions have IceDove installed already, though it may be
120under the alternate name "Thunderbird." Email programs are another way to
121access the same email accounts you can access in a browser (like Gmail),
122but provide extra features.</p>
123<!-- END DELETION 04 -->
124<!-- START DELETION 05, KEEP IN mac windows -->
125<p class="notes">This guide relies on software which is <a
126href="https://www.gnu.org/philosophy/free-sw.html">freely licensed</a>; it's
127completely transparent and anyone can copy it or make their own version. This
128makes it safer from surveillance than proprietary software (like Windows or Mac
129OS). To defend your freedom as well as protect yourself from surveillance, we
130recommend you switch to a free software operating system like GNU/Linux. Learn
131more about free software at <a href="https://u.fsf.org/ys">fsf.org</a>.</p>
132
133<p>To get started, you'll need the IceDove desktop email program installed
134on your computer. For your system, IceDove may be known by the alternate name
135"Thunderbird." Email programs are another way to access the same email accounts
136you can access in a browser (like Gmail), but provide extra features.</p>
137<!-- END DELETION 05 -->
138
139<p>If you already have an email program, you can skip to <a
140href="#step-1b">Step 1.b</a>.</p>
141
142</div><!-- End .section-intro -->
143
144<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
145<div id="step-1a" class="step">
146<div class="sidebar">
147
148<p><img
149src="//static.fsf.org/nosvn/enc-dev0/img/en/screenshots/step1a-install-wizard.png"
150alt="Step 1.A: Install Wizard" /></p>
151
152</div><!-- /.sidebar -->
153<div class="main">
154
155<h3><em>Step 1.a</em> Set up your email program with your email account</h3>
156
157<p>Open your email program and follow the wizard (step-by-step walkthrough)
158that sets it up with your email account.</p>
159
160<p>Look for the letters SSL, TLS, or STARTTLS to the right of the servers
161when you're setting up your account. If you don't see them, you will still
162be able to use encryption, but this means that the people running your email
163system are running behind the industry standard in protecting your security
164and privacy. We recommend that you send them a friendly email asking them
165to enable SSL, TLS, or STARTTLS for your email server. They will know what
166you're talking about, so it's worth making the request even if you aren't
167an expert on these security systems.</p>
168
169<!-- ~~~~~~~~~ Troubleshooting ~~~~~~~~~ -->
170<div class="troubleshooting">
171
172<h4>Troubleshooting</h4>
173
174<dl>
175<dt>The wizard doesn't launch</dt>
176<dd>You can launch the wizard yourself, but the menu option for doing so is
177named differently in each email program. The button to launch it will be in
178the program's main menu, under "New" or something similar, titled something
179like "Add account" or "New/Existing email account."</dd>
180
181<dt>The wizard can't find my account or isn't downloading my mail</dt>
182<dd>Before searching the Web, we recommend you start by asking other people
183who use your email system, to figure out the correct settings.</dd>
184
185<dt class="feedback">Don't see a solution to your problem?</dt>
186<dd class="feedback">Please let us know on the <a
187href="https://libreplanet.org/wiki/GPG_guide/Public_Review">feedback
188page</a>.</dd>
189</dl>
190
191</div><!-- /.troubleshooting -->
192</div><!-- End .main -->
193</div><!-- End #step1-a .step -->
194
195<!-- START DELETION 06, KEEP IN mac -->
196<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
197<div id="step-1b" class="step">
198<div class="main">
199
200<h3><em>Step 1.b</em> Get GnuPG by downloading GPGTools</h3>
201
202<p>GPGTools is a software package that includes GnuPG. <a
203href="https://gpgtools.org/#gpgsuite">Download</a> and install it, choosing
204default options whenever asked. After it's installed, you can close any
205windows that it creates.</p>
206
207<p>There are major security flaws in versions of GnuPG provided by GPGTools
208prior to 2018.3. Make sure you have GPGTools 2018.3 or later.</p>
209
210</div><!-- End .main -->
211</div><!-- End #step1-b .step -->
212<!-- END DELETION 06 -->
213<!-- START DELETION 07, KEEP IN windows -->
214<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
215<div id="step-1b" class="step">
216<div class="main">
217
218<h3><em>Step 1.b</em> Get GnuPG by downloading GPG4Win</h3>
219
220<p>GPG4Win is a software package that includes GnuPG. <a
221href="https://www.gpg4win.org/">Download</a> and install it, choosing default
222options whenever asked. After it's installed, you can close any windows that
223it creates.</p>
224
225<p>There are major security flaws in versions of GnuPG provided by GPG4Win
226prior to 3.1.2. Make sure you have GPG4Win 3.1.2 or later.</p>
227
228</div><!-- End .main -->
229</div><!-- End #step1-b .step -->
230<!-- END DELETION 07 -->
231<!-- START DELETION 08, KEEP IN index -->
232<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
233<div id="step-1b" class="step">
234<div class="sidebar">
235<ul class="images">
236<li><img src="//static.fsf.org/nosvn/enc-dev0/img/en/screenshots/step1b-01-tools-addons.png"
237alt="Step 1.B: Tools -> Add-ons" /></li>
238<li><img src="//static.fsf.org/nosvn/enc-dev0/img/en/screenshots/step1b-02-search.png"
239alt="Step 1.B: Search Add-ons" /></li>
240<li><img src="//static.fsf.org/nosvn/enc-dev0/img/en/screenshots/step1b-03-install.png"
241alt="Step 1.B: Install Add-ons" /></li>
242</ul>
243
244</div><!-- /.sidebar -->
245<div class="main">
246
247<h3><em>Step 1.b</em> Install the Enigmail plugin for your email program</h3>
248
249<p>In your email program's menu, select Add-ons (it may be in the Tools
250section). Make sure Extensions is selected on the left. Do you see Enigmail?
251Make sure it's the latest version. If so, skip this step.</p>
252
253<p>If not, search "Enigmail" with the search bar in the upper right. You
254can take it from here. Restart your email program when you're done.</p>
255
256<p>There are major security flaws in versions of GnuPG prior to 2.2.8, and
257Enigmail prior to 2.0.7. Make sure you have GnuPG 2.2.8 and Enigmail 2.0.7,
258or later versions.</p>
259
260<!-- END DELETION 08 -->
261<!-- START DELETION 09, KEEP IN mac windows -->
262
263<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
264<div id="step-1c" class="step">
265<div class="sidebar">
266<ul class="images">
267<li><img src="//static.fsf.org/nosvn/enc-dev0/img/en/screenshots/step1b-01-tools-addons.png"
268alt="Step 1.C: Tools -> Add-ons" /></li>
269<li><img src="//static.fsf.org/nosvn/enc-dev0/img/en/screenshots/step1b-02-search.png"
270alt="Step 1.C: Search Add-ons" /></li>
271<li><img src="//static.fsf.org/nosvn/enc-dev0/img/en/screenshots/step1b-03-install.png"
272alt="Step 1.C: Install Add-ons" /></li>
273</ul>
274
275</div><!-- /.sidebar -->
276<div class="main">
277
278<h3><em>Step 1.c</em> Install the Enigmail plugin for your email program</h3>
279
280<p>In your email program's menu, select Add-ons (it may be in the Tools
281section). Make sure Extensions is selected on the left. Do you see Enigmail?
282Make sure it's the latest version. If so, skip this step.</p>
283
284<p>If not, search "Enigmail" with the search bar in the upper right. You
285can take it from here. Restart your email program when you're done.</p>
286
287<p>There are major security flaws in Enigmail prior to version 2.0.7. Make
288sure you have Enigmail 2.0.7 or later.</p>
289
290<!-- END DELETION 09 -->
291<!-- ~~~~~~~~~ Troubleshooting ~~~~~~~~~ -->
292<div class="troubleshooting">
293
294<h4>Troubleshooting</h4>
295
296<dl>
297<dt>I can't find the menu.</dt>
298<dd>In many new email programs, the main menu is represented by an image of
299three stacked horizontal bars.</dd>
300
301<dt>My email looks weird</dt>
302<dd>Enigmail doesn't tend to play nice with HTML, which is used to format
303emails, so it may disable your HTML formatting automatically. To send an
304HTML-formatted email without encryption or a signature, hold down the Shift
305key when you select compose. You can then write an email as if Enigmail
306wasn't there.</dd>
307
308<dt class="feedback">Don't see a solution to your problem?</dt>
309<dd class="feedback">Please let us know on the <a
310href="https://libreplanet.org/wiki/GPG_guide/Public_Review">feedback
311page</a>.</dd>
312</dl>
313
314</div><!-- /.troubleshooting -->
315</div><!-- End .main -->
316</div><!-- End #step-1b .step -->
317</div></section><!-- End #section1 -->
318
319<!-- ~~~~~~~~~ Section 2: Make your keys ~~~~~~~~~ -->
320<section class="row" id="section2"><div>
321
322<!-- ~~~~~~~~~ section introduction: interspersed text ~~~~~~~~~ -->
323<div class="section-intro">
324
325<h2><em>#2</em> Make your keys</h2>
326
327<p>To use the GnuPG system, you'll need a public key and a private key (known
328together as a keypair). Each is a long string of randomly generated numbers
329and letters that are unique to you. Your public and private keys are linked
330together by a special mathematical function.</p>
331
332<p>Your public key isn't like a physical key, because it's stored in the open
333in an online directory called a keyserver. People download it and use it,
334along with GnuPG, to encrypt emails they send to you. You can think of the
335keyserver as a phonebook; people who want to send you encrypted email can
336look up your public key.</p>
337
338<p>Your private key is more like a physical key, because you keep it to
339yourself (on your computer). You use GnuPG and your private key together to
340descramble encrypted emails other people send to you. <span style="font-weight:
341bold;">You should never share your private key with anyone, under any
342circumstances.</span></p>
343
344<p>In addition to encryption and decryption, you can also use these keys to
345sign messages and check the authenticity of other people's signatures. We'll
346discuss this more in the next section.</p>
347
348</div><!-- End .section-intro -->
349
350<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
351<div id="step-2a" class="step">
352<div class="sidebar">
353
354<p><img
355src="//static.fsf.org/nosvn/enc-dev0/img/en/screenshots/step2a-01-make-keypair.png"
356alt="Step 2.A: Make a Keypair" /></p>
357
358</div><!-- /.sidebar -->
359<div class="main">
360
361<h3><em>Step 2.a</em> Make a keypair</h3>
362
363<p>The Enigmail Setup wizard may start automatically. If it doesn't, select
364Enigmail &rarr; Setup Wizard from your email program's menu. You don't need
365to read the text in the window that pops up unless you'd like to, but it's
366good to read the text on the later screens of the wizard. Click Next with
367the default options selected, except in these instances, which are listed
368in the order they appear:</p>
369
370<ul>
371<li>On the screen titled "Encryption," select "Encrypt all of my messages
372by default, because privacy is critical to me."</li>
373
374<li>On the screen titled "Signing," select "Don't sign my messages by
375default."</li>
376
377<li>On the screen titled "Key Selection," select "I want to create a new
378key pair for signing and encrypting my email."</li>
379
380<li>On the screen titled "Create Key," pick a strong password! You can
381do it manually, or you can use the Diceware method. Doing it manually
382is faster but not as secure. Using Diceware takes longer and requires
383dice, but creates a password that is much harder for attackers to figure
384out. To use it, read the section "Make a secure passphrase with Diceware" in <a
385href="https://theintercept.com/2015/03/26/passphrases-can-memorize-attackers-cant-guess/">
386this article</a> by Micah Lee.</li>
387</ul>
388
389<p>If you'd like to pick a password manually, come up with something
390you can remember which is at least twelve characters long, and includes
391at least one lower case and upper case letter and at least one number or
392punctuation symbol. Never pick a password you've used elsewhere. Don't use
393any recognizable patterns, such as birthdays, telephone numbers, pets' names,
394song lyrics, quotes from books, and so on.</p>
395
396<p class="notes">The program will take a little while to finish the next
397step, the "Key Creation" screen. While you wait, do something else with your
398computer, like watching a movie or browsing the Web. The more you use the
399computer at this point, the faster the key creation will go.</p>
400
401<p><span style="font-weight: bold;">When the "Key Generation Completed" screen
402pops up, select Generate Certificate and choose to save it in a safe place on
403your computer (we recommend making a folder called "Revocation Certificate"
404in your home folder and keeping it there). This step is essential for your
405email self-defense, as you'll learn more about in <a href="#section5">Section
4065</a>.</span></p>
407
408<!-- ~~~~~~~~~ Troubleshooting ~~~~~~~~~ -->
409<div class="troubleshooting">
410
411<h4>Troubleshooting</h4>
412
413<dl>
414<dt>I can't find the Enigmail menu.</dt>
415<dd>In many new email programs, the main menu is represented by an image
416of three stacked horizontal bars. Enigmail may be inside a section called
417Tools.</dd>
418
419<!-- START DELETION 12, KEEP IN index -->
420<dt>The wizard says that it cannot find GnuPG.</dt>
421<dd>Open whatever program you usually use for installing software, and search
422for GnuPG, then install it. Then restart the Enigmail setup wizard by going
423to Enigmail &rarr; Setup Wizard.</dd>
424
425<!-- END DELETION 12, KEEP IN index -->
426<dt>More resources</dt>
427<dd>If you're having trouble with our
428instructions or just want to learn more, check out <a
429href="https://www.enigmail.net/documentation/Key_Management#Generating_your_own_key_pair">
430Enigmail's wiki instructions for key generation</a>.</dd>
431
432<dt class="feedback">Don't see a solution to your problem?</dt>
433<dd class="feedback">Please let us know on the <a
434href="https://libreplanet.org/wiki/GPG_guide/Public_Review">feedback
435page</a>.</dd>
436</dl>
437
438</div><!-- /.troubleshooting -->
439
440<!-- ~~~~~~~~~ Troubleshooting ~~~~~~~~~ -->
441<div class="troubleshooting">
442
443<h4>Advanced</h4>
444
445<dl>
446<dt>Command line key generation</dt>
447<dd>If you prefer using the command line for a higher
448degree of control, you can follow the documentation from <a
449href="https://www.gnupg.org/gph/en/manual/c14.html#AEN25">The GNU Privacy
450Handbook</a>. Make sure you stick with "RSA and RSA" (the default),
451because it's newer and more secure than the algorithms the documentation
452recommends. Also make sure your key is at least 2048 bits, or 4096 if you
453want to be extra secure.</dd>
454
455<dt>Advanced key pairs</dt>
456<dd>When GnuPG creates a new keypair, it compartmentalizes
457the encryption function from the signing function through <a
458href="https://wiki.debian.org/Subkeys">subkeys</a>. If you use
459subkeys carefully, you can keep your GnuPG identity much more
460secure and recover from a compromised key much more quickly. <a
461href="https://alexcabal.com/creating-the-perfect-gpg-keypair/">Alex Cabal</a>
462and <a href="http://keyring.debian.org/creating-key.html">the Debian wiki</a>
463provide good guides for setting up a secure subkey configuration.</dd>
464</dl>
465
466</div><!-- /.troubleshooting -->
467</div><!-- End .main -->
468</div><!-- End #step-2a .step -->
469
470<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
471<div id="step-2b" class="step">
472<div class="main">
473
474<h3><em>Step 2.b</em> Upload your public key to a keyserver</h3>
475
476<p>In your email program's menu, select Enigmail &rarr; Key Management.</p>
477
478<p>Right click on your key and select Upload Public Keys to Keyserver. You
479don't have to use the default keyserver. If, after research, you would like
480to change to a different default keyserver, you can change that setting
481manually in the Enigmail preferences.</p>
482
483<p class="notes">Now someone who wants to send you an encrypted message can
484download your public key from the Internet. There are multiple keyservers
485that you can select from the menu when you upload, but they are all copies
486of each other, so it doesn't matter which one you use. However, it sometimes
487takes a few hours for them to match each other when a new key is uploaded.</p>
488
489<!-- ~~~~~~~~~ Troubleshooting ~~~~~~~~~ -->
490<div class="troubleshooting">
491
492<h4>Troubleshooting</h4>
493
494<dl>
495<dt>The progress bar never finishes</dt>
496<dd>Close the upload popup, make sure you are connected to the Internet,
497and try again. If that doesn't work, try again, selecting a different
498keyserver.</dd>
499
500<dt>My key doesn't appear in the list</dt>
501<dd>Try checking "Display All Keys by Default."</dd>
502
503<dt>More documentation</dt>
504<dd>If you're having trouble with our
505instructions or just want to learn more, check out <a
506href="https://www.enigmail.net/documentation/Key_Management#Distributing_your_public_key">
507Enigmail's documentation</a>.</dd>
508
509<dt class="feedback">Don't see a solution to your problem?</dt>
510<dd class="feedback">Please let us know on the <a
511href="https://libreplanet.org/wiki/GPG_guide/Public_Review">feedback
512page</a>.</dd>
513</dl>
514
515</div><!-- /.troubleshooting -->
516
517<!-- ~~~~~~~~~ Troubleshooting ~~~~~~~~~ -->
518<div class="troubleshooting">
519
520<h4>Advanced</h4>
521
522<dl>
523<dt>Uploading a key from the command line</dt>
524<dd>You can also upload your keys to a keyserver through the <a
525href="https://www.gnupg.org/gph/en/manual/x457.html">command line</a>. <a
526href="https://sks-keyservers.net/overview-of-pools.php">The sks Web site</a>
527maintains a list of highly interconnected keyservers. You can also <a
528href="https://www.gnupg.org/gph/en/manual/x56.html#AEN64">directly export
529your key</a> as a file on your computer.</dd>
530</dl>
531
532</div><!-- /.troubleshooting -->
533</div><!-- End .main -->
534</div><!-- End #step-2b .step -->
535
536<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
537<div id="terminology" class="step">
538<div class="main">
539
540<h3>GnuPG, OpenPGP, what?</h3>
541
542<p>In general, the terms GnuPG, GPG, GNU Privacy Guard, OpenPGP and PGP
543are used interchangeably. Technically, OpenPGP (Pretty Good Privacy) is the
544encryption standard, and GNU Privacy Guard (often shortened to GPG or GnuPG)
545is the program that implements the standard. Enigmail is a plug-in program
546for your email program that provides an interface for GnuPG.</p>
547
548</div><!-- End .main -->
549</div><!-- End #terminology.step-->
550</div></section><!-- End #section2 -->
551
552<!-- ~~~~~~~~~ Section 3: Try it out ~~~~~~~~~ -->
553<section class="row" id="section3"><div>
554
555<!-- ~~~~~~~~~ section introduction: interspersed text ~~~~~~~~~ -->
556<div class="section-intro">
557
558<h2><em>#3</em> Try it out!</h2>
559
560<p>Now you'll try a test correspondence with a computer program named Edward,
561who knows how to use encryption. Except where noted, these are the same
562steps you'd follow when corresponding with a real, live person.</p>
563
564<!-- <p>NOTE: Edward is currently having some technical difficulties, so he
565may take a long time to respond, or not respond at all. We're sorry about
566this and we're working hard to fix it. Your key will still work even without
567testing with Edward.</p> -->
568</div><!-- End .section-intro -->
569
570<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
571<div id="step-3a" class="step">
572<div class="sidebar">
573
574<p><img
575src="//static.fsf.org/nosvn/enc-dev0/img/en/screenshots/section3-try-it-out.png"
576alt="Try it out." /></p>
577
578</div><!-- /.sidebar -->
579<div class="main">
580
581<h3><em>Step 3.a</em> Send Edward your public key</h3>
582
583<p>This is a special step that you won't have to do when corresponding
584with real people. In your email program's menu, go to Enigmail &rarr; Key
585Management. You should see your key in the list that pops up. Right click
586on your key and select Send Public Keys by Email. This will create a new
587draft message, as if you had just hit the Write button.</p>
588
589<p>Address the message to <a
590href="mailto:edward-en@fsf.org">edward-en@fsf.org</a>. Put at least one word
591(whatever you want) in the subject and body of the email. Don't send yet.</p>
592
593<p>The lock icon in the top left should be yellow, meaning encryption is
594turned on. We want this first special message to be unencrypted, so
595click the icon once to turn it off. The lock should become grey, with a
596blue dot on it (to alert you that the setting has been changed from the
597default). Once encryption is off, hit Send.</p>
598
599<p class="notes">It may take two or three minutes for Edward to
600respond. In the meantime, you might want to skip ahead and check out the <a
601href="#section5">Use it Well</a> section of this guide. Once he's responded,
602head to the next step. From here on, you'll be doing just the same thing as
603when corresponding with a real person.</p>
604
605<p>When you open Edward's reply, GnuPG may prompt you for your password
606before using your private key to decrypt it.</p>
607
608</div><!-- End .main -->
609</div><!-- End #step-3a .step -->
610
611<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
612<div id="step-3b" class="step">
613<div class="main">
614
615<h3><em>Step 3.b</em> Send a test encrypted email</h3>
616
617<p>Write a new email in your email program, addressed to <a
618href="mailto:edward-en@fsf.org">edward-en@fsf.org</a>. Make the subject
619"Encryption test" or something similar and write something in the body.</p>
620
621<p>The lock icon in the top left of the window should be yellow, meaning
622encryption is on. This will be your default from now on.</p>
623
624<p class="notes">Next to the lock, you'll notice an icon of a pencil. We'll
625get to this in a moment.</p>
626
627<p>Click Send. Enigmail will pop up a window that says "Recipients not valid,
628not trusted or not found."</p>
629
630<p>To encrypt an email to Edward, you need his public key, so now you'll have
631Enigmail download it from a keyserver. Click Download Missing Keys and use
632the default in the pop-up that asks you to choose a keyserver. Once it finds
633keys, check the first one (Key ID starting with C), then select ok. Select
634ok in the next pop-up.</p>
635
636<p>Now you are back at the "Recipients not valid, not trusted or not found"
637screen. Check the box in front of Edward's key and click Send.</p>
638
639<p class="notes">Since you encrypted this email with Edward's public key,
640Edward's private key is required to decrypt it. Edward is the only one with
641his private key, so no one except him can decrypt it.</p>
642
643<!-- ~~~~~~~~~ Troubleshooting ~~~~~~~~~ -->
644<div class="troubleshooting">
645
646<h4>Troubleshooting</h4>
647
648<dl>
649<dt>Enigmail can't find Edward's key</dt>
650<dd>Close the pop-ups that have appeared since you clicked Send. Make sure
651you are connected to the Internet and try again. If that doesn't work, repeat
652the process, choosing a different keyserver when it asks you to pick one.</dd>
653
654<dt>Unscrambled messages in the Sent folder</dt>
655<dd>Even though you can't decrypt messages encrypted to someone else's key,
656your email program will automatically save a copy encrypted to your public key,
657which you'll be able to view from the Sent folder like a normal email. This
658is normal, and it doesn't mean that your email was not sent encrypted.</dd>
659
660<dt>More resources</dt>
661<dd>If you're still having trouble with our
662instructions or just want to learn more, check out <a
663href="https://www.enigmail.net/documentation/Signature_and_Encryption#Encrypting_a_message">
664Enigmail's wiki</a>.</dd>
665
666<dt class="feedback">Don't see a solution to your problem?</dt>
667<dd class="feedback">Please let us know on the <a
668href="https://libreplanet.org/wiki/GPG_guide/Public_Review">feedback
669page</a>.</dd>
670</dl>
671
672</div><!-- /.troubleshooting -->
673
674<!-- ~~~~~~~~~ Troubleshooting ~~~~~~~~~ -->
675<div class="troubleshooting">
676
677<h4>Advanced</h4>
678
679<dl>
680<dt>Encrypt messages from the command line</dt>
681<dd>You can also encrypt and decrypt messages and files from the <a
682href="https://www.gnupg.org/gph/en/manual/x110.html">command line</a>,
683if that's your preference. The option --armor makes the encrypted output
684appear in the regular character set.</dd>
685</dl>
686
687</div><!-- /.troubleshooting -->
688</div><!-- End .main -->
689</div><!-- End #step-3b .step -->
690
691<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
692<div id="step-headers_unencrypted" class="step">
693<div class="main">
694
695<h3><em>Important:</em> Security tips</h3>
696
697<p>Even if you encrypt your email, the subject line is not encrypted, so
698don't put private information there. The sending and receiving addresses
699aren't encrypted either, so a surveillance system can still figure out who
700you're communicating with. Also, surveillance agents will know that you're
701using GnuPG, even if they can't figure out what you're saying. When you
702send attachments, Enigmail will give you the choice to encrypt them or not,
703independent of the actual email.</p>
704
705<!-- START DELETION 10, KEEP IN index -->
706<p>For greater security against potential attacks, you can turn off
707HTML. Instead, you can render the message body as plain text. In order
708to do this in Thunderbird, go to View &gt; Message Body As &gt; Plain
709Text.</p>
710<!-- END DELETION 10 -->
711<!-- START DELETION 11, KEEP IN mac windows -->
712<p>For greater security against potential attacks, you can turn off
713HTML. Instead, you can render the message body as plain text.</p>
714<!-- END DELETION 11 -->
715
716</div><!-- End .main -->
717</div><!-- End #step-headers_unencrypted .step-->
718
719<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
720<div id="step-3c" class="step">
721<div class="main">
722
723<h3><em>Step 3.c</em> Receive a response</h3>
724
725<p>When Edward receives your email, he will use his private key to decrypt
726it, then reply to you. </p>
727
728<p class="notes">It may take two or three minutes for Edward to
729respond. In the meantime, you might want to skip ahead and check out the <a
730href="#section5">Use it Well</a> section of this guide.</p>
731
732</div><!-- End .main -->
733</div><!-- End #step-3c .step -->
734
735<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
736<div id="step-3d" class="step">
737<div class="main">
738
739<h3><em>Step 3.d</em> Send a test signed email</h3>
740
741<p>GnuPG includes a way for you to sign messages and files, verifying that
742they came from you and that they weren't tampered with along the way. These
743signatures are stronger than their pen-and-paper cousins -- they're impossible
744to forge, because they're impossible to create without your private key
745(another reason to keep your private key safe).</p>
746
747<p>You can sign messages to anyone, so it's a great way to make people
748aware that you use GnuPG and that they can communicate with you securely. If
749they don't have GnuPG, they will be able to read your message and see your
750signature. If they do have GnuPG, they'll also be able to verify that your
751signature is authentic.</p>
752
753<p>To sign an email to Edward, compose any message to him and click the
754pencil icon next to the lock icon so that it turns gold. If you sign a
755message, GnuPG may ask you for your password before it sends the message,
756because it needs to unlock your private key for signing.</p>
757
758<p>With the lock and pencil icons, you can choose whether each message will
759be encrypted, signed, both, or neither.</p>
760
761</div>
762</div>
763
764<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
765<div id="step-3e" class="step">
766<div class="main">
767
768<h3><em>Step 3.e</em> Receive a response</h3>
769
770<p>When Edward receives your email, he will use your public key (which
771you sent him in <a href="#step-3a">Step 3.A</a>) to verify the message
772you sent has not been tampered with and to encrypt his reply to you.</p>
773
774<p class="notes">It may take two or three minutes for Edward to
775respond. In the meantime, you might want to skip ahead and check out the <a
776href="#section5">Use it Well</a> section of this guide.</p>
777
778<p>Edward's reply will arrive encrypted, because he prefers to use encryption
779whenever possible. If everything goes according to plan, it should say
780"Your signature was verified." If your test signed email was also encrypted,
781he will mention that first.</p>
782
783<p>When you receive Edward's email and open it, Enigmail will
784automatically detect that it is encrypted with your public key, and
785then it will use your private key to decrypt it.</p>
786
787<p>Notice the bar that Enigmail shows you above the message, with
788information about the status of Edward's key.</p>
789
790</div><!-- End .main -->
791</div><!-- End #step-3e .step -->
792</div></section>
793
794<!-- ~~~~~~~~~ Section 4: Learn the Web of Trust ~~~~~~~~~ -->
795<section class="row" id="section4"><div>
796
797<!-- ~~~~~~~~~ section introduction: interspersed text ~~~~~~~~~ -->
798<div class="section-intro">
799
800<h2><em>#4</em> Learn the Web of Trust</h2>
801
802<p>Email encryption is a powerful technology, but it has a weakness;
803it requires a way to verify that a person's public key is actually
804theirs. Otherwise, there would be no way to stop an attacker from making
805an email address with your friend's name, creating keys to go with it and
806impersonating your friend. That's why the free software programmers that
807developed email encryption created keysigning and the Web of Trust.</p>
808
809<p>When you sign someone's key, you are publicly saying that you've verified
810that it belongs to them and not someone else.</p>
811
812<p>Signing keys and signing messages use the same type of mathematical
813operation, but they carry very different implications. It's a good practice
814to generally sign your email, but if you casually sign people's keys, you
815may accidently end up vouching for the identity of an imposter.</p>
816
817<p>People who use your public key can see who has signed it. Once you've
818used GnuPG for a long time, your key may have hundreds of signatures. You
819can consider a key to be more trustworthy if it has many signatures from
820people that you trust. The Web of Trust is a constellation of GnuPG users,
821connected to each other by chains of trust expressed through signatures.</p>
822
823</div><!-- End .section-intro -->
824
825<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
826<div id="step-4a" class="step">
827<div class="sidebar">
828
829<p><img
830src="//static.fsf.org/nosvn/enc-dev0/img/en/screenshots/section4-web-of-trust.png"
831alt="Section 4: Web of Trust" /></p>
832
833</div><!-- /.sidebar -->
834<div class="main">
835
836<h3><em>Step 4.a</em> Sign a key</h3>
837
838<p>In your email program's menu, go to Enigmail &rarr; Key Management.</p>
839
840<p>Right click on Edward's public key and select Sign Key from the context
841menu.</p>
842
843<p>In the window that pops up, select "I will not answer" and click ok.</p>
844
845<p>Now you should be back at the Key Management menu. Select Keyserver &rarr;
846Upload Public Keys and hit ok.</p>
847
848<p class="notes">You've just effectively said "I trust that Edward's public
849key actually belongs to Edward." This doesn't mean much because Edward isn't
850a real person, but it's good practice.</p>
851
852<!--<div id="pgp-pathfinder">
853
854<form enctype="application/x-www-form-urlencoded" action="/mk_path.cgi"
855method="get">
856
857<p><strong>From:</strong><input type="text" value="xD41A008"
858name="FROM"></p>
859
860<p><strong>To:</strong><input type="text" value="50BD01x4" name="TO"></p>
861
862<p class="buttons"><input type="submit" value="trust paths" name="PATHS"><input
863type="reset" value="reset" name=".reset"></p>
864
865</form>
866
867</div>End #pgp-pathfinder -->
868</div><!-- End .main -->
869</div><!-- End #step-4a .step -->
870
871<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
872<div id="step-identify_keys" class="step">
873<div class="main">
874
875<h3>Identifying keys: Fingerprints and IDs</h3>
876
877<p>People's public keys are usually identified by their key fingerprint,
878which is a string of digits like F357AA1A5B1FA42CFD9FE52A9FF2194CC09A61E8
879(for Edward's key). You can see the fingerprint for your public key, and
880other public keys saved on your computer, by going to Enigmail &rarr; Key
881Management in your email program's menu, then right clicking on the key
882and choosing Key Properties. It's good practice to share your fingerprint
883wherever you share your email address, so that people can double-check that
884they have the correct public key when they download yours from a keyserver.</p>
885
886<p class="notes">You may also see public keys referred to by a shorter
887key ID. This key ID is visible directly from the Key Management
888window. These eight character key IDs were previously used for
889identification, which used to be safe, but is no longer reliable. You
890need to check the full fingerprint as part of verifying you have the
891correct key for the person you are trying to contact. Spoofing, in
892which someone intentionally generates a key with a fingerprint whose
893final eight characters are the same as another, is unfortunately
894common.</p>
895
896</div><!-- End .main -->
897</div><!-- End #step-identify_keys .step-->
898
899<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
900<div id="check-ids-before-signing" class="step">
901<div class="main">
902
903<h3><em>Important:</em> What to consider when signing keys</h3>
904
905<p>Before signing a person's key, you need to be confident that it actually
906belongs to them, and that they are who they say they are. Ideally, this
907confidence comes from having interactions and conversations with them over
908time, and witnessing interactions between them and others. Whenever signing
909a key, ask to see the full public key fingerprint, and not just the shorter
910key ID. If you feel it's important to sign the key of someone you've just
911met, also ask them to show you their government identification, and make
912sure the name on the ID matches the name on the public key. In Enigmail,
913answer honestly in the window that pops up and asks "How carefully have you
914verified that the key you are about to sign actually belongs to the person(s)
915named above?"</p>
916
917<!-- ~~~~~~~~~ Troubleshooting ~~~~~~~~~ -->
918<div class="troubleshooting">
919
920<h4>Advanced</h4>
921
922<dl>
923<dt>Master the Web of Trust</dt>
924<dd>Unfortunately, trust does not spread between users the way <a
925href="http://fennetic.net/irc/finney.org/~hal/web_of_trust.html">many people
926think</a>. One of best ways to strengthen the GnuPG community is to deeply <a
927href="https://www.gnupg.org/gph/en/manual/x334.html">understand</a> the Web of
928Trust and to carefully sign as many people's keys as circumstances permit.</dd>
929
930<dt>Set ownertrust</dt>
931<dd>If you trust someone enough to validate other people's keys, you can assign
932them an ownertrust level through Enigmails's key management window. Right
933click on the other person's key, go to the "Select Owner Trust" menu option,
934select the trustlevel and click OK. Only do this once you feel you have a
935deep understanding of the Web of Trust.</dd>
936</dl>
937
938</div><!-- /.troubleshooting -->
939</div><!-- End .main -->
940</div><!-- End #check-ids-before-signing .step-->
941</div></section><!-- End #section4 -->
942
943<!-- ~~~~~~~~~ Section 5: Use it well ~~~~~~~~~ -->
944<section id="section5" class="row"><div>
945
946<!-- ~~~~~~~~~ section introduction: interspersed text ~~~~~~~~~ -->
947<div class="section-intro">
948
949<h2><em>#5</em> Use it well</h2>
950
951<p>Everyone uses GnuPG a little differently, but it's important to follow
952some basic practices to keep your email secure. Not following them, you
953risk the privacy of the people you communicate with, as well as your own,
954and damage the Web of Trust.</p>
955
956</div><!-- End .section-intro -->
957
958<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
959<div id="step-5a" class="step">
960<div class="sidebar">
961
962<p><img
963src="//static.fsf.org/nosvn/enc-dev0/img/en/screenshots/section5-01-use-it-well.png"
964alt="Section 5: Use it Well (1)" /></p>
965
966</div><!-- /.sidebar -->
967<div class="main">
968
969<h3>When should I encrypt? When should I sign?</h3>
970
971<p>The more you can encrypt your messages, the better. If you only encrypt
972emails occasionally, each encrypted message could raise a red flag for
973surveillance systems. If all or most of your email is encrypted, people
974doing surveillance won't know where to start. That's not to say that only
975encrypting some of your email isn't helpful -- it's a great start and it
976makes bulk surveillance more difficult.</p>
977
978<p>Unless you don't want to reveal your own identity (which requires other
979protective measures), there's no reason not to sign every message, whether or
980not you are encrypting. In addition to allowing those with GnuPG to verify
981that the message came from you, signing is a non-intrusive way to remind
982everyone that you use GnuPG and show support for secure communication. If you
983often send signed messages to people that aren't familiar with GnuPG, it's
984nice to also include a link to this guide in your standard email signature
985(the text kind, not the cryptographic kind).</p>
986
987</div><!-- End .main -->
988</div><!-- End #step-5a .step -->
989
990<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
991<div id="step-5b" class="step">
992<div class="sidebar">
993
994<p><img
995src="//static.fsf.org/nosvn/enc-dev0/img/en/screenshots/section5-02-use-it-well.png"
996alt="Section 5: Use it Well (2)" /></p>
997
998</div><!-- /.sidebar -->
999<div class="main">
1000
1001<h3>Be wary of invalid keys</h3>
1002
1003<p>GnuPG makes email safer, but it's still important to watch out for invalid
1004keys, which might have fallen into the wrong hands. Email encrypted with
1005invalid keys might be readable by surveillance programs.</p>
1006
1007<p>In your email program, go back to the first encrypted email that Edward
1008sent you. Because Edward encrypted it with your public key, it will have a
1009message from Enigmail at the top, which most likely says "Enigmail: Part of
1010this message encrypted."</p>
1011
1012<p><b>When using GnuPG, make a habit of glancing at that bar. The program
1013will warn you there if you get an email signed with a key that can't
1014be trusted.</b></p>
1015
1016</div><!-- End .main -->
1017</div><!-- End #step-5b .step -->
1018
1019<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
1020<div id="step-5c" class="step">
1021<div class="main">
1022
1023<h3>Copy your revocation certificate to somewhere safe</h3>
1024
1025<p>Remember when you created your keys and saved the revocation certificate
1026that GnuPG made? It's time to copy that certificate onto the safest digital
1027storage that you have -- the ideal thing is a flash drive, disk, or hard
1028drive stored in a safe place in your home, not on a device you carry with
1029you regularly.</p>
1030
1031<p>If your private key ever gets lost or stolen, you'll need this certificate
1032file to let people know that you are no longer using that keypair.</p>
1033
1034</div><!-- End .main -->
1035</div><!-- End #step-5c .step -->
1036
1037<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
1038<div id="step-lost_key" class="step">
1039<div class="main">
1040
1041<h3><em>Important:</em> act swiftly if someone gets your private key</h3>
1042
1043<p>If you lose your private key or someone else gets ahold
1044of it (say, by stealing or cracking your computer), it's
1045important to revoke it immediately before someone else uses
1046it to read your encrypted email or forge your signature. This
1047guide doesn't cover how to revoke a key, but you can follow these <a
1048href="https://www.hackdiary.com/2004/01/18/revoking-a-gpg-key/">instructions</a>.
1049After you're done revoking, make a new key and send an email to everyone
1050with whom you usually use your key to make sure they know, including a copy
1051of your new key.</p>
1052
1053</div><!-- End .main -->
1054</div><!-- End #step-lost_key .step-->
1055
1056<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
1057<!---<div id="transfer-key" class="step">
1058<div class="main">
1059
1060<h3>Transferring you key</h3>
1061
1062<p>You can use Enigmail's <a
1063href="https://www.enigmail.net/documentation/Key_Management">key management
1064window</a> to import and export keys. If you want to be able to read
1065your encrypted email on a different computer, you will need to export
1066your secret key from here. Be warned, if you transfer the key without <a
1067href="https://help.ubuntu.com/community/EncryptedFilesystemsOnRemovableStorage">encrypting</a>
1068the drive it's on the transfer will be dramatically less secure.</p>
1069
1070</div>--><!-- End .main
1071</div> End #transfer-key .step-->
1072
1073<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
1074<div id="webmail-and-GnuPG" class="step">
1075<div class="main">
1076
1077<h3>Webmail and GnuPG</h3>
1078
1079<p>When you use a web browser to access your email, you're using webmail,
1080an email program stored on a distant website. Unlike webmail, your desktop
1081email program runs on your own computer. Although webmail can't decrypt
1082encrypted email, it will still display it in its encrypted form. If you
1083primarily use webmail, you'll know to open your email client when you receive
1084a scrambled email.</p>
1085
1086</div><!-- End .main -->
1087</div><!-- End #webmail-and-GnuPG .step-->
1088
1089<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~
1090<div id="step-5d" class="step">
1091<div class="main">
1092
1093<h3>Make your public key part of your online identity</h3>
1094
1095<p> First add your public key fingerprint to your email signature, then
1096compose an email to at least five of your friends, telling them you just
1097set up GnuPG and mentioning your public key fingerprint. Link to this guide
1098and ask them to join you. Don't forget that there's also an awesome <a
1099href="infographic.html">infographic to share.</a></p>
1100
1101<p class="notes">Start writing your public key fingerprint anywhere someone
1102would see your email address: your social media profiles, blog, Website,
1103or business card. (At the Free Software Foundation, we put ours on our
1104<a href="https://fsf.org/about/staff">staff page</a>.) We need to get our
1105culture to the point that we feel like something is missing when we see an
1106email address without a public key fingerprint.</p>
1107
1108</div>--><!-- End .main
1109</div> End #step-5d .step-->
1110</div></section><!-- End #section5 -->
1111
1112<!-- ~~~~~~~~~ Section 6: Next steps ~~~~~~~~~ -->
1113<section class="row" id="section6">
1114<div id="step-click_here" class="step">
1115<div class="main">
1116
1117<h2><a href="next_steps.html">Great job! Check out the next steps.</a></h2>
1118
1119</div><!-- End .main -->
1120</div><!-- End #step-click_here .step-->
1121</section><!-- End #section6 -->
1122
1123<!-- ~~~~~~~~~ FAQ ~~~~~~~~~ -->
1124<!-- When un-commenting this section go to main.css and search
1125for /* Guide Sections Background */ then add #faq to the desired color
1126<section class="row" id="faq"><div>
1127<div class="sidebar">
1128
1129<h2>FAQ</h2>
1130
1131</div>
1132<div class="main">
1133
1134<dl>
1135<dt>My key expired</dt>
1136<dd>Answer coming soon.</dd>
1137
1138<dt>Who can read encrypted messages? Who can read signed ones?</dt>
1139<dd>Answer coming soon.</dd>
1140
1141<dt>My email program is opening at times I don't want it to open/is now my
1142default program and I don't want it to be.</dt>
1143<dd>Answer coming soon.</dd>
1144</dl>
1145
1146</div>
1147</div>
1148</section> --><!-- End #faq -->
1149
1150<!-- include virtual="footer.html" -->
1151
1152<!-- include virtual="javascript.html" -->