“Il sito funziona normalmente, ma il certificato scade fra pochi giorni e il rinnovo automatico fallisce.” Nel browser è tutto verde, quindi non può essere il server – questa è l'ipotesi più ovvia. Ma la verifica HTTP-01 di Let's Encrypt guarda il server da un client diverso dal browser del cliente.
Come funziona la verifica HTTP-01
Il client ACME sul server (ad esempio certbot) crea un file con un token in /.well-known/acme-challenge/. Let's Encrypt lo richiede poi tramite http://esempio.it/.well-known/acme-challenge/<token> – sempre in HTTP sulla porta 80.
Un redirect a HTTPS è consentito e Let's Encrypt lo segue. Ma la prima richiesta deve poter entrare dalla porta 80. Inoltre Let's Encrypt verifica da più località; tutte devono raggiungere il server.
Classico 1: la porta 80 è chiusa
Molti chiudono la porta 80 nel firewall perché “tanto va tutto in HTTPS”. Chi digita direttamente https:// non se ne accorge. La validazione però fallisce con un timeout o un “connection refused”.
Verificare se qualcosa è in ascolto sulla porta 80 e se il firewall la lascia passare:
sudo ss -tlnp | grep ':80 '
sudo ufw status # se si usa ufw
sudo nft list ruleset # con nftables
Vanno considerati anche i firewall del provider o della console cloud e le regole di geo-blocking. Chi blocca determinati paesi può bloccare anche località di verifica di Let's Encrypt.
Classico 2: un record AAAA che punta altrove
Se un dominio ha un record AAAA, Let's Encrypt preferisce verificare via IPv6. Se quel record punta a un server vecchio o estraneo, la richiesta finisce lì – e il token non viene trovato.
Il ripiego su IPv4 avviene solo se la connessione IPv6 non si stabilisce affatto. Se all'indirizzo IPv6 risponde un altro server, ad esempio con una pagina 404, la verifica fallisce.
Origine tipica: un cambio di hosting in cui è stato aggiornato solo il record A (di più nell'articolo Migrazione DNS senza downtime). Il browser del cliente magari usa IPv4 e non nota nulla.
Una variante: il record AAAA è corretto, ma il web server non è in ascolto su IPv6, per esempio perché in nginx manca la riga listen [::]:80;.
Verificare in quest'ordine
1. Interrogare i record DNS e confrontarli con gli IP reali del server:
dig +short A esempio.it
dig +short AAAA esempio.it
ip -6 addr show scope global
2. Creare un file di test nella webroot usata dal client ACME:
echo ok | sudo tee /var/www/html/.well-known/acme-challenge/test
3. Richiederlo dall'esterno con entrambi i protocolli – possibilmente da un'altra macchina, non dal server stesso:
curl -4 -i http://esempio.it/.well-known/acme-challenge/test
curl -6 -i http://esempio.it/.well-known/acme-challenge/test
Entrambi devono restituire ok. Se solo -6 restituisce altro, il problema è il record AAAA o la configurazione IPv6.
4. Provare il rinnovo a secco e leggere il log:
sudo certbot renew --dry-run
sudo less /var/log/letsencrypt/letsencrypt.log
Il dry run usa l'ambiente di staging e non pesa sui rate limit.
Altre cause e alternative
Anche un record CAA che autorizza solo un'altra autorità di certificazione impedisce l'emissione. E se la porta 80 deve restare chiusa per buoni motivi, la verifica DNS-01 tramite record TXT è l'alternativa giusta – a patto che il provider DNS offra un'API per farlo.
Checklist
- I record
AeAAAApuntano entrambi al server giusto? - Il web server è in ascolto sulla porta 80 in IPv4 e IPv6?
- La porta 80 è aperta nel firewall del server, in quello del provider e nelle regole geografiche?
- Il file di test è raggiungibile dall'esterno con
curl -4ecurl -6? certbot renew --dry-runva a buon fine?- I record
CAAautorizzano Let's Encrypt?
Prima controllare il record AAAA, poi il firewall. Si risparmiano molti tentativi a vuoto – e un certificato che scade all'ultimo minuto.