mkcert
on your own computers --- it has already been installed on the Linux lab machines so skip ahead.
Download a copy of mkcert
from:
https://github.com/FiloSottile/mkcert/releases
mkcert-v1.4.4-windows-amd64.exe
mkcert-v1.4.4-linux-amd64
. NOTE: mkcert
is already installed on the Linux lab machines --- you don't need to install it yourself.mkcert-v1.4.4-darwin-amd64
mkcert-v1.4.4-darwin-arm64
from the labs section of Blackboard. We have created a build for your CPU, but we don't have an M1 Mac to test it with. If you do get this working on an M1 then let us know.Create an mkcert
folder in your <> folder. Copy the mkcert
file that you downloaded into this folder.
Rename the file that you copied to mkcert
to make it easier to type into a terminal since mkcert
is a terminal application.
Open the <> folder in a terminal.
Generate and install the CA certificate using the following command.
Windows Users (via PowerShell)
$env:CAROOT = pwd; $env:TRUST_STORES = 'system'; .\mkcert.exe -install
Mac Users
chmod u+x mkcert CAROOT=$(pwd) TRUST_STORES=system ./mkcert -install
Mac users may need to jump through the usual hoops with the Security & Privacy settings to run the command.
Linux Users
chmod u+x mkcert CAROOT=$(pwd) TRUST_STORES=system,nss ./mkcert -install
The chmod
command is needed (Mac/Linux only) since the file is not currently executable. This adds the executable mode to the file.
Leave the terminal window open since we will be using it again very soon.
You should see two new files in the mkcert
folder. These are the new CA certificate and the private key for the certificate.
Restart your web browser so that it will pick up the new CA certificate.
You can check if the new CA certificate has been added to your system as follows:
Windows
Run certmgr.msc
. You should see the mkcert certificate under <
Note that Firefox is not currently supported by mkcert under Windows, so you will need to use Chrome (or one of the Chrome derivatives) for the remainder of this exercise.
Linux
ls -l /etc/ssl/certs/mkcert*
Mac
Use the 'Keychain Access' application. Search for mkcert
.
chrome://settings/certificatesLook in the <> tab. You should find
org-mkcert development CA
in the list.VivaldiClick the padlock to the left of the URL in the browser and click <> --- it is likely already selected, but click it again to get to the main security settings. Then click < Manage Certificates > Authorities">>.You should find org-mkcert development CA
in the list.FirefoxEnter the following into the location bar:about:certificateThen click the <> tab. You should see an entry that starts with
mkcert
in the list.<> Note that mkcert
does not currently support Firefox on Windows --- use Chrome, or a Chrome derivative if you are a Windows user.