In the previous article, we’ve talked about how digital certificates help with authentication and provide a safe and reliable key exchange process in TLS.
Today we will learn exactly how to generate a certificate and have it signed by a Certificate Authority (CA).
For the purpose of this tutorial, we won’t submit our Certificate Signing Request (CSR) to a real CA. Instead, we will play both roles: the certificate authority and the certificate applicant.
So here's what we're gonna do:
- In the first step, we will generate a private key and its self-signed certificate for the CA. They will be used to sign the CSR later.
- In the second step, we will generate a private key and its paired CSR for the web server that we want to use TLS.
- Then finally we will use the CA’s private key to sign the web server’s CSR and get back the signed certificate.
In order to do all of these things, we need to have
openssl installed. If you’re on a Mac, it’s probably already there. You can run this command to see which version it’s running:
In my case, it’s LibreSSL version 2.8.3.
We can access its manual documentation at this link.
The first command we’re gonna used is openssl req, which stands for request. This command is used to create and process certificate signing request. It can also be used to create a self-signed certificate for the CA, which is exactly what we want in the first step.
openssl req -x509 -newkey rsa:4096 -days 365 -keyout ca-key.pem -out ca-cert.pem
-x509 option is used to tell openssl to output a self-signed certificate instead of a certificate request. In case you don’t know, X509 is just a standard format of the public key certificate.
-newkey rsa:4096 option basically tells openssl to create both a new RSA private key (4096-bit) and its certificate request at the same time. As we’re using this together with
-x509 option, it will output a certificate instead of a certificate request.
The next option is
-days 365, which specifies the number of days that the certificate is valid for.
Then we use the
-keyout option to tell openssl to write the created private key to
And finally the
-out option to tell it to write the certificate to
When we run this command, openssl will start generating the private key.
Once the key is generated, we will be asked to provide a pass phrase, which will be used to encrypt the private key before writing it to the PEM file.
Why is it encrypted? Because if somehow the private key file is hacked, the hacker cannot use it to do anything without knowing the pass phrase to decrypt it first.
Next, openssl will ask us for some identity information to generate the certificate:
- The country code
- The state or province name
- The organisation name
- The unit name
- The common name (or domain name)
- The email address
And that’s it! The certificate and private key files will be successfully generated.
If we cat the private key file
ca-key.pem, we can see it says
ENCRYPTED PRIVATE KEY:
-----BEGIN ENCRYPTED PRIVATE KEY----- MIIJnzBJBgkqhkiG9w0BBQ0wPDAbBgkqhkiG9w0BBQwwDgQILfki090rvloCAggA MB0GCWCGSAFlAwQBKg...GNYc7i9SVDBoA== -----END ENCRYPTED PRIVATE KEY-----
ca-cert.pem, on the other hand, is not encrypted, but only base64-encoded, because it just contains the public key, the identity information, and the signature that should be visible to everyone.
-----BEGIN CERTIFICATE----- MIIFxjCCA64CCQCNT+eP2vjJxzANBgkqhkiG9w0BAQsFADCBpDELMAkGA1UEBhMC RlIxEjAQBgNVBAgMC...udJwE7HnnA7lpA -----END CERTIFICATE-----
We can use the openssl x509 command to display all the information encoded in this certificate. This command can also be used to sign certificate requests, which we see in a moment.
openssl x509 -in ca-cert.pem -noout -text
Here we use the
-in option to pass in the CA’s certificate file. And the
-noout option to tell it to not output the original base64-encoded value. Instead, we use the
-text option because we want to display it in a readable text format.
Now we can see all information of the certificate, such as the version, the serial number. The issuer and the subject are the same in this case because this is a self-signed certificate. Then the RSA public key and signature.
I’m gonna copy this command and save it to a
gen.sh script. With this script, I want to automate the process of generating a set of keys and certificates.
Before moving to the 2nd step, I’m gonna show you another way to provide the identity information without entering it interactively as before. To do this, we must add the
-subj (subject) option to the
openssl req command:
openssl req -x509 -newkey rsa:4096 -days 365 -keyout ca-key.pem -out ca-cert.pem -subj "/C=FR/ST=Occitanie/L=Toulouse/O=Tech School/OU=Education/CN=*.techschool.guru/emailAddressfirstname.lastname@example.org"
In this subject string:
/C=FRis for Country
/ST=Occitanieis for STate or province
/L=Toulouseis for Locality name or city
/O=Tech Schoolis for Organisation
/OU=Educationis for Organisation Unit
/CN=*.techschool.guruis for Common Name or domain name
/emailAddressemail@example.com for email address
Now let’s add command
rm *.pem (to remove all pem files) at the top of the
gen.sh script, and run it in the terminal.
rm *.pem # 1. Generate CA's private key and self-signed certificate openssl req -x509 -newkey rsa:4096 -days 365 -keyout ca-key.pem -out ca-cert.pem -subj "/C=FR/ST=Occitanie/L=Toulouse/O=Tech School/OU=Education/CN=*.techschool.guru/emailAddressfirstname.lastname@example.org" echo "CA's self-signed certificate" openssl x509 -in ca-cert.pem -noout -text # 2. Generate web server's private key and certificate signing request (CSR) # 3. Use CA's private key to sign web server's CSR and get back the signed certificate
We still being prompted for a pass phrase, but it doesn’t ask for identity information anymore, because we already provided them in the subject option.
Now the next step is to generate a private key and CSR for our web server.
It’s almost the same as the command we used in the 1st step. Except that, this time we don’t want to self-sign it, so we should remove the
-x509 option. The
-days option should be removed as well, since we don’t create a certificate, but just a CSR.
openssl req -newkey rsa:4096 -keyout server-key.pem -out server-req.pem -subj "/C=FR/ST=Ile de France/L=Paris/O=PC Book/OU=Computer/CN=*.pcbook.com/emailAddressemail@example.com"
The name of the output key should be
server-key.pem. The output certificate request file should be
server-req.pem. And the subject should contain our web server’s information.
Now, when we run this command, the encrypted private key and the certificate signing request files will be generated.
This time, in the
server-req.pem file, it says
CERTIFICATE REQUEST, not
CERTIFICATE as in the
ca-cert.pem file. That's because it’s not a certificate as before, but a certificate signing request instead.
-----BEGIN CERTIFICATE REQUEST----- MIIE2DCCAsACAQAwgZIxCzAJBgNVBAYTAkZSMRYwFAYDVQQIDA1JbGUgZGUgRnJh bmNlMQ4wDAYDVQQHDAVQ...pWofr2eOeBQ4Q= -----END CERTIFICATE REQUEST-----
So now let’s move to step 3 and sign this request.
To sign the certificate, we will use the same openssl x509 command that we’ve used to display certificate before. Let’s open the terminal and run this:
openssl x509 -req -in server-req.pem -CA ca-cert.pem -CAkey ca-key.pem -CAcreateserial -out server-cert.pem
In this command, we use the
-req option to tell openssl that we’re gonna pass in a certificate request. We use the
-in option follow by the name of the request file:
Next we use the
-CA option to pass in the certificate file of the CA:
ca-cert.pem. And the
-CAkey option to pass in the private key of the CA:
Then 1 important option is
-CAcreateserial. Basically the CA must ensure that each certificate it signs goes with a unique serial number. So with this option, a file containing the next serial number will be generated if it doesn’t exist.
Finally we use the
-out option to specify the file to write the output certificate to.
Now as you can see here, because the CA’s private key is encrypted, openssl is asking for the pass phrase to decrypt it before it can be used to sign the certificate. It’s a countermeasure in case the CA’s private key is hacked.
OK, now we’ve got the signed certificate for our web server. Let’s print it out in plain text format.
This is its unique serial number
0xb141e873fd7b8567. We can also see a
ca-cert.srl file, which contains the same serial number.
By default, the certificate is valid for 30 days. We can change it by adding the
-days option to the signing command.
openssl x509 -req -in server-req.pem -days 60 -CA ca-cert.pem -CAkey ca-key.pem -CAcreateserial -out server-cert.pem
Now the validity duration has changed to 60 days.
A certificate can be used for multiple websites with different domain names. We can do that by specifying the Subject Alternative Name extension when signing the certificate request.
-extfile option of the
openssl x509 command allows us to state the file containing the extensions. We can see the format of the config file in this page.
There are several things that we can use as the alternative name, such as
IP. I will create a new file
server-ext.cnf with this content:
Here I set
DNS to multiple domain names:
*.pcbook.org. I also set
0.0.0.0 which will be used when we develop on localhost.
Now in the certificate signing command, let’s add the
-extfile option and pass in the name of the extension config file:
openssl x509 -req -in server-req.pem -days 60 -CA ca-cert.pem -CAkey ca-key.pem -CAcreateserial -out server-cert.pem -extfile server-ext.cnf
Now the result certificate file has a new extensions section with all the subject alternative names that we’ve chosen:
Certificate: ... Signature Algorithm: sha1WithRSAEncryption Issuer: C=FR, ST=Occitanie, L=Toulouse, O=Tech School, OU=Education, CN=*.techschool.guru/emailAddressfirstname.lastname@example.org Validity Not Before: Apr 10 18:17:05 2020 GMT Not After : Jun 9 18:17:05 2020 GMT Subject: C=FR, ST=Ile de France, L=Paris, O=PC Book, OU=Computer, CN=*.pcbook.com/emailAddressemail@example.com Subject Public Key Info: Public Key Algorithm: rsaEncryption Public-Key: (4096 bit) Modulus: 00:cb:e2:2b:c3:68:... Exponent: 65537 (0x10001) X509v3 extensions: X509v3 Subject Alternative Name: DNS:*.pcbook.com, DNS:*.pcbook.org, IP Address:0.0.0.0 Signature Algorithm: sha1WithRSAEncryption 5e:67:4d:f7:91:89:fc:...
So looks like our automate script is ready, except for the fact that we have to enter a lot of password to protect the private keys.
In case we just want to use this for development and testing, we can tell openssl to not encrypt the private key, so that it won’t ask us for the pass phrase.
We do that by adding the
-nodes option to the
openssl req command like this:
rm *.pem # 1. Generate CA's private key and self-signed certificate openssl req -x509 -newkey rsa:4096 -days 365 -nodes -keyout ca-key.pem -out ca-cert.pem -subj "/C=FR/ST=Occitanie/L=Toulouse/O=Tech School/OU=Education/CN=*.techschool.guru/emailAddressfirstname.lastname@example.org" echo "CA's self-signed certificate" openssl x509 -in ca-cert.pem -noout -text # 2. Generate web server's private key and certificate signing request (CSR) openssl req -newkey rsa:4096 -nodes -keyout server-key.pem -out server-req.pem -subj "/C=FR/ST=Ile de France/L=Paris/O=PC Book/OU=Computer/CN=*.pcbook.com/emailAddressemail@example.com" # 3. Use CA's private key to sign web server's CSR and get back the signed certificate openssl x509 -req -in server-req.pem -days 60 -CA ca-cert.pem -CAkey ca-key.pem -CAcreateserial -out server-cert.pem -extfile server-ext.cnf echo "Server's signed certificate" openssl x509 -in server-cert.pem -noout -text
Now if we run
gen.sh again, it will not ask for passwords anymore. And if we look at the private key file, it will be
PRIVATE KEY, and not
ENCRYPTED PRIVATE KEY as before.
-----BEGIN PRIVATE KEY----- MIIJQwIBADANBgkqhkiG9w0BAQEFAASCCS0wggkpAgEAAoICAQDL4ivDaIzDM3my VDzT2Mw5R9bicXS...AxAt2Ldmc4= -----END PRIVATE KEY-----
One last thing before we finish, I will show you how to verify if a certificate is valid or not. We can do that with the openssl verify command:
openssl verify -CAfile ca-cert.pem server-cert.pem
We just pass in the trusted CA’s certificate and the certificate that we want to verify. If it returns
OK then the certificate is valid.
And that’s it for today’s article. I hope it’s useful for you. Thanks for reading and I’ll see you guys in the next one!
If you want to join me on my current amazing team at Voodoo, check out our job openings here. Remote or onsite in Paris/Amsterdam/London/Berlin/Barcelona with visa sponsorship.