freedombone/website/EN/app_keyserver.html

286 lines
11 KiB
HTML
Raw Normal View History

2017-07-28 23:42:48 +02:00
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<title></title>
2018-04-12 14:01:49 +02:00
<!-- 2018-04-12 Thu 12:20 -->
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<meta name="generator" content="Org-mode" />
<meta name="author" content="Bob Mottram" />
<meta name="description" content="How to use KEYSERVER"
2017-07-28 23:42:48 +02:00
/>
2018-04-12 14:01:49 +02:00
<meta name="keywords" content="freedombone, keyserver" />
2017-07-28 23:42:48 +02:00
<style type="text/css">
<!--/*--><![CDATA[/*><!--*/
2018-04-12 14:01:49 +02:00
.title { text-align: center; }
2017-07-28 23:42:48 +02:00
.todo { font-family: monospace; color: red; }
2018-04-12 14:01:49 +02:00
.done { color: green; }
2017-07-28 23:42:48 +02:00
.tag { background-color: #eee; font-family: monospace;
padding: 2px; font-size: 80%; font-weight: normal; }
.timestamp { color: #bebebe; }
.timestamp-kwd { color: #5f9ea0; }
2018-04-12 14:01:49 +02:00
.right { margin-left: auto; margin-right: 0px; text-align: right; }
.left { margin-left: 0px; margin-right: auto; text-align: left; }
.center { margin-left: auto; margin-right: auto; text-align: center; }
2017-07-28 23:42:48 +02:00
.underline { text-decoration: underline; }
#postamble p, #preamble p { font-size: 90%; margin: .2em; }
p.verse { margin-left: 3%; }
pre {
border: 1px solid #ccc;
box-shadow: 3px 3px 3px #eee;
padding: 8pt;
font-family: monospace;
overflow: auto;
margin: 1.2em;
}
pre.src {
position: relative;
overflow: visible;
padding-top: 1.2em;
}
pre.src:before {
display: none;
position: absolute;
background-color: white;
top: -10px;
right: 10px;
padding: 3px;
border: 1px solid black;
}
pre.src:hover:before { display: inline;}
2018-04-12 14:01:49 +02:00
pre.src-sh:before { content: 'sh'; }
pre.src-bash:before { content: 'sh'; }
2017-07-28 23:42:48 +02:00
pre.src-emacs-lisp:before { content: 'Emacs Lisp'; }
2018-04-12 14:01:49 +02:00
pre.src-R:before { content: 'R'; }
pre.src-perl:before { content: 'Perl'; }
pre.src-java:before { content: 'Java'; }
pre.src-sql:before { content: 'SQL'; }
2017-07-28 23:42:48 +02:00
table { border-collapse:collapse; }
caption.t-above { caption-side: top; }
caption.t-bottom { caption-side: bottom; }
td, th { vertical-align:top; }
2018-04-12 14:01:49 +02:00
th.right { text-align: center; }
th.left { text-align: center; }
th.center { text-align: center; }
td.right { text-align: right; }
td.left { text-align: left; }
td.center { text-align: center; }
2017-07-28 23:42:48 +02:00
dt { font-weight: bold; }
2018-04-12 14:01:49 +02:00
.footpara:nth-child(2) { display: inline; }
.footpara { display: block; }
2017-07-28 23:42:48 +02:00
.footdef { margin-bottom: 1em; }
.figure { padding: 1em; }
.figure p { text-align: center; }
.inlinetask {
padding: 10px;
border: 2px solid gray;
margin: 10px;
background: #ffffcc;
}
#org-div-home-and-up
{ text-align: right; font-size: 70%; white-space: nowrap; }
textarea { overflow-x: auto; }
.linenr { font-size: smaller }
.code-highlighted { background-color: #ffff00; }
.org-info-js_info-navigation { border-style: none; }
#org-info-js_console-label
{ font-size: 10px; font-weight: bold; white-space: nowrap; }
.org-info-js_search-highlight
{ background-color: #ffff00; color: #000000; font-weight: bold; }
/*]]>*/-->
</style>
<link rel="stylesheet" type="text/css" href="freedombone.css" />
<script type="text/javascript">
/*
@licstart The following is the entire license notice for the
JavaScript code in this tag.
2018-04-12 14:01:49 +02:00
Copyright (C) 2012-2013 Free Software Foundation, Inc.
2017-07-28 23:42:48 +02:00
The JavaScript code in this tag is free software: you can
redistribute it and/or modify it under the terms of the GNU
General Public License (GNU GPL) as published by the Free Software
Foundation, either version 3 of the License, or (at your option)
any later version. The code is distributed WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU GPL for more details.
As additional permission under GNU GPL version 3 section 7, you
may distribute non-source (e.g., minimized or compacted) forms of
that code without the copy of the GNU GPL normally required by
section 4, provided you include this license notice and a URL
through which recipients can access the Corresponding Source.
@licend The above is the entire license notice
for the JavaScript code in this tag.
*/
<!--/*--><![CDATA[/*><!--*/
function CodeHighlightOn(elem, id)
{
var target = document.getElementById(id);
if(null != target) {
elem.cacheClassElem = elem.className;
elem.cacheClassTarget = target.className;
target.className = "code-highlighted";
elem.className = "code-highlighted";
}
}
function CodeHighlightOff(elem, id)
{
var target = document.getElementById(id);
if(elem.cacheClassElem)
elem.className = elem.cacheClassElem;
if(elem.cacheClassTarget)
target.className = elem.cacheClassTarget;
}
/*]]>*///-->
</script>
</head>
<body>
<div id="preamble" class="status">
<a name="top" id="top"></a>
</div>
<div id="content">
2018-04-12 14:01:49 +02:00
<h1 class="title"></h1>
2017-07-28 23:42:48 +02:00
<div class="figure">
2018-04-12 14:01:49 +02:00
<p><img src="images/logo.png" alt="logo.png" width="80%" height="10%" align="center" />
2017-07-28 23:42:48 +02:00
</p>
</div>
2018-04-12 14:01:49 +02:00
<div id="outline-container-sec-1" class="outline-2">
<h2 id="sec-1">OpenPGP Key Server</h2>
<div class="outline-text-2" id="text-1">
2017-07-28 23:42:48 +02:00
<p>
2017-07-30 19:13:18 +02:00
The <i>web of trust</i> is a nice idea, but how trustable is it? If you take a look at how many OpenPGP key servers are out there then there are a two or three main ones and not much else. Can you trust those servers? Who is maintaining them and how often? Is any censorship going on? How hard would it be for adversaries to get implants onto them? In terms of technology this infrastructure is quite old and it could have been neglected for a long time. Once vigilant maintainers might have turned lazy and gotten lax with server security, or been recruited over to the dark side.
2017-07-28 23:42:48 +02:00
</p>
2017-07-30 19:13:18 +02:00
<p>
For these kinds of reasons you might prefer to run your own web of trust infrastructure. In simple terms it's a database of GPG public keys which provides a way for users to <i>find out how to communicate with others securely via email</i>. You can meet in person and exchange public keys via sneakernet on USB drives, but most users of GPG don't do that. Instead they just download the public key for a given email address from one of the key servers.
</p>
2017-07-30 19:19:21 +02:00
<div class="figure">
2018-04-12 14:01:49 +02:00
<p><img src="images/keyserver.jpg" alt="keyserver.jpg" width="80%" align="center" />
2017-07-30 19:19:21 +02:00
</p>
</div>
</div>
2018-04-12 14:01:49 +02:00
</div>
2017-07-30 19:19:21 +02:00
2018-04-12 14:01:49 +02:00
<div id="outline-container-sec-2" class="outline-2">
<h2 id="sec-2">Installation</h2>
<div class="outline-text-2" id="text-2">
2017-07-28 23:42:48 +02:00
<p>
ssh into the system with:
</p>
<div class="org-src-container">
2018-04-12 14:01:49 +02:00
<pre class="src src-bash">ssh myusername@mydomain.com -p 2222
</pre>
2017-07-28 23:42:48 +02:00
</div>
<p>
Select <b>Add/Remove Apps</b> then <b>keyserver</b>. You will then be asked for a domain name and if you are using FreeDNS also the code for the domain which can be found under <b>Dynamic DNS</b> on the FreeDNS site (the random string from "<i>quick cron example</i>" which appears after <i>update.php?</i> and before <i>&gt;&gt;</i>). For more details on obtaining a domain and making it accessible via dynamic DNS see the <a href="./faq.html">FAQ</a>. Typically the domain name you use will be a subdomain, such as <i>keys.mydomainname.net</i>. It will need to be a domain which you have bought somewhere and own and not one of the FreeDNS subdomains, otherwise you won't be able to get a SSL/TLS certificate for it.
</p>
<p>
After the install has completed go to <b>Security settings</b> and select <b>Create a new Let's Encrypt certificate</b> and enter the domain name that you are using for the Key server. If the certificate is obtained successfully then you will see a congratulations message.
</p>
</div>
2017-07-30 19:13:18 +02:00
</div>
2018-04-12 14:01:49 +02:00
<div id="outline-container-sec-3" class="outline-2">
<h2 id="sec-3">How to use it</h2>
<div class="outline-text-2" id="text-3">
2017-07-30 19:13:18 +02:00
<p>
Interaction with the web user interface is pretty minimal and obvious, but most likely you will also want to be able to use your keyserver from the commandline. To do that use the <b>&#x2013;keyserver</b> option. For example to search for a key on your server:
</p>
<div class="org-src-container">
2018-04-12 14:01:49 +02:00
<pre class="src src-bash">gpg --keyserver [your keyserver domain] --search-keys [email address]
</pre>
2017-07-30 19:13:18 +02:00
</div>
<p>
Or to send a key to it:
</p>
<div class="org-src-container">
2018-04-12 14:01:49 +02:00
<pre class="src src-bash">gpg --keyserver [your keyserver domain] --send-keys [email address or key ID]
</pre>
2017-07-30 19:13:18 +02:00
</div>
<p>
Or to get a key:
</p>
<div class="org-src-container">
2018-04-12 14:01:49 +02:00
<pre class="src src-bash">gpg --keyserver [your keyserver domain] --recv-keys [email address or key ID]
</pre>
2017-07-30 19:13:18 +02:00
</div>
</div>
</div>
2018-04-12 14:01:49 +02:00
<div id="outline-container-sec-4" class="outline-2">
<h2 id="sec-4">Sync with other keyservers</h2>
<div class="outline-text-2" id="text-4">
2017-07-30 19:13:18 +02:00
<p>
Key servers avoid censorship or errors by gossiping between each other and cross referencing the data. You can define which other servers your key server will gossip with by going to the <b>Administrator control panel</b>, selecting <b>App Settings</b> then <b>keyserver</b> then <b>Sync with other keyserver</b>.
</p>
<p>
It's a good idea not to try to sync with the popular OpenPGP key servers, because those have gigantic databases which may make your server unstable and certainly would make it hard to create backups within a tractable amount of time. This option is mainly intended to sync with other Freedombone systems or small home servers within a particular community.
</p>
</div>
</div>
2018-04-12 14:01:49 +02:00
<div id="outline-container-sec-5" class="outline-2">
<h2 id="sec-5">Possible problems</h2>
<div class="outline-text-2" id="text-5">
2017-07-30 19:13:18 +02:00
<p>
OpenPGP key servers are not very well defended from flooding attacks. This means that an adversary could just upload a billion keys to destabilize the server and fill it with nonsense to make it unusable. Since key servers are <i>fully open to the public</i> there isn't anything to prevent that from happening.
</p>
<p>
Within the Freedombone system there is a watchdog script which keeps track of the key server database size, and disables the key server if that gets too large. Apart from the usual firewall and web server traffic rate limits, this is a crude but probably practical way of defending against flooding.
</p>
<p>
If a flood attack does happen then really the only way to recover is to restore from the last known good backup, which can be done from the <b>Administrator control panel</b>.
</p>
</div>
</div>
</div>
2017-07-28 23:42:48 +02:00
<div id="postamble" class="status">
<style type="text/css">
.back-to-top {
position: fixed;
bottom: 2em;
right: 0px;
text-decoration: none;
color: #000000;
background-color: rgba(235, 235, 235, 0.80);
font-size: 12px;
padding: 1em;
display: none;
}
.back-to-top:hover {
background-color: rgba(135, 135, 135, 0.50);
}
</style>
<div class="back-to-top">
<a href="#top">Back to top</a> | <a href="mailto:bob@freedombone.net">E-mail me</a>
</div>
</div>
</body>
</html>