ACME-Client

As of LCOS 10.80 the Automatic Certificate Management Environment (ACME) client as per RFC 8555 is supported for Let's Encrypt certificates. Let's Encrypt is a free and open certification authority that makes it possible to obtain free SSL/TLS certificates. The certificates can be used for WEBconfig and for the Public Spot.

The prerequisite for using Let's Encrypt is that the device has a publicly resolvable domain name, e.g. DynDNS. For the certificates to be used correctly, the device's WEBconfig must be accessed via its domain name and not the IP address. If WEBconfig is called via the IP address, the certificate check fails because Let's Encrypt certificates are issued for domain names and not IP addresses.

With Let's Encrypt, certificates are issued when a device can prove that it has control of the domain name. For this purpose, Let's Encrypt provides a so-called "challenge" that the device must satisfy. The ACME client in the device performs this process automatically. The ACME client also renews the certificate automatically before a specified certificate expiry period.

A domain name must first be entered into the configuration. The device then automatically submits a certificate request to Let's Encrypt and temporarily opens (for example) the port 443 or 80. Let's Encrypt then checks whether the device and the previously set challenge (e.g. token) can be reached under the specified domain name and port 443 or 80. If this is successful, the certificate is issued. The device renews the certificate automatically before it expires. For this process, the device briefly opens port 80 or 443 for this challenge and closes it again in the second step.

Use of Let's Encrypt is not possible or fails in the following scenarios:

In principle, multiple domain names are also supported in the SAN field (Subject Alternative Name) of the certificate.

Note: By default, port 443 and the method tls-alpn-01 is used for the ACME challenge. If the method http-01 is to be used on port 80, the LANconfig configuration parameter General > Admin > Access settings > HTTP access from a WAN interface must be set to "Automatic".
Note:

Please note that it is not possible to use the ACME client with the tls-alpn-01 authorization challenge and simultaneous port forwarding with port 443. The same applies if the ACME client is to be used via the http-01 method for port 80.

Manual adjustment of the ACME client to any port is not possible according to RFC 8737 in the protocol.

Note:

You can see information about the ACME client in LANmonitor and start or stop a trace with the command line trace # acme.





www.lancom-systems.com

LANCOM Systems GmbH | A Rohde & Schwarz Company | Adenauerstr. 20/B2 | 52146 Wuerselen | Germany | E‑Mail info@lancom.de

LANCOM Logo