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