forked from 3wordchant/capsul-flask
352 lines
18 KiB
HTML
352 lines
18 KiB
HTML
{% extends 'base.html' %}
|
|
|
|
{% block title %}About SSH{% endblock %}
|
|
|
|
{% block content %}
|
|
<div class="row full-margin"><h1>Understanding the Secure Shell Protocol (SSH)</h1></div>
|
|
{% endblock %}
|
|
|
|
{% block subcontent %}
|
|
<div class="long-form">
|
|
<p>
|
|
In order to use our service, you will have to use the Secure Shell protocol (SSH) to connect to your capsul.
|
|
</p>
|
|
<p>
|
|
<a href="https://en.wikipedia.org/wiki/SSH_(Secure_Shell)">SSH</a> is a very old tool, created back when the internet was a different place, with different use cases and concerns.
|
|
In many ways, the protocol has failed to evolve to meet the needs of our 21st century global internet.
|
|
Instead, the users of SSH (tech heads, sysadmins, etc) have had to evolve our processes to work around SSH's limitations.
|
|
</p>
|
|
<p>
|
|
These days, we use SSH + public-key cryptography to establish secure connections to our servers.
|
|
If you are not familiar with the concept of public key cryptography, cryptographic signatures,
|
|
or diffie-hellman key exchange, you may wish to see
|
|
<a href="https://en.wikipedia.org/wiki/Public-key_cryptography">the wikipedia article</a> for a refresher.
|
|
</p>
|
|
|
|
<div class="row half-margin"><h1>Public Key Crypto and Key Exchange: The TL;DR</h1></div>
|
|
|
|
<p>
|
|
Computers can generate <b>"key pairs"</b> which consist of a public key and a private key. Given a <b>public key pair A</b>:
|
|
</p>
|
|
<ol>
|
|
<li>
|
|
A computer which has access to <b>public key A</b> can encrypt data,
|
|
and then <b>ONLY</b> a computer which has access <b>private key A</b> can decrypt & read it
|
|
</li>
|
|
<li>
|
|
Likewise, a computer which has access to <b>private key A</b> can encrypt data,
|
|
and any a computer which has access <b>public key A</b> can decrypt it,
|
|
thus <b>PROVING</b> the message must have come from someone who posesses <b>private key A</b>
|
|
</li>
|
|
</ol>
|
|
<p>
|
|
Key exchange is a process in which two computers, Computer A and Computer B (often referred to as Alice and Bob)
|
|
both create key pairs, so you have <b>key pair A</b> and <b>key pair B</b>, for a total of 4 keys:
|
|
</p>
|
|
<ol>
|
|
<li><b>public key A</b></li>
|
|
<li><b>private key A</b></li>
|
|
<li><b>public key B</b></li>
|
|
<li><b>private key B</b></li>
|
|
</ol>
|
|
<p>
|
|
In simplified terms, during a key exchange,
|
|
</p>
|
|
<ol>
|
|
<li><b>computer A</b> sends <b>computer B</b> its public key</li>
|
|
<li><b>computer B</b> sends <b>computer A</b> its public key</li>
|
|
<li><b>computer A</b> sends <b>computer B</b>
|
|
a message which is encrypted with <b>computer B</b>'s public key</li>
|
|
<li><b>computer B</b> sends <b>computer A</b>
|
|
a message which is encrypted with <b>computer A</b>'s public key</li>
|
|
</ol>
|
|
<p>
|
|
The way this process is carried out allows A and B to communicate with each-other securely, which is great, <br/><br/>
|
|
|
|
<b><u>HOWEVER, there is a catch!!</u></b>
|
|
</p>
|
|
|
|
<p>
|
|
When computers A and B are trying to establish a secure connection for the first time,
|
|
we assume that the way they communicate right now is NOT secure. That means that someone on the network
|
|
between A and B can read & modify
|
|
all messages they send to each-other! You might be able to see where this is heading...
|
|
</p>
|
|
<p>
|
|
When <b>computer A</b> sends its public key to <b>computer B</b>,
|
|
someone in the middle (lets call it <b>computer E, or Eve</b>) could record that message, save it,
|
|
and then replace it with a forged message to <b>computer B</b> containing <b>public key E</b>
|
|
(from a key pair that <b>computer E</b> generated).
|
|
|
|
If this happens, when <b>computer B</b> sends an encrypted message to <b>computer A</b>,
|
|
B thinks that A's public key is actually <b>public key E</b>, so it will use <b>public key E</b> to encrypt.
|
|
And again, <b>computer E</b> in the middle can intercept the message, and they can decrypt it as well
|
|
because they have <b>private key E</b>.
|
|
Finally, they can relay the same message to <b>computer A</b>, this time encrypted with <b>computer A</b>'s public key.
|
|
This is called a <a href="https://en.wikipedia.org/wiki/Man-in-the-middle_attack">Man In The Middle (MITM)</a> attack.
|
|
</p>
|
|
<p>
|
|
Without some additional verification method,
|
|
<b><u>Computer A AND Computer B can both be duped and the connection is NOT really secure</u></b>.
|
|
</p>
|
|
|
|
<div class="row half-margin"><h1>Authenticating Public Keys: A Tale of Two Protocols</h1></div>
|
|
|
|
<p>
|
|
Now that we have seen how key exhange works,
|
|
and we understand that in order to prevent MITM attacks, all participants have to have a way of knowing
|
|
whether a given public key is authentic or not, I can explain what I meant when I said
|
|
</p>
|
|
<p>
|
|
> [SSH] has failed to evolve to meet the needs of our 21st century global internet
|
|
</p>
|
|
<p>
|
|
In order to explain this, let's first look at how a different, more modern protocol,
|
|
<a href="https://en.wikipedia.org/wiki/Transport_Layer_Security">Transport Layer Security (or TLS)</a> solved this problem.
|
|
TLS, (still sometimes called by its olde name "Secure Sockets Layer", or SSL) was created to enable HTTPS, allow
|
|
internet users to log into web sites securely, and purchase things online by entering their credit card number.
|
|
Of course, this required security that actually works; if someone could MITM attack the connection, they could easily
|
|
steal tons of credit card numbers and passwords.
|
|
</p>
|
|
<p>
|
|
In order to enable this, a new standard called <a href="https://en.wikipedia.org/wiki/X.509">X.509</a> was created.
|
|
X.509 dictates the data format of certificates and keys (public keys and private keys), and it also defines
|
|
a simple and easy way to determine whether a given certificate (public key) is authentic.
|
|
X.509 introduced the concept of a Certificate Authority, or CA.
|
|
These CAs were supposed to be bank-like public institutions of power which everyone could trust.
|
|
The CA would create a key pair on an extremely secure computer, and then a CA Certificate (the public side of that key pair)
|
|
would be distributed along with every copy of Windows, Mac OS, and Linux. Then folks who wanted to run a secure web server
|
|
could generate thier OWN key pair for thier web server,
|
|
and pay the CA to sign thier web server's X.509 certificate (public key) with the highly protected CA private key.
|
|
Critically, issue date, expiration date, and the domain name of the web server, like foo.example.com, would have to be included
|
|
in the x.509 certiciate along with the public key.
|
|
This way, when the user types https://foo.example.com into thier web browser:
|
|
</p>
|
|
<ol>
|
|
<li>The web browser sends a TLS ClientHello request to the server</li>
|
|
<li>
|
|
The server responds with a ServerHello & ServerCertificate message
|
|
<ul>
|
|
<li>The ServerCertificate message contains the X.509 certificate for the web server at foo.example.com</li>
|
|
</ul>
|
|
</li>
|
|
<li>The web browser inspects the X.509 certificate
|
|
<ul>
|
|
<li>
|
|
Is the current date in between the issued date and expiry date of the certificate?
|
|
If not, display an <a href="https://expired.badssl.com/">EXPIRED_CERTIFICATE error</a>.
|
|
</li>
|
|
<li>
|
|
Does the domain name the user typed in, foo.example.com, match the domain name in the certificate?
|
|
If not, display a <a href="https://wrong.host.badssl.com/">BAD_CERT_DOMAIN error</a>.
|
|
</li>
|
|
<li>
|
|
Does the certificate contain a valid CA signature?
|
|
(can the signature on the certificate be decrypted by one of the CA Certificates included with the operating system?)
|
|
If not, display an <a href="https://untrusted-root.badssl.com/">UNKNOWN_ISSUER error</a>.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li>Assuming all the checks pass, the web browser trusts the certificate and connects</li>
|
|
</ol>
|
|
<p>
|
|
This system enabled the internet to grow and flourish:
|
|
purchasing from a CA was the only way to get a valid X.509 certificate for a website,
|
|
and guaranteeing authenticity was in the CA's business interest.
|
|
The CAs kept their private keys behind razor wire and armed guards, and followed strict rules to ensure that only the right
|
|
people got thier certificates signed.
|
|
Only the CA's themselves or anyone who had enough power to force them to create a fraudulent certificate
|
|
would be able to execute MITM attacks.
|
|
</p>
|
|
<p>
|
|
The TLS+X.509 Certificate Authority works well for HTTP and other application protocols, because
|
|
</p>
|
|
<ul>
|
|
<li>Most internet users don't have the patience to manually verify the authenticity of digital certificates.</li>
|
|
<li>Most internet users don't understand or care how it works; they just want to connect right now.</li>
|
|
<li>Businesses and organizations that run websites are generally willing to jump through hoops and
|
|
subjugate themselves to authorities in order to offer a more secure application experience to thier users.</li>
|
|
<li>The centralization & problematic power dynamic which CAs represent
|
|
is easily swept under the rug, if it doesn't directly or noticably impact the average person, who cares?</li>
|
|
</ul>
|
|
|
|
<p>
|
|
However, this would never fly with SSH. You have to understand, SSH does not come from Microsoft, it does not come from Apple,
|
|
in fact, it does not even come from Linux or GNU. <a href="https://www.openssh.com/">SSH comes from BSD</a>.
|
|
<a href="https://en.wikipedia.org/wiki/BSD">Berkeley Software Distribution</a>. Most people don't even know
|
|
what BSD is. It's <i>Deep Nerdcore</i> material. The people who maintain SSH are not playing around, they would never
|
|
allow themselves to be subjugated by so-called "Certificate Authorities".
|
|
So, what are they doing instead? Where is SSH at? Well, back when it was created, computer security was easy —
|
|
a very minimal defense was enough to deter attackers.
|
|
In order to help prevent these MITM attacks, instead of something like X.509, SSH employs a policy called
|
|
<a href="https://en.wikipedia.org/wiki/Trust_on_first_use">Trust On First Use (TOFU)</a>.
|
|
</p>
|
|
|
|
<p>
|
|
The SSH client application keeps a record of every server it has ever connected to
|
|
in a file <span class="code">~/.ssh/known_hosts</span>.
|
|
</p>
|
|
|
|
<p>
|
|
(the tilde <span class="code">~</span> here represents the user's home directory,
|
|
<span class="code">/home/username</span> on linux,
|
|
<span class="code">C:\Users\username</span> on Windows, and
|
|
<span class="code">/Users/username</span> on MacOS).
|
|
</p>
|
|
|
|
<p>
|
|
If the user asks the SSH client to connect to a server it has never seen before,
|
|
it will print a prompt like this to the terminal:
|
|
</p>
|
|
|
|
<pre class="code">The authenticity of host 'fooserver.com (69.4.20.69)' can't be established.
|
|
ECDSA key fingerprint is SHA256:EXAMPLE1xY4JUVhYirOVlfuDFtgTbaiw3x29xYizEeU.
|
|
Are you sure you want to continue connecting (yes/no/[fingerprint])?</pre>
|
|
|
|
<p>
|
|
Here, the SSH client is displaying the fingerprint (<a href="https://en.wikipedia.org/wiki/SHA-2">SHA256 hash</a>)
|
|
of the public key provided by the server at <span class="code">fooserver.com</span>.
|
|
Back in the day, when SSH was created, servers lived for months to years, not minutes, and they were installed by hand.
|
|
So it would have been perfectly reasonable to call the person installing the server on thier
|
|
<a href="https://nokiamuseum.info/nokia-909/">Nokia 909</a>
|
|
and ask them to log into it & read off the host key fingerprint over the phone.
|
|
After verifing that the fingerprints match in the phone call, the user would type <span class="code">yes</span>
|
|
to continue.
|
|
</p>
|
|
|
|
<p>
|
|
After the SSH client connects to a server for the first time, it will record the server's IP address and public key in the
|
|
<span class="code">~/.ssh/known_hosts</span> file. All subsequent connections will simply check the public key
|
|
the server presents against the public key it has recorded in the <span class="code">~/.ssh/known_hosts</span> file.
|
|
If the two public keys match, the connection will continue without prompting the user, however, if they don't match,
|
|
the SSH client will display a scary warning message:
|
|
</p>
|
|
<pre class="code">
|
|
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
|
|
@ WARNING: POSSIBLE DNS SPOOFING DETECTED! @
|
|
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
|
|
The ECDSA host key for fooserver.com has changed,
|
|
and the key for the corresponding IP address 69.4.20.42
|
|
is unknown. This could either mean that
|
|
DNS SPOOFING is happening or the IP address for the host
|
|
and its host key have changed at the same time.
|
|
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
|
|
@ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! @
|
|
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
|
|
IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!
|
|
Someone could be eavesdropping on you right now (man-in-the-middle attack)!
|
|
It is also possible that a host key has just been changed.
|
|
The fingerprint for the ECDSA key sent by the remote host is
|
|
SHA256:EXAMPLEpDDefcNcIROtFpuTiHC1j3iNU74aaKFO03+0.
|
|
Please contact your system administrator.
|
|
Add correct host key in /root/.ssh/known_hosts to get rid of this message.
|
|
Offending ECDSA key in /root/.ssh/known_hosts:1
|
|
remove with:
|
|
ssh-keygen -f "/root/.ssh/known_hosts" -R "fooserver.com"
|
|
ECDSA host key for fooserver.com has changed and you have requested strict checking.
|
|
Host key verification failed.
|
|
</pre>
|
|
|
|
<p>
|
|
This is why it's called <b>Trust On First Use</b>:
|
|
|
|
SSH protocol assumes that when you type <span class="code">yes</span> in response to the prompt during your first connection,
|
|
you <b>really did</b> verify that the server's public key fingerprint matches.
|
|
|
|
If you type <span class="code">yes</span> here without checking the server's host key somehow, you could add an attackers public key to the trusted
|
|
list in your <span class="code">~/.ssh/known_hosts</span> file; if you type <span class="code">yes</span> blindly, you are
|
|
<b>completely disabling all security of the SSH connection</b>.
|
|
It can be fully man-in-the-middle attacked & you are
|
|
vulnerable to surveillance, command injection, even emulation/falsification of the entire stream.
|
|
</p>
|
|
|
|
<p>
|
|
So what are technologists to do? Most cloud providers don't "provide" an easy way to get the SSH host public keys
|
|
for instances that users create on thier platform. For example, see this
|
|
<a href="https://serverfault.com/questions/941915/verify-authenticity-of-ssh-host-on-digital-ocean-droplet-freebsd">
|
|
question posted by a frustrated user trying to secure thier connection to a digitalocean droplet</a>.
|
|
|
|
Besides using the provider's HTTPS-based console to log into the machine & directly read the public key,
|
|
providers also recommend using a "userdata script".
|
|
This script would run on boot & upload the machine's SSH public keys to a
|
|
trusted location like <a href="https://www.backblaze.com/b2/cloud-storage.html">Backblaze B2</a> or
|
|
<del>Amazon S3</del><sup><a href="#ref_1">[1]</a></sup>, for an application to retrieve later.
|
|
As an example, I wrote a
|
|
<a href="https://git.sequentialread.com/forest/rootsystem/src/1cdbe53974d20da97d9f522d4bd62c34487817c0/terraform-modules/gateway-instance-digitalocean/upload_known_hosts.tpl#L5">
|
|
userdata script which does this</a>
|
|
for my own cloud compute management tool called
|
|
<a href="https://git.sequentialread.com/forest/rootsystem">rootsystem</a>.
|
|
Later in the process, rootsystem will
|
|
<a href="https://git.sequentialread.com/forest/rootsystem/src/1cdbe53974d20da97d9f522d4bd62c34487817c0/host-key-poller/main.go#L33">
|
|
download the public keys from the Object Storage provider
|
|
and add them to the ~/.ssh/known_hosts file</a>
|
|
before finally
|
|
<a href="https://git.sequentialread.com/forest/rootsystem/src/1cdbe53974d20da97d9f522d4bd62c34487817c0/terraform-modules/ansible-threshold-server/main.tf#L32">
|
|
invoking the ssh client against the cloud host</a>.
|
|
</p>
|
|
|
|
<p>
|
|
Personally, I think it's disgusting and irresponsible to require users to go through that much work
|
|
just to be able to connect to their instance securely. However, this practice appears to be an industry standard.
|
|
It's gross, but it's where we're at right now.
|
|
</p>
|
|
|
|
<p>
|
|
So for <a href="https://capsul.org">capsul</a>, we obviously wanted to do better.
|
|
We wanted to make this kind of thing as easy as possible for the user,
|
|
so I'm proud to announce as of today, capsul SSH host key fingerprints will be displayed on the capsul detail page,
|
|
as well as the host's SSH public keys themselves in <span class="code">~/.ssh/known_hosts</span> format.
|
|
Users can simply copy and paste these keys into thier <span class="code">~/.ssh/known_hosts</span> file and connect
|
|
with confidence that they are not being MITM attacked.
|
|
</p>
|
|
|
|
<div class="row half-margin"><h1>It's 2021. Can't we do better than this? What's next?</h1></div>
|
|
|
|
<p>
|
|
Glad you asked 😜.
|
|
</p>
|
|
<p>
|
|
TLS is great, except it has one problem: the X.509 CA system centralizes power and structurally invites abuse.
|
|
Power corrupts, and absolute power corrupts absolutely. But there is hope for the future: with the invention of Bitcoin
|
|
in 2009, we now have a new tool to use for authority-free secure consensus. Some bright folks have forked Bitcoin to produce
|
|
<a href="https://www.namecoin.org/">Namecoin</a>, a DNS-like public blockchain which is
|
|
<a href="https://en.bitcoin.it/wiki/Merged_mining_specification">merge-mined</a> with Bitcoin, and which allows users to
|
|
<a href="https://sequentialread.com/how-to-register-a-namecoin-bit-domain-with-electrum-nmc/">
|
|
register and trade names, including domain names</a>.
|
|
In fact, Namecoin features a
|
|
<a href="https://github.com/namecoin/proposals/blob/master/ifa-0003.md">
|
|
specification for associating public keys with domain names
|
|
</a>
|
|
and easy-to-use client software packages capable of resolving these
|
|
<a href="https://www.namecoin.org/download/betas/#ncdns">names</a>
|
|
&
|
|
<a href="https://www.namecoin.org/download/betas/#ncp11">
|
|
public</a>
|
|
|
|
<a href="https://www.namecoin.org/resources/presentations/Grayhat_2020/Namecoin_TLS_Part_2_Grayhat_2020_Monero_Village.pdf">
|
|
keys</a>,
|
|
capable of replacing both the DNS system and X.509 Certificate Authority system.
|
|
</p>
|
|
|
|
<p>
|
|
For more information on how to get started with Namecoin, see my
|
|
<a href="https://sequentialread.com/how-to-register-a-namecoin-bit-domain-with-electrum-nmc/">
|
|
Namecoin guide for webmasters</a>.
|
|
</p>
|
|
|
|
<p>
|
|
Cheers and best wishes,<br/>
|
|
Forest
|
|
</p>
|
|
|
|
<hr/>
|
|
<p>
|
|
<sup id="ref_1">[1]</sup> <a href="https://www.doitwithoutdues.com/">fuck amazon</a>
|
|
</p>
|
|
|
|
</div>
|
|
{% endblock %}
|
|
|
|
{% block pagesource %}/templates/about-ssh.html{% endblock %}
|
|
|