SSL Certificates on Access Server's Web Services⁠

Introduction⁠

This topic details web certificates for Access Server's Client and Admin Web UI services.

These web interfaces are only available via HTTPS, which requires a web certificate. Access Server 2.9.0 and newer automatically generate self-signed web certificates valid for one year.

Access Server's self-signed certificate⁠

A new Access Server installation comes with self-signed certificates, leading to web browser warnings.

While the connection between the web browser and the web server is encrypted, and you can use the fingerprint of the SSL certificate to provide proof of identity, this identity verification is a manual process. Web browsers employ a method of trust that allows the automatic establishment of the web server's identity and trust by its FQDN, its web certificate, and a chain of trust leading up to a trusted root authority.

We recommend replacing the SSL certificate to enhance security and eliminate warning messages. When you have things set up correctly with a signed and verified SSL certificate, your web browser displays the padlock icon in the browser's address bar for a secure connection.

SSL web certificate and CA locations⁠

The SSL web certificate and CA can be stored in one of three locations:

  1. In the configuration database in specific configuration key values.

  2. Referenced by filename and path in these configuration keys.

  3. In the default fallback location /usr/local/openvpn_as/etc/web-ssl/.

Database configuration key values:⁠

cs.cert

SSL web certificate contents or its file path.

cs.priv_key

Private key contents or its file path for the above certificate.

cs.ca_bundle

CA Intermediate bundle contents or its file path, if needed.

cs.ca_key

CA key contents or its file path used only for internal self-signed certificates.

Contents of /usr/local/openvpn_as/etc/web-ssl directory:⁠

server.crt

Self-signed SSL web certificate.

server.key

Private key for the above certificate.

ca.crt

CA public certificate.

ca.key

CA private key.

Recover SSL web certificates from the config DB⁠

If you need to extract the SSL web certificates from your Access Server, refer to this tutorial:

Regenerating self-signed certificates⁠

When Access Server isn’t provided with SSL web certificates, it uses its self-signed certificates and regenerates those when certain conditions are met. If these files have been tampered with, resetting them with the instructions found here is possible. This is to meet today’s stricter security requirements for self-signed certificates. EKU is one of those requirements, and since older versions of Access Server generated self-signed certificates without EKU, they are regenerated when you upgrade to Access Server 2.9 and newer.

You can find the steps to do this in our tutorial: