Ubuntu 26.04 / Configurare HTTPS e verificare rinnovo e scadenza dei certificati

Configura HTTPS dopo aver preparato un dominio che controlli e un percorso di convalida raggiungibile. L’emissione del certificato, il certificato realmente presentato ai visitatori, il rinnovo pianificato e gli avvisi di scadenza sono verifiche distinte.

Verificare dominio, DNS e accesso HTTP pubblico

HTTPS combina HTTP con TLS (Transport Layer Security), il protocollo che protegge la connessione e permette al client di verificare l’identità del server. Il sito Nginx di laboratorio .test su 127.0.0.1:8080, descritto nella guida in inglese non è un dominio pubblico da presentare a Certbot per questa procedura.

Prepara un nome reale amministrato da te: DNS (Domain Name System), direttiva server_name, directory dei documenti e risposta HTTP sulla porta 80 devono corrispondere. Il record A indica il percorso IPv4; un record AAAA pubblicato richiede anche un percorso IPv6 funzionante. Installa gli strumenti necessari sul server autorizzato se assenti: dig è disponibile nel pacchetto Ubuntu dnsutils.

read -r -p "Domain you control: " domain
dig +short A "$domain"
dig +short AAAA "$domain"
curl -I "http://$domain/"

Inserisci soltanto il nome host, senza schema, percorso o porta, e controlla l’esito di ogni comando. curl -I richiede le intestazioni: non prova che il contenuto sia quello previsto. Ripeti DNS e HTTP da un’altra connessione Internet, verificando anche firewall dell’host, router, NAT e regole del fornitore. Risolvere un nome non dimostra che il server corretto risponda.

Completare prima il sito HTTP del dominio reale

Questa parte richiede un server Ubuntu 26.04 separato, con Nginx e curl disponibili, console di recupero e privilegi amministrativi. La VM host-only dell’esercizio sugli IP statici non è direttamente raggiungibile da Internet. Se non disponi di dominio e hosting pubblico, rimanda l’emissione oppure pianifica separatamente una convalida DNS-01 con plugin ufficiale e gestione sicura delle credenziali.

Imposta il record A sull’indirizzo pubblico corretto e verifica l’eventuale AAAA. Salva il blocco completo in un nuovo file ~/prepare-public-http.sh ed esegui bash ~/prepare-public-http.sh TUO_DOMINIO_REALE, sostituendo il segnaposto. Il controllo accetta una forma ordinaria di hostname ASCII; per un dominio internazionalizzato usa il nome punycode verificato. La verifica nel codice non prova proprietà, validità completa del DNS o disponibilità del dominio: controllale prima e non usare nomi di esempio.

set -eu
if [ "$#" -ne 1 ]; then
    printf 'Usage: bash prepare-public-http.sh YOUR_DOMAIN\n' >&2; exit 2
fi
domain=$(printf '%s' "$1" | tr '[:upper:]' '[:lower:]')
if [[ ! "$domain" =~ ^([a-z0-9]([a-z0-9-]*[a-z0-9])?\.)+[a-z]([a-z0-9-]*[a-z0-9])?$ ]]; then
    printf 'Use a valid ASCII hostname you control.\n' >&2; exit 2
fi
case "$domain" in
    *.test|*.invalid|*.localhost|*.example|example.com|*.example.com)
        printf 'Use your real domain, not an example name.\n' >&2; exit 2 ;;
esac
site=/etc/nginx/sites-available/ubuntu-course-public
enabled=/etc/nginx/sites-enabled/ubuntu-course-public
root_dir=/srv/ubuntu-course-public
for path in "$site" "$enabled" "$root_dir"; do
    if sudo test -e "$path" || sudo test -L "$path"; then
        printf 'Existing lab path: %s; stop and inspect.\n' "$path" >&2; exit 1
    fi
done
backup_dir=$(sudo mktemp -d /root/nginx-before-public.XXXXXX)
sudo cp -a /etc/nginx "$backup_dir/"
sudo install -d -m 0755 "$root_dir"
printf 'public-http-lab\n' | sudo sh -c 'set -C; cat > "$1/index.html"' sh "$root_dir"
sudo chmod 0644 "$root_dir/index.html"
sudo sh -c 'set -C; cat > "$1"' sh "$site" <<EOF
server {
    listen 80;
    listen [::]:80;
    server_name $domain;
    root /srv/ubuntu-course-public;
    index index.html;
    location / {
        try_files \$uri \$uri/ =404;
    }
}
EOF
sudo ln -s "$site" "$enabled"
sudo nginx -t
sudo systemctl reload nginx
printf 'HTTP site prepared; backup: %s\n' "$backup_dir"

Prima dell’esecuzione verifica che i tre percorsi di laboratorio non esistano, che non siano collegamenti inattesi e che nessun altro sito usi già quel server_name. Lo script rifiuta percorsi già presenti e preserva una copia di /etc/nginx, ma non rileva tutti i conflitti logici fra siti. Le redirezioni noclobber aiutano a evitare sovrascritture di file regolari, senza sostituire la verifica dei percorsi e delle modifiche concorrenti.

Se il server non supporta il listener IPv6, adegua la relativa riga listen alla configurazione reale e non pubblicare un AAAA inutilizzabile. In caso di errore interrompi la procedura: possono essere già rimasti file o collegamenti di questa prova, anche se il reload non è avvenuto. Confrontali con il backup e correggi o annulla solo questa modifica, preservando gli altri siti.

Su un nuovo server pubblico nel quale UFW è già gestito e l’accesso SSH è protetto, se la politica prevede HTTP e HTTPS pubblici puoi aggiungere i permessi seguenti. Questa riga non abilita UFW. Prepara anche i percorsi 80/443 nei filtri del fornitore; una regola limitata al solo client di laboratorio .10 non consente la convalida HTTP-01 esterna.

sudo ufw allow 80/tcp && sudo ufw allow 443/tcp && sudo ufw status verbose

La variabile domain dello script separato non rimane nella shell da cui lo hai lanciato. Reinserisci il nome reale nella stessa sessione Bash in cui userai Certbot e verifica il corpo HTTP. Da un altro collegamento Internet devi ottenere public-http-lab dal sito previsto, non la pagina predefinita di un altro server.

read -r -p "Domain you control: " domain
dig +short A "$domain"
dig +short AAAA "$domain"
curl --fail --show-error "http://$domain/"

Controlla separatamente i percorsi A e AAAA quando presenti. Let’s Encrypt descrive la preferenza e le condizioni del percorso IPv6: una risposta errata via IPv6 non si risolve assumendo che il validatore userà sempre IPv4. Un proxy o una CDN, rete di distribuzione dei contenuti, aggiungono un altro punto da confrontare con l’origine.

Scegliere una sola installazione di Certbot

Se Certbot è già installato, identifica origine, versione e processo di rinnovo prima di intervenire. Non sovrapporre APT, Snap e pip e non rimuovere un’installazione gestita senza un piano di migrazione. Su questo server nuovo l’esempio sceglie Snap e il suo modello di accesso: serve snapd funzionante e supporto classic.

sudo snap install --classic certbot
/snap/bin/certbot --version

Leggi il requisito --classic, che concede accesso più ampio rispetto al confinamento strict. Il percorso completo /snap/bin/certbot evita di richiamare accidentalmente un altro eseguibile. Le istruzioni ufficiali Certbot per Nginx e Snap descrivono installazione, configurazione automatica e prova del rinnovo.

Salvare Nginx e validarlo prima dell’emissione

Conferma che la variabile domain della sessione corrente contenga esattamente il nome host amministrato, non una stringa vuota o un esempio. Il blocco crea una copia distinta, ne stampa il percorso e controlla Nginx prima di avviare Certbot. Se un passaggio fallisce si interrompe; conserva il percorso del backup, perché la variabile della subshell non persiste.

(
set -eu
backup=$(sudo mktemp -d /root/nginx-before-tls.XXXXXX)
sudo cp -a /etc/nginx "$backup/"
printf 'Nginx backup before TLS: %s\n' "$backup"
sudo nginx -t
sudo /snap/bin/certbot --nginx -d "$domain"
)

Leggi le richieste su email, termini e opzioni di reindirizzamento prima di scegliere. --nginx può modificare i file del server per installare il certificato: confronta il risultato con la copia, poi ricontrolla la configurazione e il sito. Non considerare un messaggio di emissione come prova che tutti gli utenti ricevano il certificato nuovo.

La documentazione Let’s Encrypt sui tipi di challenge spiega che HTTP-01 richiede la porta 80 e il percorso /.well-known/acme-challenge/ accessibile ai validatori. Una risposta corretta della pagina iniziale è un prerequisito utile, ma non prova che quel percorso sia gestito correttamente da tutte le origini e dai proxy.

DNS-01 usa invece un record TXT sotto _acme-challenge e può servire anche per nomi wildcard. Non aggiungere alla cieca un plugin o una chiave DNS completa: scegli un plugin supportato, credenziali con privilegi limitati e un rinnovo automatizzabile. In caso di fallimento indaga DNS, porte, challenge e log prima di ripetere richieste di emissione; richieste ripetute possono incontrare limiti del servizio.

Controllare HTTPS e il certificato realmente servito

curl --fail --show-error "https://$domain/"
openssl s_client -connect "$domain:443" -servername "$domain" -verify_return_error -verify_hostname "$domain" </dev/null

Esegui i controlli da una rete esterna e leggi separatamente esito e output di ciascuno. La prima riga verifica la risposta HTTP tramite TLS; la seconda usa SNI (Server Name Indication), l’indicazione del nome del sito durante la connessione, e richiede verifica del nome e interruzione sugli errori di verifica del certificato. Il manuale OpenSSL s_client descrive queste opzioni; confrontalo con la versione installata.

Controlla nome coperto, catena di fiducia, periodo di validità e contenuto atteso. Un errore va investigato, non nascosto con curl -k o disabilitando i controlli. Un client OpenSSL può usare un archivio di autorità fidate diverso da quello del browser: leggi gli errori di catena e confronta la configurazione di fiducia senza aggiungere certificati non verificati.

Il certificato sul disco locale può essere nuovo mentre un proxy, bilanciatore, nodo IPv6 o altra origine serve ancora quello precedente. Prova il percorso usato dai visitatori e ciascun endpoint rilevante; nel browser esamina anche i dettagli del certificato per il nome effettivamente visitato. Se HTTP viene reindirizzato a HTTPS, verifica destinazione e contenuto con una nuova connessione.

Provare rinnovo e rilevazione della scadenza

sudo /snap/bin/certbot certificates
sudo /snap/bin/certbot renew --dry-run
systemctl list-timers --all | grep certbot

certificates mostra gli oggetti gestiti localmente; renew --dry-run prova oggi il percorso di rinnovo e convalida, ma non garantisce una futura esecuzione pianificata. Leggi il riepilogo del comando e i log, non soltanto l’assenza di messaggi sul terminale.

La ricerca dei timer è un indizio: un output vuoto può dipendere dal nome del job o dal meccanismo di pianificazione; una riga corrispondente non dimostra un rinnovo riuscito. Identifica il timer o job reale dell’installazione Snap, il servizio associato, l’ultima esecuzione e gli errori. Non creare un secondo job soltanto perché la ricerca grep non ha mostrato ciò che ti aspettavi.

Leggi la data notAfter del certificato senza presumere una durata fissa. Per un file PEM locale già identificato puoi usare openssl x509 -in PERCORSO_CERTIFICATO.pem -noout -dates, sostituendo il percorso; -checkend SECONDI segnala con stato non zero se la scadenza cade nell’intervallo scelto. Il manuale OpenSSL x509 descrive questi controlli. Non confondere il file locale con il certificato realmente presentato dall’endpoint pubblico.

Prepara avvisi per fallimento del job e scadenza del certificato esterno, con un margine adatto alla durata effettiva e al tempo di intervento. Prova anche la consegna dell’avviso al destinatario responsabile. Dopo un rinnovo verifica nome, catena, nuove date del certificato servito e risposta del sito; una pianificazione presente non sostituisce questi riscontri.

Se devi annullare l’intervento, confronta le sole modifiche Certbot/Nginx di questa prova con il backup e preserva gli altri domini e le loro configurazioni di rinnovo. Una copia di Nginx non contiene da sola tutti i dati gestiti da Certbot. Non cancellare manualmente l’albero dei certificati per ripristinare il sito; valuta la procedura di gestione pertinente e riconvalida configurazione e servizio dopo ogni modifica mirata.