Parcourir la source

Update FAQ for Let's Encrypt

Bob Mottram il y a 9 ans
Parent
révision
bd222f7dbf
2 fichiers modifiés avec 82 ajouts et 369 suppressions
  1. 38
    152
      doc/EN/faq.org
  2. 44
    217
      website/EN/faq.html

+ 38
- 152
doc/EN/faq.org Voir le fichier

18
 
18
 
19
 #+BEGIN_CENTER
19
 #+BEGIN_CENTER
20
 #+ATTR_HTML: :border -1
20
 #+ATTR_HTML: :border -1
21
-| [[file:index.html][Home]]                                                                       |
22
-| [[I don't have a static IP address. Can I still install this system?]]         |
23
-| [[What is the best hardware to run this system on?]]                           |
24
-| [[Can I add more users to the system?]]                                        |
25
-| [[How do I remove a user from the system?]]                                    |
26
-| [[How do I reset the tripwire?]]                                               |
27
-| [[Is metadata protected?]]                                                     |
28
-| [[How do I create email processing rules?]]                                    |
29
-| [[Why isn't dynamic DNS working?]]                                             |
30
-| [[How do I change my encryption settings?]]                                    |
31
-| [[How do I get a domain name?]]                                                |
32
-| [[How do I get a "real" SSL certificate?]]                                     |
33
-| [[How do I renew a StartSSL certificate?]]                                     |
34
-| [[Why use self-signed certificates?]]                                          |
35
-| [[Why not use the services of $company instead? They took the Seppuku pledge]] |
36
-| [[Why does my email keep getting rejected as spam by Gmail/etc?]]              |
21
+| [[file:index.html][Home]]                                                                          |
22
+| [[I don't have a static IP address. Can I still install this system?]]            |
23
+| [[What is the best hardware to run this system on?]]                              |
24
+| [[Can I add more users to the system?]]                                           |
25
+| [[How do I remove a user from the system?]]                                       |
26
+| [[How do I reset the tripwire?]]                                                  |
27
+| [[Is metadata protected?]]                                                        |
28
+| [[How do I create email processing rules?]]                                       |
29
+| [[Why isn't dynamic DNS working?]]                                                |
30
+| [[How do I change my encryption settings?]]                                       |
31
+| [[How do I get a domain name?]]                                                   |
32
+| [[How do I get a "real" SSL/TLS/HTTPS certificate?]]                              |
33
+| [[How do I renew a Let's Encrypt certificate?]]                                   |
34
+| [[I tried to renew a Let's Encrypt certificate and it failed. What should I do?]] |
35
+| [[Why use self-signed certificates?]]                                             |
36
+| [[Why not use the services of $company instead? They took the Seppuku pledge]]    |
37
+| [[Why does my email keep getting rejected as spam by Gmail/etc?]]                 |
37
 #+END_CENTER
38
 #+END_CENTER
38
 
39
 
39
 * I don't have a static IP address. Can I still install this system?
40
 * I don't have a static IP address. Can I still install this system?
200
 
201
 
201
 You should now be able to send an email from /postmaster@mynewdomainname/ and it should arrive in your inbox.
202
 You should now be able to send an email from /postmaster@mynewdomainname/ and it should arrive in your inbox.
202
 
203
 
203
-* How do I get a "real" SSL certificate?
204
-You can obtain a free "official" (as in recognised by default by web browsers) SSL certificate from [[https://www.startssl.com/][StartSSL]]. You will first need to have bought a domain name, since it's not possible to obtain one for a freedns subdomain, so see [[How do I get a domain name?][Using your own domain]] for details of how to do that.  You should also have tested that you can send email to the domain and receive it on the Freedombone (via Mutt or any other email client).
205
-
206
-When creating a SSL certificate it's important that the private key (the private component of the public/private pair in [[https://en.wikipedia.org/wiki/Public-key_cryptography][public key cryptography]]) be generated on the Freedombone /and remain there/.  Don't generate the private key via the StartSSL certificate wizard because this means that potentially they may retain a copy of it which could then be exfiltrated either via [[https://en.wikipedia.org/wiki/Lavabit][Lavabit]] style methodology, "implants", compromised sysadmins or other "side channel" methods.  So that the private key isn't broadcast on the internet we can instead generate a certificate request, which is really just a request for authorisation of a public key.
207
-
208
-Within StartSSL under the validations wizard validate your domain, which means sending an email to it and confirming a code.
209
-
210
-Now we can generate the certificate request as follows.
211
-
212
-#+BEGIN_SRC bash
213
-export HOSTNAME=mydomainname.com
214
-openssl genrsa -out /etc/ssl/private/$HOSTNAME.key 2048
215
-chown root:ssl-cert /etc/ssl/private/$HOSTNAME.key
216
-chmod 440 /etc/ssl/private/$HOSTNAME.key
217
-mkdir /etc/ssl/requests
218
-#+END_SRC
219
-
220
-Now make a certificate request as follows.  You should copy and paste the whole of this, not just line by line.
221
-
222
-#+BEGIN_SRC bash
223
-openssl req -new -sha256 -key /etc/ssl/private/$HOSTNAME.key -out /etc/ssl/requests/$HOSTNAME.csr
224
-#+END_SRC
225
-
226
-For the email address it's a good idea to use postmaster@mydomainname.
227
-
228
-Use a random 20 character password, and keep a note of it.  We'll remove this later.
229
-
230
-View the request with:
231
-
232
-#+BEGIN_SRC bash
233
-cat /etc/ssl/requests/$HOSTNAME.csr
234
-#+END_SRC
235
-
236
-You can then click on "skip" within the StartSSL certificates wizard and copy and paste the encrypted request into the text entry box.  A confirmation will be emailed back to you normally within a few hours.
237
-
238
-Log into your StartSSL account and select *Retrieve Certificate* from the *Tool Box* tab.  Copy the text.
239
-
240
-#+BEGIN_SRC bash
241
-editor /etc/ssl/certs/$HOSTNAME.crt
242
-#+END_SRC
243
-
244
-Paste the public key, then save and exit.  Then on the Freedombone.
245
-
246
-#+BEGIN_SRC bash
247
-mkdir /etc/ssl/roots
248
-mkdir /etc/ssl/chains
249
-wget "http://www.startssl.com/certs/ca.pem" --output-document="/etc/ssl/roots/startssl-root.ca"
250
-wget "http://www.startssl.com/certs/sub.class1.server.ca.pem" --output-document="/etc/ssl/chains/startssl-sub.class1.server.ca.pem"
251
-wget "http://www.startssl.com/certs/sub.class2.server.ca.pem" --output-document="/etc/ssl/chains/startssl-sub.class2.server.ca.pem"
252
-wget "http://www.startssl.com/certs/sub.class3.server.ca.pem" --output-document="/etc/ssl/chains/startssl-sub.class3.server.ca.pem"
253
-ln -s "/etc/ssl/roots/startssl-root.ca" "/etc/ssl/roots/$HOSTNAME-root.ca"
254
-ln -s "/etc/ssl/chains/startssl-sub.class1.server.ca.pem" "/etc/ssl/chains/$HOSTNAME.ca"
255
-cp "/etc/ssl/certs/$HOSTNAME.crt" "/etc/ssl/certs/$HOSTNAME.crt+chain+root"
256
-test -e "/etc/ssl/chains/$HOSTNAME.ca" && cat "/etc/ssl/chains/$HOSTNAME.ca" >> "/etc/ssl/certs/$HOSTNAME.crt+chain+root"
257
-test -e "/etc/ssl/roots/$HOSTNAME-root.ca" && cat "/etc/ssl/roots/$HOSTNAME-root.ca" >> "/etc/ssl/certs/$HOSTNAME.crt+chain+root"
258
-#+END_SRC
259
-
260
-To avoid any possibility of the certificates being accidentally overwritten by self-signed ones at a later date you can create backups.
261
-
262
-#+BEGIN_SRC bash
263
-mkdir /etc/ssl/backups
264
-mkdir /etc/ssl/backups/certs
265
-mkdir /etc/ssl/backups/private
266
-cp /etc/ssl/certs/$HOSTNAME* /etc/ssl/backups/certs/
267
-cp /etc/ssl/private/$HOSTNAME* /etc/ssl/backups/private/
268
-chmod -R 400 /etc/ssl/backups/certs/*
269
-chmod -R 400 /etc/ssl/backups/private/*
270
-#+END_SRC
271
-
272
-Remove the certificate password, so if the server is rebooted then it won't wait indefinitely for a non-existant keyboard user to type in a password.
273
-
274
-#+BEGIN_SRC bash
275
-openssl rsa -in /etc/ssl/private/$HOSTNAME.key -out /etc/ssl/private/$HOSTNAME.new.key
276
-cp /etc/ssl/private/$HOSTNAME.new.key /etc/ssl/private/$HOSTNAME.key
277
-shred -zu /etc/ssl/private/$HOSTNAME.new.key
278
-#+END_SRC
279
-
280
-Create a bundled certificate which joins the certificate and chain file together.
281
-
282
-#+BEGIN_SRC bash
283
-cat /etc/ssl/certs/$HOSTNAME.crt /etc/ssl/chains/startssl-sub.class1.server.ca.pem > /etc/ssl/certs/$HOSTNAME.bundle.crt
284
-#+END_SRC
285
-
286
-And also add it to the overall bundle of certificates for the Freedombone. This will allow you to easily install the certificates onto other systems.
287
-
288
-#+BEGIN_SRC bash
289
-mkdir /etc/ssl/mycerts
290
-cp /etc/ssl/certs/$HOSTNAME.bundle.crt /etc/ssl/mycerts
291
-cat /etc/ssl/mycerts/*.crt > /etc/ssl/freedombone-bundle.crt
292
-tar -czvf /etc/ssl/freedombone-certs.tar.gz /etc/ssl/mycerts/*.crt
293
-#+END_SRC
294
-
295
-Edit your configuration file.
296
-
297
-#+BEGIN_SRC bash
298
-editor /etc/nginx/sites-available/$HOSTNAME
299
-#+END_SRC
300
-
301
-Add the following to the section which starts with *listen 443*
302
-
303
-#+BEGIN_SRC bash
304
-    ssl_certificate /etc/ssl/certs/mydomainname.com.bundle.crt;
305
-#+END_SRC
306
-
307
-Save and exit, then restart the web server.
204
+* How do I get a "real" SSL/TLS/HTTPS certificate?
205
+If you did the full install or selected the social variant then the system will have tried to obtain a Let's Encrypt certificate automatically during the install process. If this failed for any reason, or if you have created a new site which you need a certificate for then do the following:
308
 
206
 
309
 #+BEGIN_SRC bash
207
 #+BEGIN_SRC bash
310
-service nginx restart
208
+ssh username@mydomainname -p 2222
209
+sudo control
311
 #+END_SRC
210
 #+END_SRC
312
 
211
 
313
-Now visit your web site at https://mydomainname.com and you should notice that there is no certificate warning displayed.  You will now be able to install systems which don't allow the use of self-signed certificates, such as [[https://github.com/redmatrix/hubzilla][Hubzilla]].
314
-
315
-* How do I renew a StartSSL certificate?
316
-The StartSSL certificates last for a year. You can check the expiry date of your current certificate/s by going to your site and if you're using Firefox then click on the *lock icon*, select "*more information*" then "*view certificate*".
317
-
318
-Before changing any certificates it's a good idea to make a backup of the existing system. Use /Backup and Restore/ from the control panel to make a backup of the system to a USB drive. Backing up may take a while, but it ensures that if anything goes wrong and you mess up the certificates then there is a way to restore the previous ones.
212
+Select *Security settings* then *Create a new Encrypt certificate*.
319
 
213
 
320
-Make sure that you have the StartSSL certificate which was created when you initially made an account. You did save it somewhere safe, didn't you? If it's not installed into your browser then in Firefox go to *Menu/Preferences/Advanced/View Certificates*. Make sure the "*Your Cerificates*" tab is selected and click "*import*", then import the StartSSL certificate.
214
+One thing to be aware of is that Let's Encrypt doesn't support many dynamic DNS subdomains, such as those from freeDNS, so to run Hubzilla and GNU Social you will need to have your own official domains for those. There are many sites from which you can buy cheap domain names, and while this isn't ideal in terms of making you dependent upon another company it's the only option currently.
215
+* How do I renew a Let's Encrypt certificate?
216
+Normally certificates will be automatically renewed once per month, so you don't need to be concerned about it. If anything goes wrong with the automatic renewal then you should receive a warning email.
321
 
217
 
322
-Now go to [[https://startssl.com][startssl.com]] and click on the keys icon on the right hand side to log in. Select the *Control panel* then *Validations Wizard* and choose *Email address validation*. Enter your email address, then wait for the validation email to show up in your inbox. It will contain a code when you can then enter.
323
-
324
-Once your email is validated then go to *Validations Wizard* and choose *Domain name validation*. Enter your domain name and select *postmaster@yourdomainname*. After a while you should receive a validation email and you can then enter the code.
325
-
326
-Log in to the Freedombone, become the root user, then issue the renew command:
218
+If you need to manually renew a certificate:
327
 
219
 
328
 #+BEGIN_SRC bash
220
 #+BEGIN_SRC bash
329
 ssh username@mydomainname -p 2222
221
 ssh username@mydomainname -p 2222
330
-su
331
-freedombone-renew-cert -h mydomainname -p startssl
222
+sudo control
332
 #+END_SRC
223
 #+END_SRC
333
 
224
 
334
-For the email address it's a good idea to use /postmaster@mydomainname/.
335
-
336
-Use a random 20 character password, and keep a note of it.  We'll remove this later.
337
-
338
-On the StartSSL site select *Certificates Wizard* then *Web server SSL/TLS Certificate*. You can then click on "skip" and then copy and paste the certificate request into the text entry box. You may now need to wait a few hours for a confirmation email indicating that the new certificate was created.
339
-
340
-Select *Tool Box* and then *Retrieve Certificate* from the list. Make sure to choose the one with the correct expiration date.  Copy the text, then on the Freedombone.
225
+Select *Security settings* then *Renew Let's Encrypt certificate*.
226
+* I tried to renew a Let's Encrypt certificate and it failed. What should I do?
227
+Most likely it's because Let's Encrypt doesn't support your particular domain or subdomain. Currently free subdomains tend not to work. You'll need to buy a domain name, link it to your dynamic DNS account and then do:
341
 
228
 
342
 #+BEGIN_SRC bash
229
 #+BEGIN_SRC bash
343
-editor /etc/ssl/certs/mydomainname.new.crt
230
+ssh username@mydomainname -p 2222
231
+sudo control
344
 #+END_SRC
232
 #+END_SRC
345
 
233
 
346
-Paste the public key from the StartSSL site. Save and exit.  Then run the renew command again:
234
+Select *Security settings* then *Create a new Encrypt certificate*.
235
+* Why use self-signed certificates?
236
+Almost everywhere on the web you will read that self-signed certificates are worthless. They bring up /scary-scary looking/ browser warnings and gurus will advise you not to use them. Self-signed certificates are quite useful though. What the scary warnings mean - and it would be good if they explained this more clearly - is that you have an encrypted connection established but there is /no certainty about who that connection is with/.
347
 
237
 
348
-#+BEGIN_SRC bash
349
-freedombone-renew-cert -h mydomainname
350
-#+END_SRC
238
+The usual solution to this is to get a "real" SSL certificate from one of the certificate authorities, but it's far from clear that such authorities can actually be trusted. Yes, /Let's Encrypt/ is awesome and very convenient but it's really a small sticking plaster over a much bigger problem. If you don't believe me then do some independent research on the history of certificate authorities and the scandals associated with them, then consider how many of those within your browser (usually under advanced settings) are "trusted". Some of those "trusted" certs are for companies with /incredibly sketchy reputations/, or governments such as that of China. Consider whether you judge the Chinese government to always be truthful about which certificate belongs to which domain, and that it will never abuse such a capability for censorship or political/commercial advantage. Then you'll begin to get an idea of the ramshackle nature of what currently exists.
351
 
239
 
352
-The new certificate will then be installed.
353
-* Why use self-signed certificates?
354
-Almost everywhere on the web you will read that self-signed certificates are worthless. They bring up scary looking browser warnings and gurus will advise you not to use them. Self-signed certificates are quite useful though. What the scary warnings mean - and it would be good if they explained this more clearly - is that you have an encrypted connection established but there is /no certainty about who that connection is with/. The usual solution to this is to get a "real" SSL certificate from one of the certificate authorities, but it's far from clear that such authorities can be trusted. There have been various scandals involving such organisations, and it does not seem plausible to assume that they are somehow immune to the sort of treatment which [[http://en.wikipedia.org/wiki/Lavabit][Lavabit]] received. So although most internet users have been trained to look for the lock icon as an indication that the connection is secured that belief may not always be well founded.
240
+So although most internet users have been trained to look for the lock icon as an indication that the connection is secured that belief may not always be well founded.
355
 
241
 
356
-Security of web sites on the internet is still a somewhat unsolved problem, and what we have now is a less than ideal but /good enough to fool most of the people most of the time/ kind of arrangement. Long term a better solution might be to have a number of certificate authorities in a number of different jurisdictions vote on whether a given certificate actually belongs to a given domain name. Experimental systems like this exist, but they're not widely used. Since the current certificate system has an enormous amount of inertia behind it change could be slow in arriving.
242
+Despite the hype, security of web sites on the internet is still a somewhat unsolved problem, and what we have now is a less than ideal but /good enough to fool most of the people most of the time/ kind of arrangement. Long term a better solution might be to have a number of certificate authorities in a number of different jurisdictions vote on whether a given certificate actually belongs to a given domain name. Experimental systems like this exist, but they're not widely used. Since the current certificate system has an enormous amount of inertia behind it change could be slow in arriving.
357
 
243
 
358
 For now a self-signed certificate will probably in most cases protect your communications from "bulk" passive surveillance. Once you've got past the scary browser warning and accepted the certificate under most conditions (except when starting up the Tor browser) you should not repeatedly see that warning. If you do then someone may be trying to meddle with your connection to the server. You can also take a note of the fingerprint of the certificate and verify that if you are especially concerned. If the fingerprint remains the same then you're probably ok.
244
 For now a self-signed certificate will probably in most cases protect your communications from "bulk" passive surveillance. Once you've got past the scary browser warning and accepted the certificate under most conditions (except when starting up the Tor browser) you should not repeatedly see that warning. If you do then someone may be trying to meddle with your connection to the server. You can also take a note of the fingerprint of the certificate and verify that if you are especially concerned. If the fingerprint remains the same then you're probably ok.
359
 * Why not use the services of $company instead? They took the Seppuku pledge
245
 * Why not use the services of $company instead? They took the Seppuku pledge

+ 44
- 217
website/EN/faq.html Voir le fichier

3
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
4
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5
 <head>
5
 <head>
6
-<!-- 2015-12-18 Fri 22:28 -->
6
+<!-- 2015-12-19 Sat 19:26 -->
7
 <meta  http-equiv="Content-Type" content="text/html;charset=utf-8" />
7
 <meta  http-equiv="Content-Type" content="text/html;charset=utf-8" />
8
 <meta  name="viewport" content="width=device-width, initial-scale=1" />
8
 <meta  name="viewport" content="width=device-width, initial-scale=1" />
9
 <title></title>
9
 <title></title>
213
 </tr>
213
 </tr>
214
 
214
 
215
 <tr>
215
 <tr>
216
-<td class="org-left"><a href="#orgheadline11">How do I get a "real" SSL certificate?</a></td>
216
+<td class="org-left"><a href="#orgheadline11">How do I get a "real" SSL/TLS/HTTPS certificate?</a></td>
217
 </tr>
217
 </tr>
218
 
218
 
219
 <tr>
219
 <tr>
220
-<td class="org-left"><a href="#orgheadline12">How do I renew a StartSSL certificate?</a></td>
220
+<td class="org-left"><a href="#orgheadline12">How do I renew a Let's Encrypt certificate?</a></td>
221
 </tr>
221
 </tr>
222
 
222
 
223
 <tr>
223
 <tr>
224
-<td class="org-left"><a href="#orgheadline13">Why use self-signed certificates?</a></td>
224
+<td class="org-left"><a href="#orgheadline13">I tried to renew a Let's Encrypt certificate and it failed. What should I do?</a></td>
225
 </tr>
225
 </tr>
226
 
226
 
227
 <tr>
227
 <tr>
228
-<td class="org-left"><a href="#orgheadline14">Why not use the services of $company instead? They took the Seppuku pledge</a></td>
228
+<td class="org-left"><a href="#orgheadline14">Why use self-signed certificates?</a></td>
229
 </tr>
229
 </tr>
230
 
230
 
231
 <tr>
231
 <tr>
232
-<td class="org-left"><a href="#orgheadline15">Why does my email keep getting rejected as spam by Gmail/etc?</a></td>
232
+<td class="org-left"><a href="#orgheadline15">Why not use the services of $company instead? They took the Seppuku pledge</a></td>
233
+</tr>
234
+
235
+<tr>
236
+<td class="org-left"><a href="#orgheadline16">Why does my email keep getting rejected as spam by Gmail/etc?</a></td>
233
 </tr>
237
 </tr>
234
 </tbody>
238
 </tbody>
235
 </table>
239
 </table>
552
 </div>
556
 </div>
553
 
557
 
554
 <div id="outline-container-orgheadline11" class="outline-2">
558
 <div id="outline-container-orgheadline11" class="outline-2">
555
-<h2 id="orgheadline11">How do I get a "real" SSL certificate?</h2>
559
+<h2 id="orgheadline11">How do I get a "real" SSL/TLS/HTTPS certificate?</h2>
556
 <div class="outline-text-2" id="text-orgheadline11">
560
 <div class="outline-text-2" id="text-orgheadline11">
557
 <p>
561
 <p>
558
-You can obtain a free "official" (as in recognised by default by web browsers) SSL certificate from <a href="https://www.startssl.com/">StartSSL</a>. You will first need to have bought a domain name, since it's not possible to obtain one for a freedns subdomain, so see <a href="#orgheadline10">Using your own domain</a> for details of how to do that.  You should also have tested that you can send email to the domain and receive it on the Freedombone (via Mutt or any other email client).
559
-</p>
560
-
561
-<p>
562
-When creating a SSL certificate it's important that the private key (the private component of the public/private pair in <a href="https://en.wikipedia.org/wiki/Public-key_cryptography">public key cryptography</a>) be generated on the Freedombone <i>and remain there</i>.  Don't generate the private key via the StartSSL certificate wizard because this means that potentially they may retain a copy of it which could then be exfiltrated either via <a href="https://en.wikipedia.org/wiki/Lavabit">Lavabit</a> style methodology, "implants", compromised sysadmins or other "side channel" methods.  So that the private key isn't broadcast on the internet we can instead generate a certificate request, which is really just a request for authorisation of a public key.
563
-</p>
564
-
565
-<p>
566
-Within StartSSL under the validations wizard validate your domain, which means sending an email to it and confirming a code.
567
-</p>
568
-
569
-<p>
570
-Now we can generate the certificate request as follows.
571
-</p>
572
-
573
-<div class="org-src-container">
574
-
575
-<pre class="src src-bash"><span class="org-builtin">export</span> <span class="org-variable-name">HOSTNAME</span>=mydomainname.com
576
-openssl genrsa -out /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.key 2048
577
-chown root:ssl-cert /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.key
578
-chmod 440 /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.key
579
-mkdir /etc/ssl/requests
580
-</pre>
581
-</div>
582
-
583
-<p>
584
-Now make a certificate request as follows.  You should copy and paste the whole of this, not just line by line.
562
+If you did the full install or selected the social variant then the system will have tried to obtain a Let's Encrypt certificate automatically during the install process. If this failed for any reason, or if you have created a new site which you need a certificate for then do the following:
585
 </p>
563
 </p>
586
 
564
 
587
 <div class="org-src-container">
565
 <div class="org-src-container">
588
 
566
 
589
-<pre class="src src-bash">openssl req -new -sha256 -key /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.key -out /etc/ssl/requests/$<span class="org-variable-name">HOSTNAME</span>.csr
567
+<pre class="src src-bash">ssh username@mydomainname -p 2222
568
+sudo control
590
 </pre>
569
 </pre>
591
 </div>
570
 </div>
592
 
571
 
593
 <p>
572
 <p>
594
-For the email address it's a good idea to use postmaster@mydomainname.
595
-</p>
596
-
597
-<p>
598
-Use a random 20 character password, and keep a note of it.  We'll remove this later.
573
+Select <b>Security settings</b> then <b>Create a new Encrypt certificate</b>.
599
 </p>
574
 </p>
600
 
575
 
601
 <p>
576
 <p>
602
-View the request with:
577
+One thing to be aware of is that Let's Encrypt doesn't support many dynamic DNS subdomains, such as those from freeDNS, so to run Hubzilla and GNU Social you will need to have your own official domains for those. There are many sites from which you can buy cheap domain names, and while this isn't ideal in terms of making you dependent upon another company it's the only option currently.
603
 </p>
578
 </p>
604
-
605
-<div class="org-src-container">
606
-
607
-<pre class="src src-bash">cat /etc/ssl/requests/$<span class="org-variable-name">HOSTNAME</span>.csr
608
-</pre>
609
 </div>
579
 </div>
610
-
611
-<p>
612
-You can then click on "skip" within the StartSSL certificates wizard and copy and paste the encrypted request into the text entry box.  A confirmation will be emailed back to you normally within a few hours.
613
-</p>
614
-
615
-<p>
616
-Log into your StartSSL account and select <b>Retrieve Certificate</b> from the <b>Tool Box</b> tab.  Copy the text.
617
-</p>
618
-
619
-<div class="org-src-container">
620
-
621
-<pre class="src src-bash">editor /etc/ssl/certs/$<span class="org-variable-name">HOSTNAME</span>.crt
622
-</pre>
623
 </div>
580
 </div>
624
-
581
+<div id="outline-container-orgheadline12" class="outline-2">
582
+<h2 id="orgheadline12">How do I renew a Let's Encrypt certificate?</h2>
583
+<div class="outline-text-2" id="text-orgheadline12">
625
 <p>
584
 <p>
626
-Paste the public key, then save and exit.  Then on the Freedombone.
585
+Normally certificates will be automatically renewed once per month, so you don't need to be concerned about it. If anything goes wrong with the automatic renewal then you should receive a warning email.
627
 </p>
586
 </p>
628
 
587
 
629
-<div class="org-src-container">
630
-
631
-<pre class="src src-bash">mkdir /etc/ssl/roots
632
-mkdir /etc/ssl/chains
633
-wget <span class="org-string">"http://www.startssl.com/certs/ca.pem"</span> --output-document=<span class="org-string">"/etc/ssl/roots/startssl-root.ca"</span>
634
-wget <span class="org-string">"http://www.startssl.com/certs/sub.class1.server.ca.pem"</span> --output-document=<span class="org-string">"/etc/ssl/chains/startssl-sub.class1.server.ca.pem"</span>
635
-wget <span class="org-string">"http://www.startssl.com/certs/sub.class2.server.ca.pem"</span> --output-document=<span class="org-string">"/etc/ssl/chains/startssl-sub.class2.server.ca.pem"</span>
636
-wget <span class="org-string">"http://www.startssl.com/certs/sub.class3.server.ca.pem"</span> --output-document=<span class="org-string">"/etc/ssl/chains/startssl-sub.class3.server.ca.pem"</span>
637
-ln -s <span class="org-string">"/etc/ssl/roots/startssl-root.ca"</span> <span class="org-string">"/etc/ssl/roots/$HOSTNAME-root.ca"</span>
638
-ln -s <span class="org-string">"/etc/ssl/chains/startssl-sub.class1.server.ca.pem"</span> <span class="org-string">"/etc/ssl/chains/$HOSTNAME.ca"</span>
639
-cp <span class="org-string">"/etc/ssl/certs/$HOSTNAME.crt"</span> <span class="org-string">"/etc/ssl/certs/$HOSTNAME.crt+chain+root"</span>
640
-<span class="org-builtin">test</span> -e <span class="org-string">"/etc/ssl/chains/$HOSTNAME.ca"</span> &amp;&amp; cat <span class="org-string">"/etc/ssl/chains/$HOSTNAME.ca"</span> &gt;&gt; <span class="org-string">"/etc/ssl/certs/$HOSTNAME.crt+chain+root"</span>
641
-<span class="org-builtin">test</span> -e <span class="org-string">"/etc/ssl/roots/$HOSTNAME-root.ca"</span> &amp;&amp; cat <span class="org-string">"/etc/ssl/roots/$HOSTNAME-root.ca"</span> &gt;&gt; <span class="org-string">"/etc/ssl/certs/$HOSTNAME.crt+chain+root"</span>
642
-</pre>
643
-</div>
644
-
645
 <p>
588
 <p>
646
-To avoid any possibility of the certificates being accidentally overwritten by self-signed ones at a later date you can create backups.
589
+If you need to manually renew a certificate:
647
 </p>
590
 </p>
648
 
591
 
649
 <div class="org-src-container">
592
 <div class="org-src-container">
650
 
593
 
651
-<pre class="src src-bash">mkdir /etc/ssl/backups
652
-mkdir /etc/ssl/backups/certs
653
-mkdir /etc/ssl/backups/private
654
-cp /etc/ssl/certs/$<span class="org-variable-name">HOSTNAME</span>* /etc/ssl/backups/certs/
655
-cp /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>* /etc/ssl/backups/private/
656
-chmod -R 400 /etc/ssl/backups/certs/*
657
-chmod -R 400 /etc/ssl/backups/private/*
594
+<pre class="src src-bash">ssh username@mydomainname -p 2222
595
+sudo control
658
 </pre>
596
 </pre>
659
 </div>
597
 </div>
660
 
598
 
661
 <p>
599
 <p>
662
-Remove the certificate password, so if the server is rebooted then it won't wait indefinitely for a non-existant keyboard user to type in a password.
600
+Select <b>Security settings</b> then <b>Renew Let's Encrypt certificate</b>.
663
 </p>
601
 </p>
664
-
665
-<div class="org-src-container">
666
-
667
-<pre class="src src-bash">openssl rsa -in /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.key -out /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.new.key
668
-cp /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.new.key /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.key
669
-shred -zu /etc/ssl/private/$<span class="org-variable-name">HOSTNAME</span>.new.key
670
-</pre>
671
 </div>
602
 </div>
672
-
673
-<p>
674
-Create a bundled certificate which joins the certificate and chain file together.
675
-</p>
676
-
677
-<div class="org-src-container">
678
-
679
-<pre class="src src-bash">cat /etc/ssl/certs/$<span class="org-variable-name">HOSTNAME</span>.crt /etc/ssl/chains/startssl-sub.class1.server.ca.pem &gt; /etc/ssl/certs/$<span class="org-variable-name">HOSTNAME</span>.bundle.crt
680
-</pre>
681
-</div>
682
-
683
-<p>
684
-And also add it to the overall bundle of certificates for the Freedombone. This will allow you to easily install the certificates onto other systems.
685
-</p>
686
-
687
-<div class="org-src-container">
688
-
689
-<pre class="src src-bash">mkdir /etc/ssl/mycerts
690
-cp /etc/ssl/certs/$<span class="org-variable-name">HOSTNAME</span>.bundle.crt /etc/ssl/mycerts
691
-cat /etc/ssl/mycerts/*.crt &gt; /etc/ssl/freedombone-bundle.crt
692
-tar -czvf /etc/ssl/freedombone-certs.tar.gz /etc/ssl/mycerts/*.crt
693
-</pre>
694
 </div>
603
 </div>
695
-
696
-<p>
697
-Edit your configuration file.
698
-</p>
699
-
700
-<div class="org-src-container">
701
-
702
-<pre class="src src-bash">editor /etc/nginx/sites-available/$<span class="org-variable-name">HOSTNAME</span>
703
-</pre>
704
-</div>
705
-
706
-<p>
707
-Add the following to the section which starts with <b>listen 443</b>
708
-</p>
709
-
710
-<div class="org-src-container">
711
-
712
-<pre class="src src-bash">ssl_certificate /etc/ssl/certs/mydomainname.com.bundle.crt;
713
-</pre>
714
-</div>
715
-
604
+<div id="outline-container-orgheadline13" class="outline-2">
605
+<h2 id="orgheadline13">I tried to renew a Let's Encrypt certificate and it failed. What should I do?</h2>
606
+<div class="outline-text-2" id="text-orgheadline13">
716
 <p>
607
 <p>
717
-Save and exit, then restart the web server.
608
+Most likely it's because Let's Encrypt doesn't support your particular domain or subdomain. Currently free subdomains tend not to work. You'll need to buy a domain name, link it to your dynamic DNS account and then do:
718
 </p>
609
 </p>
719
 
610
 
720
 <div class="org-src-container">
611
 <div class="org-src-container">
721
 
612
 
722
-<pre class="src src-bash">service nginx restart
613
+<pre class="src src-bash">ssh username@mydomainname -p 2222
614
+sudo control
723
 </pre>
615
 </pre>
724
 </div>
616
 </div>
725
 
617
 
726
 <p>
618
 <p>
727
-Now visit your web site at <a href="https://mydomainname.com/">https://mydomainname.com/</a> and you should notice that there is no certificate warning displayed.  You will now be able to install systems which don't allow the use of self-signed certificates, such as <a href="https://github.com/redmatrix/hubzilla">Hubzilla</a>.
619
+Select <b>Security settings</b> then <b>Create a new Encrypt certificate</b>.
728
 </p>
620
 </p>
729
 </div>
621
 </div>
730
 </div>
622
 </div>
731
-
732
-<div id="outline-container-orgheadline12" class="outline-2">
733
-<h2 id="orgheadline12">How do I renew a StartSSL certificate?</h2>
734
-<div class="outline-text-2" id="text-orgheadline12">
735
-<p>
736
-The StartSSL certificates last for a year. You can check the expiry date of your current certificate/s by going to your site and if you're using Firefox then click on the <b>lock icon</b>, select "<b>more information</b>" then "<b>view certificate</b>".
737
-</p>
738
-
739
-<p>
740
-Before changing any certificates it's a good idea to make a backup of the existing system. Use <i>Backup and Restore</i> from the control panel to make a backup of the system to a USB drive. Backing up may take a while, but it ensures that if anything goes wrong and you mess up the certificates then there is a way to restore the previous ones.
741
-</p>
742
-
743
-<p>
744
-Make sure that you have the StartSSL certificate which was created when you initially made an account. You did save it somewhere safe, didn't you? If it's not installed into your browser then in Firefox go to <b>Menu/Preferences/Advanced/View Certificates</b>. Make sure the "<b>Your Cerificates</b>" tab is selected and click "<b>import</b>", then import the StartSSL certificate.
745
-</p>
746
-
747
-<p>
748
-Now go to <a href="https://startssl.com/">startssl.com</a> and click on the keys icon on the right hand side to log in. Select the <b>Control panel</b> then <b>Validations Wizard</b> and choose <b>Email address validation</b>. Enter your email address, then wait for the validation email to show up in your inbox. It will contain a code when you can then enter.
749
-</p>
750
-
751
-<p>
752
-Once your email is validated then go to <b>Validations Wizard</b> and choose <b>Domain name validation</b>. Enter your domain name and select <b>postmaster@yourdomainname</b>. After a while you should receive a validation email and you can then enter the code.
753
-</p>
754
-
755
-<p>
756
-Log in to the Freedombone, become the root user, then issue the renew command:
757
-</p>
758
-
759
-<div class="org-src-container">
760
-
761
-<pre class="src src-bash">ssh username@mydomainname -p 2222
762
-su
763
-freedombone-renew-cert -h mydomainname -p startssl
764
-</pre>
765
-</div>
766
-
623
+<div id="outline-container-orgheadline14" class="outline-2">
624
+<h2 id="orgheadline14">Why use self-signed certificates?</h2>
625
+<div class="outline-text-2" id="text-orgheadline14">
767
 <p>
626
 <p>
768
-For the email address it's a good idea to use <i>postmaster@mydomainname</i>.
627
+Almost everywhere on the web you will read that self-signed certificates are worthless. They bring up <i>scary-scary looking</i> browser warnings and gurus will advise you not to use them. Self-signed certificates are quite useful though. What the scary warnings mean - and it would be good if they explained this more clearly - is that you have an encrypted connection established but there is <i>no certainty about who that connection is with</i>.
769
 </p>
628
 </p>
770
 
629
 
771
 <p>
630
 <p>
772
-Use a random 20 character password, and keep a note of it.  We'll remove this later.
631
+The usual solution to this is to get a "real" SSL certificate from one of the certificate authorities, but it's far from clear that such authorities can actually be trusted. Yes, <i>Let's Encrypt</i> is awesome and very convenient but it's really a small sticking plaster over a much bigger problem. If you don't believe me then do some independent research on the history of certificate authorities and the scandals associated with them, then consider how many of those within your browser (usually under advanced settings) are "trusted". Some of those "trusted" certs are for companies with <i>incredibly sketchy reputations</i>, or governments such as that of China. Consider whether you judge the Chinese government to always be truthful about which certificate belongs to which domain, and that it will never abuse such a capability for censorship or political/commercial advantage. Then you'll begin to get an idea of the ramshackle nature of what currently exists.
773
 </p>
632
 </p>
774
 
633
 
775
 <p>
634
 <p>
776
-On the StartSSL site select <b>Certificates Wizard</b> then <b>Web server SSL/TLS Certificate</b>. You can then click on "skip" and then copy and paste the certificate request into the text entry box. You may now need to wait a few hours for a confirmation email indicating that the new certificate was created.
635
+So although most internet users have been trained to look for the lock icon as an indication that the connection is secured that belief may not always be well founded.
777
 </p>
636
 </p>
778
 
637
 
779
 <p>
638
 <p>
780
-Select <b>Tool Box</b> and then <b>Retrieve Certificate</b> from the list. Make sure to choose the one with the correct expiration date.  Copy the text, then on the Freedombone.
781
-</p>
782
-
783
-<div class="org-src-container">
784
-
785
-<pre class="src src-bash">editor /etc/ssl/certs/mydomainname.new.crt
786
-</pre>
787
-</div>
788
-
789
-<p>
790
-Paste the public key from the StartSSL site. Save and exit.  Then run the renew command again:
791
-</p>
792
-
793
-<div class="org-src-container">
794
-
795
-<pre class="src src-bash">freedombone-renew-cert -h mydomainname
796
-</pre>
797
-</div>
798
-
799
-<p>
800
-The new certificate will then be installed.
801
-</p>
802
-</div>
803
-</div>
804
-<div id="outline-container-orgheadline13" class="outline-2">
805
-<h2 id="orgheadline13">Why use self-signed certificates?</h2>
806
-<div class="outline-text-2" id="text-orgheadline13">
807
-<p>
808
-Almost everywhere on the web you will read that self-signed certificates are worthless. They bring up scary looking browser warnings and gurus will advise you not to use them. Self-signed certificates are quite useful though. What the scary warnings mean - and it would be good if they explained this more clearly - is that you have an encrypted connection established but there is <i>no certainty about who that connection is with</i>. The usual solution to this is to get a "real" SSL certificate from one of the certificate authorities, but it's far from clear that such authorities can be trusted. There have been various scandals involving such organisations, and it does not seem plausible to assume that they are somehow immune to the sort of treatment which <a href="http://en.wikipedia.org/wiki/Lavabit">Lavabit</a> received. So although most internet users have been trained to look for the lock icon as an indication that the connection is secured that belief may not always be well founded.
809
-</p>
810
-
811
-<p>
812
-Security of web sites on the internet is still a somewhat unsolved problem, and what we have now is a less than ideal but <i>good enough to fool most of the people most of the time</i> kind of arrangement. Long term a better solution might be to have a number of certificate authorities in a number of different jurisdictions vote on whether a given certificate actually belongs to a given domain name. Experimental systems like this exist, but they're not widely used. Since the current certificate system has an enormous amount of inertia behind it change could be slow in arriving.
639
+Despite the hype, security of web sites on the internet is still a somewhat unsolved problem, and what we have now is a less than ideal but <i>good enough to fool most of the people most of the time</i> kind of arrangement. Long term a better solution might be to have a number of certificate authorities in a number of different jurisdictions vote on whether a given certificate actually belongs to a given domain name. Experimental systems like this exist, but they're not widely used. Since the current certificate system has an enormous amount of inertia behind it change could be slow in arriving.
813
 </p>
640
 </p>
814
 
641
 
815
 <p>
642
 <p>
817
 </p>
644
 </p>
818
 </div>
645
 </div>
819
 </div>
646
 </div>
820
-<div id="outline-container-orgheadline14" class="outline-2">
821
-<h2 id="orgheadline14">Why not use the services of $company instead? They took the Seppuku pledge</h2>
822
-<div class="outline-text-2" id="text-orgheadline14">
647
+<div id="outline-container-orgheadline15" class="outline-2">
648
+<h2 id="orgheadline15">Why not use the services of $company instead? They took the Seppuku pledge</h2>
649
+<div class="outline-text-2" id="text-orgheadline15">
823
 <p>
650
 <p>
824
 <a href="http://seppuku.cryptostorm.org/">That pledge</a> is utterly worthless. Years ago people trusted Google in the same sort of way, because they promised not be be evil and because a lot of the engineers working for them seemed like honest types who were "<i>on our side</i>". Post-<a href="https://en.wikipedia.org/wiki/Nymwars">nymwars</a> and post-<a href="https://en.wikipedia.org/wiki/PRISM_(surveillance_program)">PRISM</a> we know exactly how much Google cared about the privacy and security of its users. But Google is only one particular example. In general don't trust pledges made by companies, even if the people running them seem really sincere.
651
 <a href="http://seppuku.cryptostorm.org/">That pledge</a> is utterly worthless. Years ago people trusted Google in the same sort of way, because they promised not be be evil and because a lot of the engineers working for them seemed like honest types who were "<i>on our side</i>". Post-<a href="https://en.wikipedia.org/wiki/Nymwars">nymwars</a> and post-<a href="https://en.wikipedia.org/wiki/PRISM_(surveillance_program)">PRISM</a> we know exactly how much Google cared about the privacy and security of its users. But Google is only one particular example. In general don't trust pledges made by companies, even if the people running them seem really sincere.
825
 </p>
652
 </p>
826
 </div>
653
 </div>
827
 </div>
654
 </div>
828
-<div id="outline-container-orgheadline15" class="outline-2">
829
-<h2 id="orgheadline15">Why does my email keep getting rejected as spam by Gmail/etc?</h2>
830
-<div class="outline-text-2" id="text-orgheadline15">
655
+<div id="outline-container-orgheadline16" class="outline-2">
656
+<h2 id="orgheadline16">Why does my email keep getting rejected as spam by Gmail/etc?</h2>
657
+<div class="outline-text-2" id="text-orgheadline16">
831
 <p>
658
 <p>
832
 Welcome to the world of email. Email is really the archetypal decentralized service, developed during the early days of the internet. In principle anyone can run an email server, and that's exactly what you're doing with Freedombone. Email is very useful, but it has a big problem, and that's that the protocols are totally insecure. That made it easy for spammers to do their thing, and in response highly elaborate spam filtering and blocking systems were developed. Chances are that your emails are being blocked in this way. Sometimes the blocking is so indisciminate that entire countries are excluded. What can you do about it? Unless you control the block list at the receiving end probably you can't do anything. There is zero accountability for such blocking, and you can't just contact someone and say "hey, I'm not a spammer". This system works well for the big internet companies because it effectively centralises email to a few well-known brand names and keeps any independent servers out.
659
 Welcome to the world of email. Email is really the archetypal decentralized service, developed during the early days of the internet. In principle anyone can run an email server, and that's exactly what you're doing with Freedombone. Email is very useful, but it has a big problem, and that's that the protocols are totally insecure. That made it easy for spammers to do their thing, and in response highly elaborate spam filtering and blocking systems were developed. Chances are that your emails are being blocked in this way. Sometimes the blocking is so indisciminate that entire countries are excluded. What can you do about it? Unless you control the block list at the receiving end probably you can't do anything. There is zero accountability for such blocking, and you can't just contact someone and say "hey, I'm not a spammer". This system works well for the big internet companies because it effectively centralises email to a few well-known brand names and keeps any independent servers out.
833
 </p>
660
 </p>