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