Your own SSL certificate
Every domain gets a free Let’s Encrypt certificate that Netkeel renews for you. If you need a different one, such as an organisation-validated certificate, a wildcard certificate or a Cloudflare Origin certificate, you can upload your own for a domain.
Install your certificate
Section titled “Install your certificate”You need the certificate file, the chain your issuer sent (if it is not already in the certificate file) and the private key made together with the certificate request. The key must not have a passphrase.
- Open the application and go to Domains & SSL.
- Click your domain, then the SSL tab.
- Click Use your own certificate.
- Fill in the three boxes. Under each box you can also pick a
.crt,.pemor.keyfile instead of pasting:- Certificate: your site’s certificate. A file that also holds the chain is fine.
- Chain (optional): the intermediate certificates, often called
ca-bundleorchain. - Private key: starts with
-----BEGIN PRIVATE KEY-----or similar.
- Click Check certificate.
- Under This is what Netkeel read, check who it was issued to, the names it covers, the dates and the key type. Read any warnings.
- Click Install certificate.
Nothing is installed until you click Install certificate. Checking only reads what you pasted.
You can install your own certificate before your domain points at the server. The application’s SSL tab then shows Your certificate, who issued it and when it expires.
What is checked
Section titled “What is checked”Netkeel refuses a certificate when:
- the private key does not belong to the certificate, has a passphrase, or there is more than one key;
- the certificate does not list the domain among its names (a wildcard covers one label, so
*.example.comcoverswww.example.combut nota.b.example.com; the common name alone does not count); - it is a CA certificate, or it has expired, is not valid yet, or has less than a day left (under 14 days left gives a warning);
- the key is weak (RSA below 2048 bits) or the certificate uses an MD5 or SHA-1 signature;
- the chain does not lead from your certificate to its issuer, or holds an unrelated certificate. A jumbled order is put right for you.
A self-signed certificate is refused unless you tick Use this self-signed certificate anyway. Browsers show a warning to every visitor unless something in front of the site, such as a proxy you control, trusts it.
Also answer on www
Section titled “Also answer on www”If the certificate covers www. followed by your domain, the dialog offers Also answer on www.example.com. Tick it to make the application answer on the www name too. The www DNS record must point at the server as well.
Renew or replace it
Section titled “Renew or replace it”Netkeel emails you before your certificate expires, at 30, 14, 7 and 1 days ahead, and again when it has expired. The SSL tab also warns you in the last 30 days.
- On the domain’s SSL tab, click Replace.
- Enter the new certificate, chain and key, and click Check certificate.
- Click Replace certificate.
The old certificate keeps serving until the new one is installed. If the new one fails to install, the old configuration stays in use.
Remove it
Section titled “Remove it”- On the domain’s SSL tab, click Remove.
- Confirm Remove certificate.
The domain goes back to the Let’s Encrypt certificate it had before, if there is one. Otherwise it gets a temporary self-signed certificate that browsers warn about. After removing, click Request Let’s Encrypt to secure the domain again; see SSL certificates. While your own certificate is installed, you cannot request a Let’s Encrypt certificate for that domain.
The saved private key is deleted from Netkeel and from the server when you remove the certificate.
Moves, clones and restores
Section titled “Moves, clones and restores”- Moving the application to another server. Netkeel installs your certificate on the new copy before the old one is removed. If that fails, the move still finishes, the SSL tab says “Saved, but not installed on the server”, and Netkeel asks Let’s Encrypt for a certificate instead when DNS points at the new server. Click Install again to try your own certificate again.
- Clones and staging copies use another domain and do not get your certificate.
- Backups never contain your private key. Restoring a backup keeps the certificate that is installed.
- Deleting the application deletes the saved certificate and key.
Your private key
Section titled “Your private key”Netkeel stores your private key encrypted. It is used only for that domain, so a move or a rebuilt server can install the certificate again. It is never shown again.