Home / Acmefyer / Internal servers

AcmefyerAgent-based Certificate Manager

Let’s Encrypt for internal servers, without port 80.

Intranet, file server interface, printer portal, management console: internal services need valid certificates just as much, but cannot be reached from the internet. Acmefyer obtains the certificates through DNS validation, without any internal server opening a port to the outside, and an agent installs them where they are needed.

01BackgroundWhy internal servers are different

Why HTTP-01 does not work for internal servers.

With the usual HTTP-01 validation, Let’s Encrypt fetches a file under /.well-known/acme-challenge/ on port 80, from the internet. An internal server cannot be reached there, and nobody wants to open a port just for validation.

With DNS-01 you prove control of the domain with a TXT record in the public DNS zone instead, for example:

_acme-challenge.intranet.example.com.  300  IN  TXT  "gfj9Xq...Rg85nM"

The server itself takes no part in the validation. It only needs a public name under your domain. Whether that name points to an address on the internet does not matter.

HTTP-01
Port 80 must be reachable from the internet, without a broken redirect.
DNS-01
A TXT record _acme-challenge in the public zone. No server has to be reachable from the outside.
Internal names
Public certificate authorities do not issue names such as server.company.local or private IP addresses. The usual way is a name under your own domain, such as intranet.example.com. For purely internal names, Acmefyer’s local CA issues the certificate.
Split-DNS
If your own DNS server answers the zone differently from the internet, typically with Active Directory, only what the internet sees counts for validation.
02With AcmefyerWho talks to whom

Only the Acmefyer server talks to the internet.

The Acmefyer server orders the certificate from Let’s Encrypt or another ACME certificate authority, creates the validation record through your DNS provider’s API, waits until public DNS servers see it and removes it afterwards. It renews the certificate on its own about 30 days before expiry.

The Acmefyer agent runs on the internal servers. It connects outbound to the Acmefyer server only, picks up the certificate and installs it locally. The internal servers need neither an open port nor internet access for this.

Acmefyer server
Outbound to the certificate authority, to the DNS provider and to www.wedigo.net for the license, also through a proxy.
Agents
Outbound to the Acmefyer server only, via HTTPS with mutual certificate verification (mTLS).
DNS providers
Around 190, including Cloudflare, Hetzner, IONOS, INWX, Azure DNS and Amazon Route 53, plus your own DNS servers via RFC 2136.
Public view
Acmefyer asks public DNS servers such as Cloudflare or Quad9 whether the validation record is visible, not the internal DNS. The selection is configurable.
Credentials
DNS provider API tokens are stored encrypted with AES-256-GCM in the embedded database.
Targets
For example IIS, Exchange, the Windows certificate store, NGINX, Apache, Traefik, HAProxy, Tomcat or your own scripts.
03SetupSet up once, then it runs on its own
  1. 01

    Choose a name

    For example intranet.example.com. Internally your DNS server points to the server as before.

  2. 02

    DNS access

    Store your DNS provider’s API token, once per account or project.

  3. 03

    Add a domain

    With Let’s Encrypt and validation via DNS-01.

  4. 04

    Install the agent

    On the internal server. It detects the applications serving TLS, and one click creates the deployment.

04FAQFrequently asked questions about certificates for internal servers

Can I use Let’s Encrypt for an internal server?

Yes, if the server has a public name under your domain and the certificate is obtained via DNS-01. Let’s Encrypt then only checks the TXT record in the public zone. The server itself does not have to be reachable from the internet.

Does the internal server need internet access?

No. Only the Acmefyer server needs to reach the internet, to the certificate authority and the DNS provider. The agent on the internal server only connects to the Acmefyer server.

Is there a Let’s Encrypt certificate for server.company.local?

No. Public certificate authorities do not issue certificates for internal endings such as .local or .lan or for private IP addresses. Give the service a name under your domain, such as intranet.example.com, and resolve it internally. For purely internal names you need a certificate authority of your own: Acmefyer brings a local CA that issues such certificates, renews them itself and revokes them through a revocation list (CRL) when needed. The local CA needs a license. You make its root CA trusted by Group Policy, MDM or with the target “Trust store (CA)” through the agents.

We already have an internal CA. Can Acmefyer deploy its certificates?

Yes. You import certificates from, for example, Active Directory Certificate Services as PEM, DER or PFX and give them targets like any other certificate, and the agents install them. Your CA then still renews them. Acmefyer warns before they expire, and a new file replaces the certificate on all targets. Alternatively Acmefyer takes your CA over into the local CA together with its private key, for example only the intermediate CA while the root CA stays offline. Acmefyer then issues and renews by itself, and your systems already trust the certificates. What your CA issued before you take over several certificates at once. From then on Acmefyer renews the server certificates among them itself. Taking it over into the local CA needs a license.

Do my internal names become public?

Yes, the names in the certificate. Public certificate authorities record every certificate in public Certificate Transparency logs. To avoid this, use a wildcard certificate: then only *.example.com appears there.

Our network only reaches the internet through a proxy. Does that work?

Yes. The Acmefyer server takes the proxy from the Windows settings or from the web interface and the console. Certificate authority, DNS provider and license check then go through it.