OPS345 Lab 5: Difference between revisions

From Littlesvr Wiki
Jump to navigation Jump to search
 
(10 intermediate revisions by 2 users not shown)
Line 30: Line 30:
You can't get a publicly-resolvable domain name just by doing some magic on your server. You need to pay a registrar (usually a yearly fee of around 20$) to connect your records to the global DNS network.
You can't get a publicly-resolvable domain name just by doing some magic on your server. You need to pay a registrar (usually a yearly fee of around 20$) to connect your records to the global DNS network.


Wikipedia sometimes has useful information, and the [https://en.wikipedia.org/wiki/Domain_Name_System#Address_resolution_mechanism Address resolution mechanism section] has a reasonably comprehensible diagram and description of a simple query process.
Wikipedia sometimes has useful information, and the [https://en.wikipedia.org/wiki/Domain_Name_System#Address_resolution_mechanism Address resolution mechanism section] of its DNS page has a reasonably comprehensible diagram and description of a simple query process.


You would typically be interested in controlling somedomain.com (or .ca or .org, etc.) and therefore you would:
You would typically be interested in controlling somedomain.com (or .ca or .org, etc.) and therefore you would:
Line 82: Line 82:
{{Admon/important|Mind the dots|Technically every FQDN in DNS ends with a dot, it's just normally hidden from the users. Try it in a web browser, using ping, etc. When you're configuring DNS records: pay attention whether your host/value has a trailing dot or not. If you're missing the trailing dot: your value will have your domain appended to it. Practice it to understand what this means.}}
{{Admon/important|Mind the dots|Technically every FQDN in DNS ends with a dot, it's just normally hidden from the users. Try it in a web browser, using ping, etc. When you're configuring DNS records: pay attention whether your host/value has a trailing dot or not. If you're missing the trailing dot: your value will have your domain appended to it. Practice it to understand what this means.}}
* Test your two new records you just created using dig. If you're not sure whether the problem is with caching: you can query the authoritative DNS server directly, e.g.:<syntaxhighlight lang="bash">dig asmith15.ops345.ca @ns1.littlesvr.ca</syntaxhighlight>
* Test your two new records you just created using dig. If you're not sure whether the problem is with caching: you can query the authoritative DNS server directly, e.g.:<syntaxhighlight lang="bash">dig asmith15.ops345.ca @ns1.littlesvr.ca</syntaxhighlight>
* You can also use Dig through the [https://toolbox.googleapps.com/apps/dig/ Google Admin Toolbox] to test your DNS settings.
* You should also be able to go to www.yourusername.ops345.ca in a web browser:
* You should also be able to go to www.yourusername.ops345.ca in a web browser:


Line 87: Line 88:


== Access your Nextcloud via FQDN ==
== Access your Nextcloud via FQDN ==
{{Admon/tip|Your database might be off|If you followed my advice: your database instance should be temporarily stopped. That means you can't access it, and neither can a web application like Nextcloud. To restart your database instance: find it in the RDS interface and pick "Start" from the Actions menu. Depending on how much of the 50$ credit you've used up: you might want to stop it again after you're done with this lab.}}


* Try to go to www.yourusername.ops345.ca/nextcloud in a web browser. You should see an error like this:
* Try to go to www.yourusername.ops345.ca/nextcloud in a web browser. You should see an error like this:
Line 93: Line 96:


* Since you are the administrator: there's noone else for you to contact. Good thing you've had a little bit of practice with PHP. Fix the error so that you can log in to your Nextcloud installation. [https://help.nextcloud.com/t/howto-add-a-new-trusted-domain/26 This Nextcloud help page] might help too.
* Since you are the administrator: there's noone else for you to contact. Good thing you've had a little bit of practice with PHP. Fix the error so that you can log in to your Nextcloud installation. [https://help.nextcloud.com/t/howto-add-a-new-trusted-domain/26 This Nextcloud help page] might help too.
 
'''The next time you'll need your database for sure is for Assignment 2 (scheduled more than a month from now).''' I suggest you write some notes for yourself to stop your database instance three or four more times in the meantime.
= Encryption, certificates, etc. =
 
Encryption means converting plain text (something you can read/use, it doesn't need to be text) into cyphertext. The cyphertext created by a good encryption algorithm is impossible (or, for weak algorithms: at least impractical) to decrypt (covert back into plain text) without a key.
 
You've been using public key cryptography for your entire life (unless you were born before the 1990s). And you've been setting up public key cryptography for yourself since at least OPS245. If you actually understand how this stuff works: you'll be far ahead of the average sysadmin.
 
We don't have the time to do a comprehensive overview of cryptography, so I strongly encourage you to put the book '''Crypto''' by '''Steven Levy''' on your "must-read" list. You can borrow a copy from the Toronto Public Library. I have yet to see a better introduction to encryption. It's not a course reqirement - but if you don't want to be clueless about security fundamentals online - read that book and understand it. It reads like a novel, and it's perfectly readable even if you have no interest in math:
 
[[Image:crypto.jpeg|center|"crypto" by Steven Levy]]
 
In a nutshell, here are the most important points, the absolute minimum you need to be comfortable with this:
 
* Public key encryption (also called assymetric encryption) uses two keys: a public key and a private key.
* The two keys are permanently tied to each other by complex mathematics (read the book to get a feel for the fundamentals). You can't mix one public key with an unrelated private key.
* The private key is like your password, you never give it to anyone. The public key is of no value to attackers, so there's no point in trying to protect it.
* Anyone can encrypt something with the public key, but only the private key can be used to decrypt that.
* Anyone can verify that a file signed using the private key has not been modified except by the owner of the private key.
* A certificate is a public key typically signed by a third party's private key.
* Symmetric encryption only has one private key, no public key. That makes it very hard to use with strangers on the internet.
* Hashing is used a lot in cryptography, but it's not an encryption tool.
 
With those fundamentals you should be able to follow this diagram which describes how SSH key authentication works. The diagram is from [http://sebastien.saunier.me/blog/2015/05/10/github-public-key-authentication.html Sébastien Saunier's blog].:
 
[[Image:ssh_connection_explained.png|thumb|center|600px|A diagram explaining how public / private keys work.]]
 
== Certificate Authorities (CAs) ==
 
The problem with assymetric encryption is the distribution of public keys. The encryption strength is meaningless if the client can't be sure it has the unmodified public key for the server. That's where a third party gets involved. This third party is called a Certificate Authority.
 
The exact same concepts from the section above are used for CA-signed certificates. There's just a third party involved - which makes it seem like magic for too many people, including professionals in our field.
 
If you have any ambitions in this field: set a goal for yourself to understand this stuff fully. At least eventually, if not now.
 
=== Setup on the server ===
 
Let's take a web browser and web server for an example - since that's the most common use of this setup.
 
# First the web server administrator needs to generate a key pair, roughly the same as what you've been using for SSH (but using different commands).
# The server admin needs to have the public key from that pair signed by a CA which browsers will accept as reliable. There are many such CAs, you can look in your browser's settings to see a full list. Typically people choose the cheapest option that will work in their setup. That's around 60$ a year.
# The admin needs to pay the CA for the service. There's only one free option available which we'll use in this course.
# The CA will use their private key to sign the web server's public key. That will allow people who already have the CA's public key to verify that the web server's public key has not been modified (by anyone other than the people who have access to any trusted CAs private key).
# The server admin can download this signed public key (a.k.a. a certificate) from the CA.
# The server admin will configure the web server to use the server's private key and the CA-signed version of its pair public key for secure communication over HTTPS.
 
[[File:ServerCA.png|800px|border|center]]
 
A certificate will always be linked to an FQDN. That mostly makes sense since web browsers connect to a web server using a domain name. Sometimes that's a pain in the neck for the administrator (you'll see why later) and the concept of "wildcard certificate" exists, but I was never able to set one up to work properly.
 
=== Client communicating with server ===
 
Now that the server is configured, let's look at what happens when a web browser connects to a web server using HTTPS.
 
# The web browser connects to a web server, expecting to establish encrypted communication.
# The web server will send to the client its CA-signed public key.
# The browser came installed with a list of trusted CAs' public keys. Good luck figuring out how this list was compiled by whom when and how it's kept up to date. Let's just assume for now that those are all trustworthy, since everyone else assumes the same. It uses the appropriate CA's public key from that list to verify the server's public key.
# At this point a combination of signing, encryption, and exchange of symmetrical encryption keys can be used to establish a connection where all traffic in both directions is encrypted.
 
[[File:BrowserCA.png|800px|border|center]]
 
== Self-signed certificates ==
 
Options exist if you need encrypted communication to your web or email server but you're not willing to pay for a CA or deal with the complexities required by Let's Encrypt:
# You can self-sign a certificate, and add that certificate directly into your client software. If you have full control over all your client software: this is more secure and reliable than using a typical CA.
# You can set up your own certificate authority (it takes one command to do that) to sign whatever certificates you want, and configure your client software to trust your CA. Again, this is more secure and reliable than relying on potentially untrustworthy CAs.
 
We won't be doing either of those techniques in this course because their application requires closer knowledge of the business where they're used, and therefore it's too specific for this course.
 
= HTTPS for your web server =
 
Generally-trusted CAs' services cost money. We're going to avoid extra costs in this course, and will use the one and only free CA which is trusted by a typical browser: '''Let's Encrypt'''.
 
Let's Encrypt won't give you a certificate for more than 3 months, which is why the paid-for CAs still exist. They encourage you to set up automatic renewals of your certificate using their custom software, which is not always doable or even desireable. But it's free and 3 months is good enough for us.
 
== Create your signed certificate ==
 
The steps below follow relevant instructions from the [https://help.datica.com/hc/en-us/articles/360044373551-Creating-and-Deploying-a-LetsEncrypt-Certificate-Manually Let's Encrypt Creating and Deploying a LetsEncrypt Certificate Manually] page.
 
* Install certbot in your workstation using apt or the Software Manager. This is a command-line-only application.
* Run <syntaxhighlight lang="bash">certbot certonly --manual --preferred-challenges dns</syntaxhighlight> as root. This will generate a key pair on your workstation, for your domain. Replace asmith15.ops345.ca with the domain that's correct for you. The output below is cut off after the notice to publish the TXT record:
 
[[File:AWSCertbot-part1.png|border|center]]
 
Let's Encrypt verifies that you're authorized to get a certificate for yourusername.ops345.ca by asking you to add a TXT record under that domain. It's a reasonable assumption that if you have control over the DNS records for a domain: it's your domain.
 
* Leave the terminal running certbot and go to Bindistrar to add the TXT record Let's Encrypt asked for.
* To avoid mistakes getting cached: double-check your record, then test it in another terminal on your workstation:<syntaxhighlight lang="bash">dig _acme-challenge.asmith15.ops345.ca TXT</syntaxhighlight>
* If there is a mistake: note the TTL, it will make it hard for you to check that you fixed it correctly. But you can query the authoritative server for ops345.ca directly:<syntaxhighlight lang="bash">dig _acme-challenge.asmith15.ops345.ca TXT @littlesvr.ca</syntaxhighlight>
* Once it looks good to you: press Enter in the terminal running certbot:
 
[[File:AWSCertbot-part2.png|border|center]]
 
* If that looks good: you can delete the TXT record from your DNS, it was only needed for a single use.
* Save your private key and the certificate in your home directory to make them easier to find later and easier to back up:<syntaxhighlight lang="bash">mkdir ~yourusername/ops345/certbot
cp /etc/letsencrypt/live/yourusername.ops345.ca/privkey.pem ~yourusername/ops345/keys/certbot/yourusername.ops345.ca.key.pem
cp /etc/letsencrypt/live/yourusername.ops345.ca/cert.pem ~yourusername/ops345/keys/certbot/yourusername.ops345.ca.cert.pem
chown -R yourusername ~yourusername/ops345/keys/certbot</syntaxhighlight>
 
The file yourusername.ops345.ca.cert.pem is what a CA would send you after you paid them. It:
* Is useless without its private key pair.
* Is not tied to the workstation you used to create it.
* Is not tied to any particular service (e.g. Apache).
* Is tied to the yourusername.ops345.ca domain.
* Will become useless after it expires.
 
== Set up Apache to use your new keys ==
 
Do this part of the lab on your www.yourusername.ops345.ca machine only. No need to touch the slaves you created in the assignment.
 
* Remember that your keys are tied to a domain, so make sure that the ServerName option in /etc/httpd/conf/httpd.conf is set to your full domain name yourusername.ops345.ca
* Apache can be configured to provide service over HTTPS relatively easily once you have the keys you need, but on Amazon Linux the SSL apache module is not installed by default, so install it now on your www server (give the machine a temporary elastic IP to allow yum to work, and release it after you're done):<syntaxhighlight lang="bash">yum install mod_ssl</syntaxhighlight>
* Both your private key and your certificate need to be on the server because Apache needs to use them both. Use scp to copy them from your workstation to the server, and then copy them into the directories commonly used for this purpose:
[[File:AWSCopyCertbotKeys.png|800px|border|center]]
* Configure Apache to use those keys by setting the following two parameters in /etc/httpd/conf.d/ssl.conf:<syntaxhighlight lang="ApacheConf">SSLCertificateFile /etc/pki/tls/certs/yourusername.ops345.ca.cert.pem
SSLCertificateKeyFile /etc/pki/tls/private/yourusername.ops345.ca.key.pem</syntaxhighlight>
* Restart apache and confirm that there are no errors in /var/log/httpd/error_log
* Configure your firewalls and port forwarder to handle HTTPS, which works over TCP port 443:
** Add an iptables rule in the nat table on router.
** Add a rule for HTTPS in the router's security group to allow access from anywhere.
** Add a rule for HTTPS in www's security group to allow access from the router only.
* Test it in Firefox. It should work well for https://yourusername.ops345.ca and not well for https://www.yourusername.ops345.ca
[[File:AWSHTTPSWorks.png|800px|border|center]]
 
The problem with https://www.yourusername.ops345.ca is that your certificate is for a different domain. There are several different ways to deal with that, but this lab was long enough already, so we're not going to fix it.


= Submit evidence of your work =
= Submit evidence of your work =
Line 224: Line 104:
* A dig query for your A record.
* A dig query for your A record.
* A dig query for your CNAME record.
* A dig query for your CNAME record.
* Firefox showing http://yourusername.ops345.ca/nextcloud/, or better yet https://yourusername.ops345.ca/nextcloud/
* Firefox showing http://yourusername.ops345.ca/nextcloud/
* Firefox showing https://yourusername.ops345.ca


[[Category:OPS345]]
[[Category:OPS345]]

Latest revision as of 13:07, 5 September 2024

DNS overview

The Domain Name System converts human-friendly domain names to IP addresses. Computers on the internet can only communicate with each other using IP addresses. But people aren't very good at remembering long strings of numbers (up to 12 digits for ipv4) or even longer strings of numbers and characters mixed (24 characters for ipv6).

Therefore DNS is a critical part of the internet infrastructure, and just about everyone who has a website needs to do something with it. Some all-inclusive web hosts offer domain name registration and automatically connect their hosting service to the domain registration, but that comes at the cost of any flexibility. From a technical point of view your domain name registration has nothing to do with the server that your DNS records are pointing to.

DNS records

DNS servers store records of different types. Here are the ones you'll see most often:

  • A records (the most common ones) map fully-qualified donain names (FQDNs) to IP addresses.
  • CNAME records (also called aliases) map a name to another name.
  • MX records store the FQDN of the mail server for that domain.
  • TXT records can store almost anything and are often used for various security features.

You can use several command-line tools to query DNS servers. Some are more useful than others. Try the following: 

  1. ping littlesvr.ca
    Notice that ICMP (ping) packets are sent to an IP address, not the FQDN. That means the ping command had to first do a DNS query (for the A record for littlesvr.ca) and therefore this is a simple way to do a DNS query, which is useful if you don't have any better tools. Notice also that this works even if the server won't respond to pings, or even if it's offline.
  2. host littlesvr.ca
host -a littlesvr.ca
    This is a much more DNS-specific command and has parameters that will let you ask for different record types.
  3. dig littlesvr.ca
dig littlesvr.ca MX
dig littlesvr.ca @8.8.8.8
    This is the one we'll use mostly in this course. The output is the most difficult to read, but the details it provides are useful when troubleshooting your DNS setup. The first dig command above asks for the A record (the default). The second asks for the MX record for littlesvr.ca. The third asks for the A record from a specific DNS server (8.8.8.8).
  4. Do your best to construct DNS queries using dig to get all the records set up for littlesvr.ca. Following is a screenshot of the registrar's interface:
LittlesvrNamespro.png

If you can't obtain all these records using dig: you either don't understand how DNS works or you need more practice with dig. Keep trying until you figure it out.

Registering a domain name

You can't get a publicly-resolvable domain name just by doing some magic on your server. You need to pay a registrar (usually a yearly fee of around 20$) to connect your records to the global DNS network.

Wikipedia sometimes has useful information, and the Address resolution mechanism section of its DNS page has a reasonably comprehensible diagram and description of a simple query process.

You would typically be interested in controlling somedomain.com (or .ca or .org, etc.) and therefore you would:

  • Find a registrar who's authorized to sell domains under that TLD (top-level domain), which is .com in this example.
  • Check whether somedomain.com is available.
    • If it's available: you pay the registrar and in return you get exclusive control over the DNS records for that domain for the period of time you paid for.
    • If it's not available: you're most likely out of luck. It can cost tens or hundreds of thousands of dollars to buy a domain from someone who already bought it.
  • You can add whatever DNS records you want for your domain, and you also control all the subdomains of that domain. You won't need to pay extra for one.two.three.four.somedomain.com
  • After you add you records - they will be available to the world almost immediately. Except: see next section.

If you're a more advanced user: you can configure your domain records to be stored on and served by your own DNS server(s). You won't be doing that in this course. It's a lot of hard work and requires a cooparative registrar to set up glue records for you.

Caching

Because DNS is used so much (see a typical webpage): there are countless DNS queries done everywhere all the time.

The responses to those queries are cached (stored closer to the questioner) in order to minimize load on the authoritative servers. They are cached for a specific amount of time - typically controlled by the domain owner, though cheaper registries have minimum limits.

That means that if you have an A record linking somedomain.com to 1.2.3.4, and someone does a DNS query for somedomain.com: their next query for somedomain.com will not make it to your DNS server until after the TTL expires.

That means if you change your A record to link somedomain to 2.3.4.5 instead: it may take as long as 48 hours for everyone in the world to be guaranteed to get the new record. You can see the TTL (in seconds) for a record when you use dig to do a query:

LittlesvrTTL.png

There are websites available that can help you figure out whether your records are up to date around the world, for example https://www.whatsmydns.net/

Private DNS

If you only need DNS records inside your organization (e.g. on an LAN/intranet): you can avoid paying a registrar for each domain.

You do that by running a DNS server on your LAN, and making sure all the machines on that network are configured to use your internal DNS server. Curiously: in such a setup the administrator can have control over all DNS records including for domains owned by someone else:

DNSquery.png

Your DNS records

In this course you'll get to experience something like a real domain registration process with some limitations:

  • You'll get full control over a subdomain of ops345.ca (e.g. asmith15.ops345.ca), rather than a second-level domain (like asmith15.ca).
  • You can only create A, MX, CNAME, and TXT records.
  • You have no control over the TTL.

But you get to do this for free.

You should have received an email about a Bindistrar account that's been created for you. The email will include your username and a random password. Please keep the password secret. You cannot change it. I can change it for you but I'd really rather not.

After you log in: Bindistrar will allow you to create public DNS records for yourusername.ops345.ca

  • Set up an A record for yourusername.ops345.ca to point to your elastic IP (the one assigned to router).
  • Set up a CNAME record for www, so that it points to yourusername.ops345.ca
Important.png
Mind the dots
Technically every FQDN in DNS ends with a dot, it's just normally hidden from the users. Try it in a web browser, using ping, etc. When you're configuring DNS records: pay attention whether your host/value has a trailing dot or not. If you're missing the trailing dot: your value will have your domain appended to it. Practice it to understand what this means.
  • Test your two new records you just created using dig. If you're not sure whether the problem is with caching: you can query the authoritative DNS server directly, e.g.:
    dig asmith15.ops345.ca @ns1.littlesvr.ca
  • You can also use Dig through the Google Admin Toolbox to test your DNS settings.
  • You should also be able to go to www.yourusername.ops345.ca in a web browser:
AWSwwwDNS.png

Access your Nextcloud via FQDN

Idea.png
Your database might be off
If you followed my advice: your database instance should be temporarily stopped. That means you can't access it, and neither can a web application like Nextcloud. To restart your database instance: find it in the RDS interface and pick "Start" from the Actions menu. Depending on how much of the 50$ credit you've used up: you might want to stop it again after you're done with this lab.
  • Try to go to www.yourusername.ops345.ca/nextcloud in a web browser. You should see an error like this:
NextcloudUntrustedDomain.png
  • Since you are the administrator: there's noone else for you to contact. Good thing you've had a little bit of practice with PHP. Fix the error so that you can log in to your Nextcloud installation. This Nextcloud help page might help too.

The next time you'll need your database for sure is for Assignment 2 (scheduled more than a month from now). I suggest you write some notes for yourself to stop your database instance three or four more times in the meantime.

Submit evidence of your work

For this lab, please submit screenshots that show you've completed the work, unless your professor has given you different instructions. As a minimum that's:

Retrieved from "http://wiki.littlesvr.ca/w/index.php?title=OPS345_Lab_5&oldid=1483"