How it works
SSL certificates
How certificates are ordered over ACME, where private keys are stored and why not in the account's home, when renewal runs, and what this client never does.
Certificates are ordered over ACME, with the HTTP-01 challenge served from the site's own document root. You can also upload material you already hold.
A certificate cannot be ordered for a reserved name (see websites); the check runs before any request reaches the certificate authority.
Where the private key goes
Not in the account's home directory. A site's PHP runs as that customer, so any key the site can read is a key the customer can read, and they can still read it after you have stopped trusting them.
Keys are written to a root-only store outside every home. The web server reads them as root at startup; nothing that runs as the account ever sees them.
Renewal
A renewal pass runs thirty days before expiry. There is nothing to schedule and nothing to remember, so renewal keeps working while the operator is on holiday.
What this client has not done
It has never carried an order through to an issued certificate with a real certificate
authority. The whole path runs end to end against pebble, Let's Encrypt's own test server: registration, order, challenge served and validated,
finalise, download, with the issued certificate's serial matching the one read back out of the PEM.
That run found a defect no unit test had caught: the client sent no User-Agent, which pebble
refuses on every request and Let's Encrypt tolerates. Still untested against the real authority are
its rate limits, validation from the public internet, and its chain. Renewal is not tested at all,
because the test forces a fresh challenge every run.
Limits to know
- HTTP-01 only. No wildcard certificates and no DNS-01; those arrive with DNS management.
Acme:CertificateStorePathis read by nothing. The store path is fixed in the agent, and the setting is a leftover.
Both are listed in the release notes as well, because a limitation listed only in the documentation is one somebody will install without reading.