en/index.html: don't mention the terminal until it's needed; minor edits.
[enc.git] / en / index.html
CommitLineData
a6ffc443
AE
1<!DOCTYPE html>
2<html lang="en">
3<head>
4<meta http-equiv="content-type" content="text/html; charset=utf-8" />
5<title>Email Self-Defense - a guide to fighting surveillance with GnuPG
6encryption</title>
7<meta name="keywords" content="GnuPG, GPG, openpgp, surveillance, privacy,
013b81e2 8email, security, GnuPG2, encryption" />
a6ffc443
AE
9<meta name="description" content="Email surveillance violates our fundamental
10rights and makes free speech risky. This guide will teach you email
11self-defense in 40 minutes with GnuPG." />
12<meta name="viewport" content="width=device-width, initial-scale=1" />
13<link rel="stylesheet" href="../static/css/main.css" />
14<link rel="shortcut icon"
15href="../static/img/favicon.ico" />
16</head>
17
e4266c81 18<body>
a6ffc443
AE
19<!--<div style="text-align: center; padding: 2.5px; background-color: #a94442; color:#fcf8e3;"><p>Due to Enigmail's PGP functionality being migrated into Icedove and Thunderbird, steps 2 and 3 of the guide are currently out of date.</p><p> Thank you for your patience while we're working on a new round of updates.</p></div>-->
20
21<!-- PLACE FUNDRAISER MODAL WINDOW HERE -->
22
a2792ad5
TG
23<div class="wip">THIS IS A TEST VERSION!<br />
24The latest changes haven't been approved yet. Please don't update the PO files.</div>
a6ffc443
AE
25
26<!-- ~~~~~~~~~ GnuPG Header and introduction text ~~~~~~~~~ -->
27<header class="row" id="header"><div>
28
29
30<h1>Email Self-Defense</h1>
31
32<!-- Language list for browsers that do not have JS enabled -->
33<ul id="languages" class="os">
eec483e9
TG
34<li><a class="current" href="/en">English - v5.0</a></li>
35<!--<li><a href="/cs">čeština - v5.0</a></li>
a6ffc443
AE
36<li><a href="/de">Deutsch - v4.0</a></li>
37<li><a href="/el">ελληνικά - v3.0</a></li>
38<li><a href="/es">español - v4.0</a></li>
39<li><a href="/fa">فارسی - v4.0</a></li>
40<li><a href="/fr">français - v4.0</a></li>
41<li><a href="/it">italiano - v3.0</a></li>
42<li><a href="/ja">日本語 - v4.0</a></li>
43<li><a href="/pt-br">português do Brasil - v3.0</a></li>
44<li><a href="/ro">română - v3.0</a></li>
45<li><a href="/ru">русский - v4.0</a></li>
46<li><a href="/sq">Shqip - v4.0</a></li>
df371bd3 47<li><a href="/sv">svenska - v4.0</a></li>
eec483e9 48<li><a href="/tr">Türkçe - v5.0</a></li>
df371bd3
TG
49<li><a href="/zh-hans">简体中文 - v4.0</a></li>-->
50<li><strong><a href="https://libreplanet.org/wiki/GPG_guide/Translation_Guide">
51Translate!</a></strong></li>
a6ffc443
AE
52</ul>
53
54<ul id="menu" class="os">
55<li class="spacer"><a href="index.html" class="current">Set up guide</a></li>
56<!--<li><a href="mac.html">Mac OS</a></li>-->
57<!--<li><a href="windows.html">Windows</a></li>-->
58<li class="spacer"><a href="workshops.html">Teach your friends</a></li>
59<li class="spacer"><a
60href="https://fsf.org/share?u=https://u.fsf.org/zb&amp;t=Email%20encryption%20for%20everyone%20via%20%40fsf">
61Share&nbsp;
62<img src="../static/img/gnu-social.png" class="share-logo"
63alt="[GNU Social]" />&nbsp;
64<img src="../static/img/mastodon.png" class="share-logo"
65alt="[Mastodon]" />&nbsp;
66<img src="../static/img/reddit-alien.png" class="share-logo"
67alt="[Reddit]" />&nbsp;
68<img src="../static/img/hacker-news.png" class="share-logo"
69alt="[Hacker News]" /></a></li>
70</ul>
71
72<!-- ~~~~~~~~~ FSF Introduction ~~~~~~~~~ -->
73<div id="fsf-intro">
74
75<h3><a href="https://u.fsf.org/ys"><img
76alt="Free Software Foundation"
77src="../static/img/fsf-logo.png" />
78</a></h3>
79
80<div class="fsf-emphasis">
81
82<p>We fight for computer users' rights, and promote the development of free (as
83in freedom) software. Resisting bulk surveillance is very important to us.</p>
84
85<p><strong>Please donate to support Email Self-Defense. We need to keep
86improving it, and making more materials, for the benefit of people around
87the world taking the first step towards protecting their privacy.</strong></p>
88
89</div>
90
91<p><a
92href="https://crm.fsf.org/civicrm/contribute/transact?reset=1&amp;id=14&amp;mtm_campaign=email_self_defense&amp;mtm_kwd=guide_donate"><img
93alt="Donate"
94src="../static/img/en/donate.png" /></a></p>
95
96</div><!-- End #fsf-intro -->
97
98<!-- ~~~~~~~~~ Guide Introduction ~~~~~~~~~ -->
99<div class="intro">
100
101<p><a id="infographic" href="infographic.html"><img
102src="../static/img/en/infographic-button.png"
103alt="View &amp; share our infographic &rarr;" /></a>
104Bulk surveillance violates our fundamental rights and makes free speech
105risky. This guide will teach you a basic surveillance self-defense skill: email
106encryption. Once you've finished, you'll be able to send and receive emails
107that are scrambled to make sure a surveillance agent or thief intercepting
108your email can't read them. All you need is a computer with an Internet
109connection, an email account, and about forty minutes.</p>
110
111<p>Even if you have nothing to hide, using encryption helps protect the privacy
112of people you communicate with, and makes life difficult for bulk surveillance
113systems. If you do have something important to hide, you're in good company;
114these are the same tools that whistleblowers use to protect their identities
115while shining light on human rights abuses, corruption, and other crimes.</p>
116
117<p>In addition to using encryption, standing up
118to surveillance requires fighting politically for a <a
119href="https://gnu.org/philosophy/surveillance-vs-democracy.html">reduction
120in the amount of data collected on us</a>, but the essential first step is
121to protect yourself and make surveillance of your communication as difficult
122as possible. This guide helps you do that. It is designed for beginners, but
123if you already know the basics of GnuPG or are an experienced free software
124user, you'll enjoy the advanced tips and the <a href="workshops.html">guide
125to teaching your friends</a>.</p>
126
127</div><!-- End .intro -->
128</div></header><!-- End #header -->
129
130<!-- ~~~~~~~~~ Section 1: Get the pieces ~~~~~~~~~ -->
131<section class="row" id="section1"><div>
132
133<!-- ~~~~~~~~~ section introduction: interspersed text ~~~~~~~~~ -->
134<div class="section-intro">
135
136<h2><em>#1</em> Get the pieces</h2>
137
138<p class="notes">This guide relies on software which is <a
139href="https://www.gnu.org/philosophy/free-sw.html">freely licensed</a>;
140it's completely transparent and anyone can copy it or make their
141own version. This makes it safer from surveillance than proprietary
142software (like Windows or macOS). Learn more about free software at <a
143href="https://u.fsf.org/ys">fsf.org</a>.</p>
144
572e3d5f 145<p>Most GNU/Linux operating systems come with GnuPG installed on them, so if you're running one of these systems, you don't have to download it. If you're running macOS or Windows, steps to download GnuPG are below. Before configuring your encryption setup with this guide, though, you'll need a desktop email program installed on your computer. Many GNU/Linux distributions have one installed already, such as Icedove, which may be under the alternate name "Thunderbird." Programs like these are another way to access the same email accounts you can access in a browser (like Gmail), but provide extra features.</p>
a6ffc443 146
a6ffc443
AE
147</div><!-- End .section-intro -->
148
149<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
150<div id="step-1a" class="step">
151<div class="sidebar">
152
7b371af8 153<p class="large"><img
a6ffc443
AE
154src="../static/img/en/screenshots/step1a-install-wizard.png"
155alt="Step 1.A: Install Wizard" /></p>
156
157</div><!-- /.sidebar -->
158<div class="main">
159
160<h3><em>Step 1.a</em> Set up your email program with your email account</h3>
161
162<p>Open your email program and follow the wizard (step-by-step walkthrough)
163that sets it up with your email account. This usually starts from "Account Settings" &rarr; "Add Mail Account". You should get the email server settings from your systems administrator or the help section of your email account.</p>
df371bd3 164
a6ffc443
AE
165
166<!-- ~~~~~~~~~ Troubleshooting ~~~~~~~~~ -->
167<div class="troubleshooting">
168
169<h4>Troubleshooting</h4>
170
171<dl>
172<dt>The wizard doesn't launch</dt>
173<dd>You can launch the wizard yourself, but the menu option for doing so is
174named differently in each email program. The button to launch it will be in
175the program's main menu, under "New" or something similar, titled something
176like "Add account" or "New/Existing email account."</dd>
177
178<dt>The wizard can't find my account or isn't downloading my mail</dt>
179<dd>Before searching the Web, we recommend you start by asking other people
180who use your email system, to figure out the correct settings.</dd>
181
182<dt>I can't find the menu</dt>
183<dd>In many new email programs, the main menu is represented by an image of
184three stacked horizontal bars.</dd>
185
186<dt class="feedback">Don't see a solution to your problem?</dt>
187<dd class="feedback">Please let us know on the <a
188href="https://libreplanet.org/wiki/GPG_guide/Public_Review">feedback
189page</a>.</dd>
190</dl>
191
192</div><!-- /.troubleshooting -->
193</div><!-- End .main -->
194</div><!-- End #step1-a .step -->
195
196<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
197<div id="step-1b" class="step">
198<div class="main">
199
98681fc5 200<h3><em>Step 1.b</em> Install GnuPG</h3>
a6ffc443 201
98681fc5 202<p>If you are using a GNU/Linux machine, you should already have GnuPG installed, and you can skip to <a href="#section2">Section 2</a>.</p>
a062f9ca 203
98681fc5 204<p>If you are using a macOS or Windows machine, however, you need to first install the GnuPG program. Select your operating system below and follow the instructions. For the rest of this guide, the steps are the same for all operating systems. </p>
a6ffc443
AE
205
206<!-- ~~~~~~~~~ MACOS ~~~~~~~~~ -->
207<div class="troubleshooting">
208
013b81e2 209<h4>macOS</h4>
a6ffc443
AE
210
211<dl>
212<dt>Use a third-party package manager to install GnuPG</dt>
98681fc5
TG
213<dd>
214<p>The default macOS package manager makes it difficult to install GnuPG and other pieces of free software (like Emacs, GIMP, or Inkscape). To make things easier, we recommend setting up the third-party package manager "Homebrew" to install GnuPG. For this, we will use a program called "Terminal," which is pre-installed in MacOS.</p>
215
216<p># Copy the first command on the home page of <a href="https://brew.sh/">Homebrew</a> by clicking on the clipboard icon, and paste it in Terminal. Click "Enter" and wait for the installation to finalize.</p>
217<p># Then install GnuPG by entering the following code in Terminal:<br/>
218<code>brew install gnupg gnupg2</code></p>
219</dd>
a6ffc443
AE
220</dl>
221
222</div><!-- /.troubleshooting -->
223
224<!-- ~~~~~~~~~ WINDOWS ~~~~~~~~~ -->
225<div class="troubleshooting">
226
227<h4>Windows</h4>
228
229<dl>
230<dt>Get GnuPG by downloading GPG4Win</dt>
625cf53d 231<dd><p><a href="https://www.gpg4win.org/">GPG4Win</a> is an email and file encryption software package that includes GnuPG. Download and install the latest version, choosing default options whenever asked. After it's installed, you can close any windows that it creates.</p>
a6ffc443
AE
232</dd>
233</dl>
234
235</div><!-- /.troubleshooting -->
236</div><!-- End .main -->
237</div><!-- End #step1-b .step -->
238
239<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
240<div id="terminology" class="step">
241<div class="main">
242
243<h3>GnuPG, OpenPGP, what?</h3>
244
245<p>In general, the terms GnuPG, GPG, GNU Privacy Guard, OpenPGP and PGP
246are used interchangeably. Technically, OpenPGP (Pretty Good Privacy) is the
247encryption standard, and GNU Privacy Guard (often shortened to GPG or GnuPG)
248is the program that implements the standard. Most email programs provide an interface for GnuPG. There is also a newer version of GnuPG, called GnuPG2.</p>
249
250</div><!-- End .main -->
251</div><!-- End #terminology.step-->
252
253</div></section><!-- End #section1 -->
254
255<!-- ~~~~~~~~~ Section 2: Make your keys ~~~~~~~~~ -->
256<section id="section2" class="row"><div>
257
258<!-- ~~~~~~~~~ section introduction: interspersed text ~~~~~~~~~ -->
259<div class="section-intro">
260
261<h2><em>#2</em> Make your keys</h2>
7b371af8 262<p class="float medium"><img src="../static/img/en/screenshots/step2a-01-make-keypair.png" alt="A robot with a head shaped like a key holding a private and a public key"/></p>
a6ffc443
AE
263
264<p>To use the GnuPG system, you'll need a public key and a private key (known
265together as a keypair). Each is a long string of randomly generated numbers
266and letters that are unique to you. Your public and private keys are linked
267together by a special mathematical function.</p>
268
269<p>Your public key isn't like a physical key, because it's stored in the open
270in an online directory called a keyserver. People download it and use it,
271along with GnuPG, to encrypt emails they send to you. You can think of the
272keyserver as a phonebook; people who want to send you encrypted email can
273look up your public key.</p>
274
275<p>Your private key is more like a physical key, because you keep it to
276yourself (on your computer). You use GnuPG and your private key together to
df371bd3
TG
277descramble encrypted emails other people send to you. <strong>You should never share your private key with anyone, under any
278circumstances.</strong></p>
a6ffc443
AE
279
280<p>In addition to encryption and decryption, you can also use these keys to
281sign messages and check the authenticity of other people's signatures. We'll
282discuss this more in the next section.</p>
283
284</div><!-- End .section-intro -->
285
286<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
287<div id="step-2a" class="step">
288<div class="sidebar">
7b371af8 289<p class="large"><img
a6ffc443
AE
290src="../static/img/en/screenshots/step2a-02-make-keypair.png"
291alt="Step 2.A: Make your Keypair" /></p>
7b371af8
TG
292
293<p class="large"><img
a6ffc443
AE
294src="../static/img/en/screenshots/step2a-03-make-keypair.png"
295alt="Step 2.A: Set your passphrase" /></p>
a6ffc443
AE
296
297</div><!-- /.sidebar -->
298<div class="main">
299
300<h3><em>Step 2.a</em> Make a keypair</h3>
b3dd4deb
TG
301
302<h4>Make your keypair</h4>
a6ffc443 303
b9a7f2fa
TG
304<p>We will use the command line in a terminal to create a keypair using the
305GnuPG program.</p>
a6ffc443 306
a062f9ca 307<p class="notes">Whether on GNU/Linux, macOS or Windows, you can launch your
98681fc5 308terminal ("Terminal" in macOS, "PowerShell" in Windows) from the Applications
a062f9ca
TG
309menu (some GNU/Linux systems respond to the <kbd>Ctrl + Alt + T</kbd>
310shortcut).</p>
b9a7f2fa
TG
311
312<p># Enter <code>gpg --full-generate-key</code> to start the process.</p>
df371bd3
TG
313<p># To answer what kind of key you would like to create, select the default option: <samp>1&nbsp;RSA&nbsp;and&nbsp;RSA</samp>.</p>
314<p># Enter the following keysize: <code>4096</code> for a strong key.</p>
b9a7f2fa 315<p># Choose the expiration date; we suggest <code>2y</code> (2 years).</p>
a6ffc443
AE
316<p>Follow the prompts to continue setting up with your personal details.</p>
317
df371bd3 318<h4>Set your passphrase</h4>
a6ffc443
AE
319<p>On the screen titled "Passphrase," pick a strong password! You can
320do it manually, or you can use the Diceware method. Doing it manually
321is faster but not as secure. Using Diceware takes longer and requires
322dice, but creates a password that is much harder for attackers to figure
323out. To use it, read the section "Make a secure passphrase with Diceware" in <a
324href="https://theintercept.com/2015/03/26/passphrases-can-memorize-attackers-cant-guess/">
325this article</a> by Micah Lee.</p>
326
327
328<p>If you'd like to pick a passphrase manually, come up with something
329you can remember which is at least twelve characters long, and includes
330at least one lower case and upper case letter and at least one number or
331punctuation symbol. Never pick a password you've used elsewhere. Don't use
332any recognizable patterns, such as birthdays, telephone numbers, pets' names,
333song lyrics, quotes from books, and so on.</p>
334
a6ffc443
AE
335<!-- ~~~~~~~~~ Troubleshooting ~~~~~~~~~ -->
336<div class="troubleshooting">
337
338<h4>Troubleshooting</h4>
339<dl>
340<dt>GnuPG is not installed</dt>
341<dd>
a062f9ca 342You can check if this is the case with the command <code>gpg --version</code>&#65279;.
98681fc5 343If GnuPG is not installed, it will bring up the following result on most GNU/Linux operating systems, or something like it:
df371bd3
TG
344<samp>Command 'gpg' not found, but can be installed with:
345 sudo apt install gnupg</samp>. Follow that command and install the program.</dd>
a6ffc443
AE
346
347<dt>I took too long to create my passphrase</dt>
348<dd>That's okay. It's important to think about your passphrase. When you're ready, just follow the steps from the beginning again to create your key.</dd>
349
350<dt>How can I see my key?</dt>
351<dd>
98681fc5 352Use the following command to see all keys: <code>gpg --list-keys</code>&#65279;. Yours should be listed in there, and later, so will Edward's (<a href="#section3">Section 3</a>).<br />
a062f9ca 353If you want to see only your key, you can use <code>gpg --list-key [your@email]</code>&#65279;.<br />
df371bd3 354You can also use <code>gpg --list-secret-key</code> to see your own private key.</dd>
a6ffc443
AE
355
356<dt>More resources</dt>
357<dd>For more information about this process, you can also refer to <a
358href="https://www.gnupg.org/gph/en/manual/c14.html#AEN25">The GNU Privacy
359Handbook</a>. Make sure you stick with "RSA and RSA" (the default),
360because it's newer and more secure than the algorithms the documentation
a062f9ca 361recommends. Also make sure your key is at least 4096&nbsp;bits if you
a6ffc443
AE
362want to be secure.</dd>
363
364<dt class="feedback">Don't see a solution to your problem?</dt>
365<dd class="feedback">Please let us know on the <a
366href="https://libreplanet.org/wiki/GPG_guide/Public_Review">feedback
367page</a>.</dd>
368</dl>
369
370</div><!-- /.troubleshooting -->
371
372<!-- ~~~~~~~~~ Troubleshooting ~~~~~~~~~ -->
373<div class="troubleshooting">
374
375<h4>Advanced</h4>
376<dl>
377<dt>Advanced key pairs</dt>
378<dd>When GnuPG creates a new keypair, it compartmentalizes
379the encryption function from the signing function through <a
380href="https://wiki.debian.org/Subkeys">subkeys</a>. If you use
381subkeys carefully, you can keep your GnuPG identity more
382secure and recover from a compromised key much more quickly. <a
383href="https://alexcabal.com/creating-the-perfect-gpg-keypair/">Alex Cabal</a>
384and <a href="https://keyring.debian.org/creating-key.html">the Debian wiki</a>
385provide good guides for setting up a secure subkey configuration.</dd>
5e3f938b 386</dl>
a6ffc443
AE
387
388</div><!-- /.troubleshooting -->
389</div><!-- End .main -->
390</div><!-- End #step-2a .step -->
391
392<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
393<div id="step-2b" class="step">
394<div class="sidebar">
7b371af8 395<p class="large"><img
a6ffc443
AE
396src="../static/img/en/screenshots/step2b-04-upload-and-certificate.png"
397alt="Step 2.B: Send to server and generate a certificate" /></p>
398
399</div><!-- /.sidebar -->
400<div class="main">
401
402<h3><em>Step 2.b</em> Some important steps following creation</h3>
403
df371bd3 404<h4>Upload your key to a keyserver</h4>
a6ffc443
AE
405<p>We will upload your key to a keyserver, so if someone wants to send you an encrypted message, they can download your public key from the Internet. There are multiple keyservers
406that you can select from the menu when you upload, but they are all copies
407of each other, so it doesn't matter which one you use. However, it sometimes
408takes a few hours for them to match each other when a new key is uploaded.</p>
df371bd3
TG
409<p># Copy your keyID: <code>gpg --list-key [your@email]</code> will list your public ("pub") key information, including your keyID, which is a unique list of numbers and letters. Copy this keyID, so you can use it in the following command.</p>
410<p># Upload your key to a server:
411<code>gpg --send-key [keyID]</code></p>
a6ffc443 412
df371bd3 413<h4>Export your key to a file</h4>
00991279 414<p>Use the following command to export your secret key so you can import it into your email client at the next <a href="#section3">step</a>. To avoid getting your key compromised, store this in a safe place, and make sure that if it is transferred, it is done so in a trusted way. Exporting your keys can be done with the following commands:</p>
99d3c5e1
TG
415<p><code>
416$ gpg --export-secret-keys -a [keyID] > my_secret_key.asc<br/>
417$ gpg --export -a [keyID] > my_public_key.asc
418</code></p>
a6ffc443 419
df371bd3 420<h4>Generate a revocation certificate</h4>
98681fc5 421<p>Just in case you lose your key, or it gets compromised, you want to generate a certificate and choose to save it in a safe place on your computer for now (please refer to <a href="#step-6c">Step 6.C</a> for how to best store your revocation cerficate safely). This step is essential for your email self-defense, as you'll learn more about in <a href="#section5">Section 5</a>.</p>
a6ffc443 422
df371bd3
TG
423<p># Copy your keyID: <code>gpg --list-key [your@email]</code> will list your public ("pub") key information, including your keyID, which is a unique list of numbers and letters. Copy this keyID, so you can use it in the following command.</p>
424<p># Generate a revocation certificate: <code>gpg --gen-revoke --output revoke.asc [keyID]</code></p>
425<p># It will prompt you to give a reason for revocation, we recommend to use <samp>1&nbsp;=&nbsp;key has been compromised</samp>.</p>
a062f9ca 426<p># You don't have to fill in a reason, but you can; then press "Enter" for an empty line, and confirm your selection.</p>
a6ffc443 427
a6ffc443
AE
428
429<!-- ~~~~~~~~~ Troubleshooting ~~~~~~~~~ -->
430<div class="troubleshooting">
431
432<h4>Troubleshooting</h4>
433
434<dl>
435<dt>My key doesn't seem to be working or I get a "permission denied."</dt>
dfee0188 436<dd><p>Like every other file or folder, gpg keys are subject to permissions. If these are not set correctly, your system may not be accepting your keys. You can follow the next steps to check, and update to the right permissions.</p>
a6ffc443 437
df371bd3 438<p># Check your permissions: <code>ls -l ~/.gnupg/*</code></p>
dfee0188 439<p># Set permissions to read, write, execute for only yourself, no others. These are the recommended permissions for your folder. <br/>
df371bd3 440You can use the code: <code>chmod 700 ~/.gnupg</code></p>
dfee0188 441<p># Set permissions to read and write for yourself only, no others. These are the recommended permissions for the keys inside your folder. <br/>
df371bd3 442You can use the code: <code>chmod 600 ~/.gnupg/*</code></p>
a6ffc443 443
dfee0188 444<p class="notes">If you have (for any reason) created your own folders inside ~/.gnupg, you must also additionally apply execute permissions to that folder. Folders require execution privileges to be opened. For more information on permissions, you can check out <a href="https://helpdeskgeek.com/linux-tips/understanding-linux-permissions-chmod-usage/">this detailed information guide</a>.</p>
a6ffc443
AE
445</dd>
446<dt class="feedback">Don't see a solution to your problem?</dt>
447<dd class="feedback">Please let us know on the <a
448href="https://libreplanet.org/wiki/GPG_guide/Public_Review">feedback
449page</a>.</dd>
450</dl>
451
452</div><!-- /.troubleshooting -->
453
454<!-- ~~~~~~~~~ Troubleshooting ~~~~~~~~~ -->
455<div class="troubleshooting">
456
457<h4>Advanced</h4>
458
459<dl>
460<dt>More about keyservers</dt>
461<dd>You can find some more keyserver information<a
462href="https://www.gnupg.org/gph/en/manual/x457.html"> in this manual</a>. <a
463href="https://sks-keyservers.net/overview-of-pools.php">The sks Web site</a>
464maintains a list of highly interconnected keyservers. You can also <a
465href="https://www.gnupg.org/gph/en/manual/x56.html#AEN64">directly export
466your key</a> as a file on your computer.</dd>
467
468<dt>Transferring your keys</dt>
dfee0188
TG
469<dd>
470<p>Use the following commands to transfer your keys. To avoid getting your key compromised, store it in a safe place, and make sure that if it is transferred, it is done so in a trusted way. Importing and exporting a key can be done with the following commands:</p>
a6ffc443 471
99d3c5e1
TG
472<p><code>
473$ gpg --export-secret-keys -a [keyID] > my_private_key.asc<br />
474$ gpg --export -a [keyID] > my_public_key.asc<br />
475$ gpg --import my_private_key.asc<br />
476$ gpg --import my_public_key.asc
477</code></p>
a6ffc443
AE
478
479<p>Ensure that the keyID printed is the correct one, and if so, then go ahead and add ultimate trust for it:</p>
dfee0188 480
df371bd3 481<p><code>
a6ffc443 482$ gpg --edit-key [your@email]
df371bd3 483</code></p>
a6ffc443 484
99d3c5e1 485<p>Because this is your key, you should choose <code>ultimate</code>&#65279;. You shouldn't trust anyone else's key ultimately.</p>
a6ffc443 486
b9a7f2fa 487<p class="notes"> Refer to <a href="#step-2b">Troubleshooting in Step 2.B</a> for more information on permissions. When transferring keys, your permissions may get mixed, and errors may be prompted. These are easily avoided when your folders and files have the right permissions</p>
a6ffc443
AE
488</dd>
489</dl>
490
491</div><!-- /.troubleshooting -->
492</div><!-- End .main -->
493</div><!-- End #step-2b .step -->
494</div></section><!-- End #section2 -->
495
496<!-- ~~~~~~~~~ Section 3: Set up email encryption ~~~~~~~~~ -->
497<section id="section3" class="row"><div>
498
499<!-- ~~~~~~~~~ section introduction: interspersed text ~~~~~~~~~ -->
500<div class="section-intro">
501
502<h2><em>#3</em> Set up email encryption</h2>
5e3f938b 503<p class="notes">The Icedove (or Thunderbird) email program has PGP functionality integrated, which makes it pretty easy to work with. We'll take you through the steps of integrating and using your key in these email clients.</p>
a6ffc443
AE
504
505</div><!-- End .section-intro -->
506
507<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
508<div id="step-3a" class="step">
509<div class="sidebar">
510
7b371af8 511<p class="large"><img src="../static/img/en/screenshots/step3a-open-key-manager.png"
a6ffc443 512alt="Step 3.A: Email Menu" /></p>
7b371af8
TG
513
514<p class="large"><img src="../static/img/en/screenshots/step3a-import-from-file.png"
a6ffc443 515alt="Step 3.A: Import From File" /></p>
7b371af8
TG
516
517<p class="large"><img src="../static/img/en/screenshots/step3a-success.png"
a6ffc443 518alt="Step 3.A: Success" /></p>
7b371af8
TG
519
520<p class="large"><img src="../static/img/en/screenshots/step3a-troubleshoot.png"
a6ffc443
AE
521alt="Step 3.A: Troubleshoot" /></p>
522</div><!-- /.sidebar -->
523<div class="main">
524
525<h3><em>Step 3.a</em> Set up your email with encryption</h3>
4ac42711
TG
526
527<p>Once you have set up your email with encryption, you can start contributing to encrypted traffic on the Internet. First we'll get your email client to import your secret key, and we will also learn how to get other people's public keys from servers so you can send and receive encrypted email.</p>
a6ffc443 528
685d29d0 529<p># Open your email client and use "Tools" &rarr; <i>OpenPGP Key Manager</i></p>
df371bd3 530<p># Under "File" &rarr; <i>Import Secret Key(s) From File</i></p>
b9a7f2fa 531<p># Select the file you saved under the name [my_secret_key.asc] in <a href="#step-2b">Step 2.B</a> when you exported your key</p>
a6ffc443
AE
532<p># Unlock with your passphrase</p>
533<p># You will receive a "OpenPGP keys successfully imported" window to confirm success</p>
685d29d0 534<p># Go to "Account settings" &rarr; "End-To-End Encryption," and make sure your key is imported and select <i>Treat this key as a Personal Key</i>.</p>
a6ffc443
AE
535
536</div><!-- End .main -->
537
538<!-- ~~~~~~~~~ Troubleshooting ~~~~~~~~~ -->
539<div class="main">
540<div class="troubleshooting">
541<h4>Troubleshooting</h4>
542<dl>
543<dt>I'm not sure the import worked correctly</dt>
544<dd>
a6c4ddc6 545Look for "Account settings" &rarr; "End-To-End Encryption." Here you can see if your personal key associated with this email is found. If it is not, you can try again via the <i>Add key</i> option. Make sure you have the correct, active, secret key file.
a6ffc443
AE
546</dd>
547
548<dt class="feedback">Don't see a solution to your problem?</dt>
549<dd class="feedback">Please let us know on the <a
550href="https://libreplanet.org/wiki/GPG_guide/Public_Review">feedback
551page</a>.</dd>
552</dl>
553
554</div><!-- /.troubleshooting -->
555</div><!-- End .main -->
556</div><!-- End #step3-a .step -->
557</div></section><!-- End #section3 -->
558
559<!-- ~~~~~~~~~ Section 4: Try it out ~~~~~~~~~ -->
560<section class="row" id="section4"><div>
561
562<!-- ~~~~~~~~~ section introduction: interspersed text ~~~~~~~~~ -->
563<div class="section-intro">
564
565<h2><em>#4</em> Try it out!</h2>
7b371af8 566<p class="float small"><img src="../static/img/en/screenshots/section3-try-it-out.png" alt="Illustration of a person in a house with a cat connected to a server"/></p>
a6ffc443
AE
567<p>Now you'll try a test correspondence with an FSF computer program named Edward,
568who knows how to use encryption. Except where noted, these are the same
569steps you'd follow when corresponding with a real, live person.</p>
570
571<!-- <p>NOTE: Edward is currently having some technical difficulties, so he
572may take a long time to respond, or not respond at all. We're sorry about
573this and we're working hard to fix it. Your key will still work even without
574testing with Edward.</p> -->
a2792ad5
TG
575
576<div style="clear: both"></div>
a6ffc443
AE
577</div><!-- End .section-intro -->
578
579<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
580<div id="step-4a" class="step">
581<div class="sidebar">
582
7b371af8 583<p class="large"><img
a6ffc443
AE
584src="../static/img/en/screenshots/step4a-send-key-to-Edward.png"
585alt="Step 4.A Send key to Edward." /></p>
586
587</div><!-- /.sidebar -->
588<div class="main">
589
590<h3><em>Step 4.a</em> Send Edward your public key</h3>
591
592<p>This is a special step that you won't have to do when corresponding
593with real people. In your email program's menu, go to "Tools" &rarr; "OpenPGP Key
594Manager." You should see your key in the list that pops up. Right click
df371bd3 595on your key and select <i>Send Public Keys by Email</i>. This will create a new draft message, as if you had just hit the "Write" button, but in the attachment you will find your public keyfile.</p>
a6ffc443
AE
596
597<p>Address the message to <a
598href="mailto:edward-en@fsf.org">edward-en@fsf.org</a>. Put at least one word
599(whatever you want) in the subject and body of the email. Don't send yet.</p>
600
df371bd3 601<p>We want Edward to be able to open the email with your keyfile, so we want this first special message to be unencrypted. Make sure encryption is turned off by using the dropdown menu "Security" and select <i>Do Not Encrypt</i>. Once encryption is off, hit Send.</p>
a6ffc443
AE
602
603<p class="notes">It may take two or three minutes for Edward to
604respond. In the meantime, you might want to skip ahead and check out the <a
605href="#section6">Use it Well</a> section of this guide. Once you have received a response,
606head to the next step. From here on, you'll be doing just the same thing as
607when corresponding with a real person.</p>
608
609<p>When you open Edward's reply, GnuPG may prompt you for your passphrase
610before using your private key to decrypt it.</p>
611
612</div><!-- End .main -->
613</div><!-- End #step-4a .step -->
614
615<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
616<div id="step-4b" class="step">
617<div class="sidebar">
618
7b371af8 619<p class="large"><img
a6ffc443
AE
620src="../static/img/en/screenshots/step4b-option1-verify-key.png"
621alt="Step 4.B Option 1. Verify key" /></p>
7b371af8
TG
622
623<p class="large"><img
a6ffc443
AE
624src="../static/img/en/screenshots/step4b-option2-import-key.png"
625alt="Step 4.B Option 2. Import key" /></p>
626</div><!-- /.sidebar -->
627
628<div class="main">
629
630<h3><em>Step 4.b</em> Send a test encrypted email</h3>
df371bd3
TG
631
632<h4>Get Edward's key</h4>
633
a6ffc443
AE
634<p>To encrypt an email to Edward, you need its public key, so now you'll have
635to download it from a keyserver. You can do this in two different ways:</p>
a6c4ddc6 636<p><strong>Option 1.</strong> In the email answer you received from Edward as a response to your first email, Edward's public key was included. On the right of the email, just above the writing area, you will find an "OpenPGP" button that has a lock and a little wheel next to it. Click that, and select <i>Discover</i> next to the text: "This message was signed with a key that you don't yet have." A popup with Edward's key details will follow.</p>
a6ffc443 637
685d29d0 638<p><strong>Option 2.</strong> Open your OpenPGP Key manager, and under "Keyserver" choose <i>Discover Keys Online</i>. Here, fill in Edward's email address, and import Edward's key.</p>
a6ffc443 639
df371bd3 640<p>The option <i>Accepted (unverified)</i> will add this key to your key manager, and now it can be used to send encrypted emails and to verify digital signatures from Edward.</p>
a6ffc443
AE
641
642<p class="notes">In the popup window confirming if you want to import Edward's key, you'll see many different emails that are all associated with its key. This is correct; you can safely import the key.</p>
643
644<p class="notes">Since you encrypted this email with Edward's public key,
645Edward's private key is required to decrypt it. Edward is the only one with
646its private key, so no one except Edward can decrypt it.</p>
647
df371bd3 648<h4>Send Edward an encrypted email</h4>
a6ffc443
AE
649
650<p> Write a new email in your email program, addressed to <a
651href="mailto:edward-en@fsf.org">edward-en@fsf.org</a>. Make the subject
652"Encryption test" or something similar and write something in the body.</p>
653
df371bd3 654<p>This time, make sure encryption is turned on by using the dropdown menu "Security" and select <i>Require Encryption</i>. Once encryption is on, hit Send.</p>
a6ffc443 655
a6ffc443
AE
656
657<!-- ~~~~~~~~~ Troubleshooting ~~~~~~~~~ -->
658<div class="troubleshooting">
659
660<h4>Troubleshooting</h4>
661
662<dl>
663<dt>"Recipients not valid, not trusted or not found"</dt>
013b81e2 664<dd>You could get the above error message, or something along these lines: "Unable to send this message with end-to-end encryption, because there are problems with the keys of the following recipients: ..." In these cases, you may be trying to send an encrypted email to someone when you do not have their public key yet. Make sure you follow the steps above to import the key to your key manager. Open OpenPGP Key Manager to make sure the recipient is listed there.</dd>
a6ffc443
AE
665
666<dt>Unable to send message</dt>
df371bd3 667<dd>You could get the following message when trying to send your encrypted email: "Unable to send this message with end-to-end encryption, because there are problems with the keys of the following recipients: edward-en@fsf.org." This usually means you imported the key with the "unaccepted (unverified) option." Go to the "key properties" of this key by right clicking on the key in the OpenPGP Key Manager, and select the option <i>Yes, but I have not verified that this is the correct key</i> in the "Acceptance" option at the bottom of this window. Resend the email.</dd>
a6ffc443
AE
668
669<dt>I can't find Edward's key</dt>
670<dd>Close the pop-ups that have appeared since you clicked Send. Make sure
671you are connected to the Internet and try again. If that doesn't work, repeat
672the process, choosing a different keyserver when it asks you to pick one.</dd>
673
674<dt>Unscrambled messages in the Sent folder</dt>
675<dd>Even though you can't decrypt messages encrypted to someone else's key,
676your email program will automatically save a copy encrypted to your public key,
677which you'll be able to view from the Sent folder like a normal email. This
678is normal, and it doesn't mean that your email was not sent encrypted.</dd>
679
680<dt class="feedback">Don't see a solution to your problem?</dt>
681<dd class="feedback">Please let us know on the <a
682href="https://libreplanet.org/wiki/GPG_guide/Public_Review">feedback
683page</a>.</dd>
684</dl>
685
686</div><!-- /.troubleshooting -->
687
688<!-- ~~~~~~~~~ Troubleshooting ~~~~~~~~~ -->
689<div class="troubleshooting">
690
691<h4>Advanced</h4>
692
693<dl>
694<dt>Encrypt messages from the command line</dt>
695<dd>You can also encrypt and decrypt messages and files from the <a
696href="https://www.gnupg.org/gph/en/manual/x110.html">command line</a>,
697if that's your preference. The option --armor makes the encrypted output
698appear in the regular character set.</dd>
699</dl>
700
701</div><!-- /.troubleshooting -->
702</div><!-- End .main -->
703</div><!-- End #step-4b .step -->
704
705<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
706<div id="step-headers_unencrypted" class="step">
707<div class="main">
708
709<h3><em>Important:</em> Security tips</h3>
710
711<p>Even if you encrypt your email, the subject line is not encrypted, so
712don't put private information there. The sending and receiving addresses
713aren't encrypted either, so a surveillance system can still figure out who
714you're communicating with. Also, surveillance agents will know that you're
715using GnuPG, even if they can't figure out what you're saying. When you
716send attachments, you can choose to encrypt them or not,
717independent of the actual email.</p>
718
719<p>For greater security against potential attacks, you can turn off
720HTML. Instead, you can render the message body as plain text. In order
025f768f
TG
721to do this in Icedove or Thunderbird, go to "View" &rarr; "Message Body As" &rarr; <i>Plain
722Text</i>.</p>
a6ffc443
AE
723
724</div><!-- End .main -->
725</div><!-- End #step-headers_unencrypted .step-->
726
727<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
728<div id="step-4c" class="step">
729<div class="sidebar">
730
7b371af8 731<p class="large"><img
a6ffc443
AE
732src="../static/img/en/screenshots/step4c-Edward-response.png"
733alt="Step 4.C Edward's response" /></p>
734
735</div><!-- /.sidebar -->
736
737<div class="main">
738
739<h3><em>Step 4.c</em> Receive a response</h3>
740
741<p>When Edward receives your email, it will use its private key to decrypt
742it, then reply to you. </p>
743
744<p class="notes">It may take two or three minutes for Edward to
745respond. In the meantime, you might want to skip ahead and check out the <a
746href="#section6">Use it Well</a> section of this guide.</p>
747
8df3fe60 748<p>Edward will send you an encrypted email back saying your email was received and decrypted. Your email client will automatically decrypt Edward's message.</p>
a6ffc443 749
2a2a4521 750<p class="notes">The OpenPGP button in the email will show a little green checkmark over the lock symbol to show the message is encrypted, and a little orange warning sign which means that you have accepted the key, but not verified it. When you have not yet accepted the key, you will see a little question mark there. Clicking the prompts in this button will lead you to key properties as well.</p>
a6ffc443
AE
751
752</div><!-- End .main -->
753</div><!-- End #step-4c .step -->
754
755<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
756<div id="step-4d" class="step">
757<div class="main">
758
759<h3><em>Step 4.d</em> Send a signed test email</h3>
760
761<p>GnuPG includes a way for you to sign messages and files, verifying that
762they came from you and that they weren't tampered with along the way. These
763signatures are stronger than their pen-and-paper cousins -- they're impossible
764to forge, because they're impossible to create without your private key
765(another reason to keep your private key safe).</p>
766
767<p>You can sign messages to anyone, so it's a great way to make people
768aware that you use GnuPG and that they can communicate with you securely. If
769they don't have GnuPG, they will be able to read your message and see your
770signature. If they do have GnuPG, they'll also be able to verify that your
771signature is authentic.</p>
772
773<p>To sign an email to Edward, compose any message to the email address and click the
774pencil icon next to the lock icon so that it turns gold. If you sign a
775message, GnuPG may ask you for your password before it sends the message,
776because it needs to unlock your private key for signing.</p>
777
df371bd3 778<p>In "Account Settings" &rarr; "End-To-End-Encryption" you can opt to <i>add digital signature by default</i>.</p>
a6ffc443
AE
779
780</div><!-- End .main -->
781</div><!-- End #step-4d .step -->
782
783<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
784<div id="step-4e" class="step">
785<div class="main">
786
787<h3><em>Step 4.e</em> Receive a response</h3>
788
789<p>When Edward receives your email, he will use your public key (which
790you sent him in <a href="#step-3a">Step 3.A</a>) to verify the message
791you sent has not been tampered with and to encrypt a reply to you.</p>
792
793<p class="notes">It may take two or three minutes for Edward to
794respond. In the meantime, you might want to skip ahead and check out the <a
795href="#section6">Use it Well</a> section of this guide.</p>
796
797<p>Edward's reply will arrive encrypted, because he prefers to use encryption
798whenever possible. If everything goes according to plan, it should say
799"Your signature was verified." If your test signed email was also encrypted,
800he will mention that first.</p>
801
802<p>When you receive Edward's email and open it, your email client will
803automatically detect that it is encrypted with your public key, and
804then it will use your private key to decrypt it.</p>
805
806</div><!-- End .main -->
807</div><!-- End #step-4e .step -->
808</div></section>
809
810<!-- ~~~~~~~~~ Section 5: Learn About the Web of Trust ~~~~~~~~~ -->
811<section class="row" id="section5"><div>
812
813<!-- ~~~~~~~~~ section introduction: interspersed text ~~~~~~~~~ -->
814<div class="section-intro">
815
816<h2><em>#5</em> Learn about the Web of Trust</h2>
7b371af8 817<p class="float small"><img src="../static/img/en/screenshots/section5-web-of-trust.png" alt="Illustration of keys all interconnected with a web of lines"/></p>
a6ffc443
AE
818
819<p>Email encryption is a powerful technology, but it has a weakness:
820it requires a way to verify that a person's public key is actually
821theirs. Otherwise, there would be no way to stop an attacker from making
822an email address with your friend's name, creating keys to go with it, and
823impersonating your friend. That's why the free software programmers that
824developed email encryption created keysigning and the Web of Trust.</p>
825
826<p>When you sign someone's key, you are publicly saying that you've verified
827that it belongs to them and not someone else.</p>
828
829<p>Signing keys and signing messages use the same type of mathematical
830operation, but they carry very different implications. It's a good practice
831to generally sign your email, but if you casually sign people's keys, you
b8ee01bf 832may accidentally end up vouching for the identity of an imposter.</p>
a6ffc443
AE
833
834<p>People who use your public key can see who has signed it. Once you've
835used GnuPG for a long time, your key may have hundreds of signatures. You
836can consider a key to be more trustworthy if it has many signatures from
837people that you trust. The Web of Trust is a constellation of GnuPG users,
838connected to each other by chains of trust expressed through signatures.</p>
839
840</div><!-- End .section-intro -->
841
842<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
843<div id="step-5a" class="step">
844<div class="sidebar">
845
7b371af8 846<p class="large"><img
a6ffc443
AE
847src="../static/img/en/screenshots/step5a-key-properties.png"
848alt="Section 5: trusting a key" /></p>
849
850</div><!-- /.sidebar -->
851<div class="main">
852
853<h3><em>Step 5.a</em> Sign a key</h3>
854
df371bd3 855<p>In your email program's menu, go to OpenPGP Key Manager and select <i>Key properties</i> by right clicking on Edward's key.</p>
a6ffc443 856
df371bd3 857<p>Under "Your Acceptance," you can select <i>Yes, I've verified in person this key has the correct fingerprint"</i>.</p>
a6ffc443
AE
858
859<p class="notes">You've just effectively said "I trust that Edward's public
860key actually belongs to Edward." This doesn't mean much because Edward isn't
861a real person, but it's good practice, and for real people it is important. You can read more about signing a person's key in the <a href="#check-ids-before-signing">check IDs before signing</a> section.</p>
862
863<!--<div id="pgp-pathfinder">
864
865<form enctype="application/x-www-form-urlencoded" action="/mk_path.cgi"
866method="get">
867
868<p><strong>From:</strong><input type="text" value="xD41A008"
869name="FROM"></p>
870
871<p><strong>To:</strong><input type="text" value="50BD01x4" name="TO"></p>
872
873<p class="buttons"><input type="submit" value="trust paths" name="PATHS"><input
874type="reset" value="reset" name=".reset"></p>
875
876</form>
877
878</div>End #pgp-pathfinder -->
879</div><!-- End .main -->
880</div><!-- End #step-5a .step -->
881
882<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
883<div id="step-identify_keys" class="step">
884<div class="main">
885
886<h3>Identifying keys: Fingerprints and IDs</h3>
887
888<p>People's public keys are usually identified by their key fingerprint,
889which is a string of digits like F357AA1A5B1FA42CFD9FE52A9FF2194CC09A61E8
890(for Edward's key). You can see the fingerprint for your public key, and
891other public keys saved on your computer, by going to OpenPGP Key
892Management in your email program's menu, then right clicking on the key
893and choosing Key Properties. It's good practice to share your fingerprint
894wherever you share your email address, so that people can double-check that
895they have the correct public key when they download yours from a keyserver.</p>
896
897<p class="notes">You may also see public keys referred to by a shorter
898keyID. This keyID is visible directly from the Key Management
899window. These eight character keyIDs were previously used for
900identification, which used to be safe, but is no longer reliable. You
901need to check the full fingerprint as part of verifying you have the
902correct key for the person you are trying to contact. Spoofing, in
903which someone intentionally generates a key with a fingerprint whose
904final eight characters are the same as another, is unfortunately
905common.</p>
906
907</div><!-- End .main -->
908</div><!-- End #step-identify_keys .step-->
909
910<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
911<div id="check-ids-before-signing" class="step">
912<div class="main">
913
914<h3><em>Important:</em> What to consider when signing keys</h3>
915
916<p>Before signing a person's key, you need to be confident that it actually
917belongs to them, and that they are who they say they are. Ideally, this
918confidence comes from having interactions and conversations with them over
919time, and witnessing interactions between them and others. Whenever signing
920a key, ask to see the full public key fingerprint, and not just the shorter
921keyID. If you feel it's important to sign the key of someone you've just
922met, also ask them to show you their government identification, and make
923sure the name on the ID matches the name on the public key.</p>
924
925<!-- ~~~~~~~~~ Troubleshooting ~~~~~~~~~ -->
926<div class="troubleshooting">
927
928<h4>Advanced</h4>
929
930<dl>
931<dt>Master the Web of Trust</dt>
932<dd>Unfortunately, trust does not spread between users the way <a
933href="https://fennetic.net/irc/finney.org/~hal/web_of_trust.html">many people
934think</a>. One of the best ways to strengthen the GnuPG community is to deeply <a
935href="https://www.gnupg.org/gph/en/manual/x334.html">understand</a> the Web of
936Trust and to carefully sign as many people's keys as circumstances permit.</dd>
937</dl>
938
939</div><!-- /.troubleshooting -->
940</div><!-- End .main -->
941</div><!-- End #check-ids-before-signing .step-->
942</div></section><!-- End #section5 -->
943
944<!-- ~~~~~~~~~ Section 6: Use it well ~~~~~~~~~ -->
945<section id="section6" class="row"><div>
946
947<!-- ~~~~~~~~~ section introduction: interspersed text ~~~~~~~~~ -->
948<div class="section-intro">
949
950<h2><em>#6</em> Use it well</h2>
951
952<p>Everyone uses GnuPG a little differently, but it's important to follow
953some basic practices to keep your email secure. Not following them, you
954risk the privacy of the people you communicate with, as well as your own,
955and damage the Web of Trust.</p>
956
957</div><!-- End .section-intro -->
958
959<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
960<div id="step-6a" class="step">
961<div class="sidebar">
962
7b371af8 963<p class="medium"><img
a6ffc443
AE
964src="../static/img/en/screenshots/section6-01-use-it-well.png"
965alt="Section 6: Use it Well (1)" /></p>
966
967</div><!-- /.sidebar -->
968<div class="main">
969
970<h3>When should I encrypt? When should I sign?</h3>
971
972<p>The more you can encrypt your messages, the better. If you only encrypt
973emails occasionally, each encrypted message could raise a red flag for
974surveillance systems. If all or most of your email is encrypted, people
975doing surveillance won't know where to start. That's not to say that only
976encrypting some of your email isn't helpful -- it's a great start and it
977makes bulk surveillance more difficult.</p>
978
979<p>Unless you don't want to reveal your own identity (which requires other
980protective measures), there's no reason not to sign every message, whether or
981not you are encrypting. In addition to allowing those with GnuPG to verify
982that the message came from you, signing is a non-intrusive way to remind
983everyone that you use GnuPG and show support for secure communication. If you
984often send signed messages to people that aren't familiar with GnuPG, it's
985nice to also include a link to this guide in your standard email signature
986(the text kind, not the cryptographic kind).</p>
987
988</div><!-- End .main -->
989</div><!-- End #step-6a .step -->
990
991<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
992<div id="step-6b" class="step">
993<div class="sidebar">
994
7b371af8 995<p class="medium"><img
a6ffc443
AE
996src="../static/img/en/screenshots/section6-02-use-it-well.png"
997alt="Section 6: Use it Well (2)" /></p>
998
999</div><!-- /.sidebar -->
1000<div class="main">
1001
1002<h3>Be wary of invalid keys</h3>
1003
1004<p>GnuPG makes email safer, but it's still important to watch out for invalid
1005keys, which might have fallen into the wrong hands. Email encrypted with
1006invalid keys might be readable by surveillance programs.</p>
1007
1008<p>In your email program, go back to the first encrypted email that Edward
1009sent you. Because Edward encrypted it with your public key, it will have a
1010green checkmark a at the top "OpenPGP" button.</p>
1011
df371bd3 1012<p><strong>When using GnuPG, make a habit of glancing at that button. The program
a6ffc443 1013will warn you there if you get an email signed with a key that can't
df371bd3 1014be trusted.</strong></p>
a6ffc443
AE
1015
1016</div><!-- End .main -->
1017</div><!-- End #step-6b .step -->
1018
1019<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
1020<div id="step-6c" 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 storage that you have -- a flash drive, disk, or hard drive stored in a safe place in your home could work, not on a device you carry with you regularly. The safest way we know is actually to print the revocation certificate and store it in a safe place.</p>
1027
1028<p>If your private key ever gets lost or stolen, you'll need this certificate
1029file to let people know that you are no longer using that keypair.</p>
1030
1031</div><!-- End .main -->
1032</div><!-- End #step-6c .step -->
1033
1034<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
1035<div id="step-lost_key" class="step">
1036<div class="main">
1037
1038<h3><em>IMPORTANT:</em> ACT SWIFTLY if someone gets your private key</h3>
1039
1040<p>If you lose your private key or someone else gets a hold
1041of it (say, by stealing or cracking your computer), it's
1042important to revoke it immediately before someone else uses
1043it to read your encrypted email or forge your signature. This
1044guide doesn't cover how to revoke a key, but you can follow these <a
1045href="https://www.hackdiary.com/2004/01/18/revoking-a-gpg-key/">instructions</a>.
1046After you're done revoking, make a new key and send an email to everyone
1047with whom you usually use your key to make sure they know, including a copy
1048of your new key.</p>
1049
1050</div><!-- End .main -->
1051</div><!-- End #step-lost_key .step-->
1052
1053<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
1054<div id="webmail-and-GnuPG" class="step">
1055<div class="main">
1056
1057<h3>Webmail and GnuPG</h3>
1058
1059<p>When you use a web browser to access your email, you're using webmail,
1060an email program stored on a distant website. Unlike webmail, your desktop
1061email program runs on your own computer. Although webmail can't decrypt
1062encrypted email, it will still display it in its encrypted form. If you
1063primarily use webmail, you'll know to open your email client when you receive
1064a scrambled email.</p>
1065
1066</div><!-- End .main -->
1067</div><!-- End #webmail-and-GnuPG .step-->
1068
1069<!-- ~~~~~~~~~ a div for each step ~~~~~~~~~ -->
1070<div id="step-6d" class="step">
1071<div class="main">
1072
1073<h3>Make your public key part of your online identity</h3>
1074
1075<p> First add your public key fingerprint to your email signature, then
1076compose an email to at least five of your friends, telling them you just
1077set up GnuPG and mentioning your public key fingerprint. Link to this guide
1078and ask them to join you. Don't forget that there's also an awesome <a
1079href="infographic.html">infographic to share.</a></p>
1080
1081<p class="notes">Start writing your public key fingerprint anywhere someone
1082would see your email address: your social media profiles, blog, Website,
1083or business card. (At the Free Software Foundation, we put ours on our
1084<a href="https://fsf.org/about/staff">staff page</a>.) We need to get our
1085culture to the point that we feel like something is missing when we see an
1086email address without a public key fingerprint.</p>
1087
1088</div><!-- End .main-->
1089</div><!-- End #step-6d .step-->
1090</div></section><!-- End #section6 -->
1091
1092<!-- ~~~~~~~~~ Section 7: Next steps ~~~~~~~~~ -->
1093<section class="row" id="section7">
1094<div id="step-click_here" class="step">
1095<div class="main">
1096
1097<h2><a href="next_steps.html">Great job! Check out the next steps.</a></h2>
1098
1099</div><!-- End .main -->
1100</div><!-- End #step-click_here .step-->
1101</section><!-- End #section7 -->
1102
1103<!-- ~~~~~~~~~ FAQ ~~~~~~~~~ -->
1104<!-- When un-commenting this section go to main.css and search
1105for /* Guide Sections Background */ then add #faq to the desired color
1106<section class="row" id="faq"><div>
1107<div class="sidebar">
1108
1109<h2>FAQ</h2>
1110
1111</div>
1112<div class="main">
1113
1114<dl>
1115<dt>My key expired</dt>
1116<dd>Answer coming soon.</dd>
1117
1118<dt>Who can read encrypted messages? Who can read signed ones?</dt>
1119<dd>Answer coming soon.</dd>
1120
1121<dt>My email program is opening at times I don't want it to open/is now my
1122default program and I don't want it to be.</dt>
1123<dd>Answer coming soon.</dd>
1124</dl>
1125
1126</div>
1127</div>
1128</section> --><!-- End #faq -->
1129
1130<!-- ~~~~~~~~~ Footer ~~~~~~~~~ -->
1131<footer class="row" id="footer"><div>
1132<div id="copyright">
1133
1134<h4><a href="https://u.fsf.org/ys"><img
1135alt="Free Software Foundation"
1136src="../static/img/fsf-logo.png" /></a></h4>
1137
1138<p>Copyright &copy; 2014-2021 <a
1139href="https://u.fsf.org/ys">Free Software Foundation</a>, Inc. <a
1140href="https://my.fsf.org/donate/privacypolicy.html">Privacy Policy</a>. Please
1141support our work by <a href="https://u.fsf.org/yr">joining us as an associate
1142member.</a></p>
1143
1144<p>The images on this page are under a <a
1145href="https://creativecommons.org/licenses/by/4.0/">Creative Commons
1146Attribution 4.0 license (or later version)</a>, and the rest of it is under
1147a <a href="https://creativecommons.org/licenses/by-sa/4.0">Creative Commons
1148Attribution-ShareAlike 4.0 license (or later version)</a>. Download the <a
1149href="https://agpl.fsf.org/emailselfdefense.fsf.org/edward/CURRENT/edward.tar.gz">
1150source code of Edward reply bot</a> by Andrew Engelbrecht
1151&lt;andrew@engelbrecht.io&gt; and Josh Drake &lt;zamnedix@gnu.org&gt;,
1152available under the GNU Affero General Public License. <a
1153href="https://www.gnu.org/licenses/license-list.html#OtherLicenses">Why these
1154licenses?</a></p>
1155
1156<p>Fonts used in the guide &amp; infographic: <a
1157href="https://www.google.com/fonts/specimen/Dosis">Dosis</a> by Pablo
1158Impallari, <a href="https://www.google.com/fonts/specimen/Signika">Signika</a>
1159by Anna Giedry&#347;, <a
1160href="https://www.google.com/fonts/specimen/Archivo+Narrow">Archivo
1161Narrow</a> by Omnibus-Type, <a
1162href="https://libreplanet.org/wiki/GPG_guide/Graphics_Howto#Pitfalls">PXL-2000</a>
1163by Florian Cramer.</p>
1164
1165<p>Download the <a href="emailselfdefense_source.zip">source package</a>
1166for this guide, including fonts, image source files and the text of Edward's
1167messages.</p>
1168
1169<p>This site uses the Weblabels standard for labeling <a
1170href="https://www.fsf.org/campaigns/freejs">free JavaScript</a>. View
1171the JavaScript <a href="https://weblabels.fsf.org/emailselfdefense.fsf.org/"
1172rel="jslicense">source code and license information</a>.</p>
1173
1174</div><!-- /#copyright -->
1175
1176<p class="credits">Infographic and guide design by <a rel="external"
1177href="https://jplusplus.org"><strong>Journalism++</strong><img
1178src="static/img/jplusplus.png"
1179alt="Journalism++" /></a></p><!-- /.credits -->
1180</div></footer><!-- End #footer -->
1181
1182
1183<script type="text/javascript"
1184src="../static/js/jquery-1.11.0.min.js"></script>
1185<script type="text/javascript"
1186src="../static/js/scripts.js"></script>
1187<!-- Piwik -->
1188<script type="text/javascript">
35d248c5 1189 // @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-2.0-or-later
a6ffc443
AE
1190 var _paq = _paq || [];
1191 _paq.push(["trackPageView"]);
1192 _paq.push(["enableLinkTracking"]);
1193
1194 (function() {
1195 var u = (("https:" == document.location.protocol) ? "https" : "http") + "://"+"piwik.fsf.org//";
1196 _paq.push(["setTrackerUrl", u+"piwik.php"]);
1197 _paq.push(["setSiteId", "13"]);
1198 var d=document, g=d.createElement("script"), s=d.getElementsByTagName("script")[0]; g.type="text/javascript";
1199 g.defer=true; g.async=true; g.src=u+"piwik.js"; s.parentNode.insertBefore(g,s);
1200 })();
1201 // @license-end
1202</script>
1203<!-- End Piwik Code -->
1204<!-- Piwik Image Tracker -->
1205<noscript><img src="https://piwik.fsf.org//piwik.php?idsite=13&amp;rec=1" style="border:0" alt="" /></noscript>
1206<!-- End Piwik -->
1207</body>
1208</html>