Tutorial de Debian 13 / Configurar TLS en Nginx y verificar certificados y renovación
Para operar HTTPS en Debian 13, necesita verificar no solo la emisión del certificado, sino también el nombre, la cadena de confianza, la expiración y el certificado realmente proporcionado por el servidor web. Una vez que un dominio público y una ruta de verificación externa estén listos, puede configurar la emisión y la renovación con Certbot, y en una VM de laboratorio sin tales condiciones, puede aprender el mismo flujo de verificación con una autoridad certificadora (CA, Certificate Authority) local de prueba. La verificación de ejecución en este curso utiliza el segundo método, y se distingue para no confundirlo con la emisión exitosa de un certificado público.
Separe la emisión pública del laboratorio con CA local
HTTPS es un método para proteger la comunicación HTTP con TLS (Transport Layer Security, seguridad de la capa de transporte). Los certificados contienen información como la clave pública del servidor y el nombre que se debe usar, y son firmados por una autoridad certificadora (CA). Los clientes verifican si se encadena a una CA de confianza, si el nombre de la conexión coincide con el certificado y si está dentro del período de validez.
ACME (Automatic Certificate Management Environment, entorno de gestión automática de certificados) es un protocolo para verificar el control sobre dominios y automatizar la emisión y renovación de certificados. Certbot es un cliente que lo utiliza. Las CAs creadas localmente no son confiables para los navegadores de Internet por defecto y no son sustitutos de los certificados de sitios públicos.
| Método | Requisitos | Alcance de la verificación en este curso |
|---|---|---|
| Emisión pública de Certbot | Dominio real controlable, DNS/acceso externo según el método de verificación | Este es un procedimiento de operación condicional que verifica documentos oficiales y opciones instaladas. No se realizó la emisión real. |
| CA de prueba local | VM Debian separada con acceso sudo, Nginx·OpenSSL·curl | La prueba original verificó confianza, nombre, respuesta HTTPS, reemisión local y recarga de Nginx. |
La guía de tipos de desafío de Let’s Encrypt explica que HTTP-01 requiere acceso externo a un token a través del dominio en el puerto 80. Abrir solo el puerto 8443 de la VM o cambiar un archivo hosts local no cumple con esta condición. DNS-01 requiere control del registro TXT público de DNS; la renovación automatizada necesita un plugin de DNS adecuado y permisos de API cuidadosamente definidos.
Inspeccione las versiones instaladas y el temporizador de renovación
Para practicar, use la VM de la lección anterior donde Nginx se ejecuta normalmente y asegúrese de que el puerto 8443 y la ruta dedicada a continuación estén vacíos. En servidores con sitios públicos existentes, haga una copia de seguridad segura de la configuración, certificados y claves, y defina el alcance de los cambios antes de continuar.
sudo apt update
sudo apt install nginx openssl curl certbot python3-certbot-nginx
openssl version
certbot --version
sudo nginx -t
ss -ltn
systemctl cat certbot.timer certbot.service
systemctl list-timers certbot.timer --no-pager
La VM de la prueba original utilizó OpenSSL 3.5.7, Certbot 4.0.0 y Nginx 1.26.3. En el paquete de Debian, certbot.timer agregaba un retraso aleatorio a los dos tiempos de referencia diarios y se configuraba con Persistent=true. El certbot.service era de tipo oneshot que ejecuta renew. Si el método de instalación es diferente, el nombre del temporizador y el horario también pueden diferir, por lo que se deben verificar los ajustes reales.
timer active significa que el horario está activado. No significa que exista un certificado o que la renovación/despliegue haya sido exitosa. El resultado de certbot certificates en esta VM fue No certificates found, y los certificados locales posteriores de OpenSSL no se registran automáticamente como objetivos gestionados por Certbot.
Cree la CA local y el sitio completo de prueba HTTPS
Ejecute el bloque completo solo cuando todas las rutas de laboratorio dedicadas enumeradas en la comprobación inicial estén ausentes. Coloque la clave CA y la clave del servidor en rutas accesibles solo por root, y mantenga solo el certificado público de la CA legible por el cliente en una ruta pública separada. No lo agregue al almacén de confianza del sistema o del navegador. Las claves se generan sin contraseña pero están restringidas con permisos de directorio 700 y permisos de archivo 600; este método es solo para práctica local breve.
Ejecute privilegios de administrador explícitamente con sudo bash, y ejecute los comandos internos en un solo shell de root. Haga que la CA sea válida por 3 días y que el primer certificado del servidor sea válido por 1 día, incluyendo lab26.test en el SAN (Subject Alternative Name, nombre alternativo del titular). Este nombre se usa solo para pruebas locales.
sudo bash <<'ROOT'
set -euo pipefail
for p in /var/lib/lf-tls26 /etc/nginx/lf-tls26 /etc/nginx/sites-available/lf-tls26 /etc/nginx/sites-enabled/lf-tls26 /usr/local/sbin/lf-tls26-deploy; do
if test -e "$p" || test -L "$p"; then echo "Existing: $p" >&2; exit 1; fi
done
install -d -m 755 /var/lib/lf-tls26 /var/lib/lf-tls26/public
install -d -m 700 /var/lib/lf-tls26/private /etc/nginx/lf-tls26
umask 077
openssl req -x509 -newkey rsa:2048 -noenc -sha256 -days 3 -subj '/CN=LF Lab 26 Test CA' -addext 'basicConstraints=critical,CA:TRUE' -addext 'keyUsage=critical,keyCertSign,cRLSign' -keyout /var/lib/lf-tls26/private/ca.key -out /var/lib/lf-tls26/public/ca.crt
chmod 644 /var/lib/lf-tls26/public/ca.crt
openssl req -new -newkey rsa:2048 -noenc -subj '/CN=lab26.test' -keyout /etc/nginx/lf-tls26/server.key -out /var/lib/lf-tls26/private/server.csr
cat > /var/lib/lf-tls26/private/leaf.ext <<'EXT'
basicConstraints=critical,CA:FALSE
keyUsage=critical,digitalSignature,keyEncipherment
extendedKeyUsage=serverAuth
subjectAltName=DNS:lab26.test
EXT
openssl x509 -req -in /var/lib/lf-tls26/private/server.csr -CA /var/lib/lf-tls26/public/ca.crt -CAkey /var/lib/lf-tls26/private/ca.key -set_serial 0x26 -days 1 -sha256 -extfile /var/lib/lf-tls26/private/leaf.ext -out /etc/nginx/lf-tls26/server.crt
cat > /etc/nginx/sites-available/lf-tls26 <<'CONF'
server {
listen 127.0.0.1:8443 ssl;
server_name lab26.test;
ssl_certificate /etc/nginx/lf-tls26/server.crt;
ssl_certificate_key /etc/nginx/lf-tls26/server.key;
default_type text/plain;
return 200 "TLS LAB 26\n";
}
CONF
ln -s /etc/nginx/sites-available/lf-tls26 /etc/nginx/sites-enabled/lf-tls26
nginx -t
systemctl reload nginx
sleep 1
ROOT
Entre los archivos generados, ca.key y server.key son claves privadas, y ca.crt y server.crt son certificados públicos. No asuma que establecer el nombre común (CN, Common Name) es suficiente para la validación del nombre; verifique también el SAN. Las extensiones del certificado del servidor especifican que no es una CA y que está destinado a la autenticación del servidor. La configuración y las condiciones para acceder a las claves privadas también se explican en la documentación de configuración HTTPS de Nginx.
Después de verificar la configuración y recargar, haga solicitudes como un usuario regular en la VM de Debian. Si una conexión falla inmediatamente después de recargar, intente nuevamente después de un breve período y revise la salida de ss y los registros del servicio. La opción --resolve asigna nombres a direcciones solo para esta solicitud sin cambiar el DNS, y --cacert hace que la CA de prueba sea confiable solo para esta solicitud.
curl --noproxy '*' -fsS --cacert /var/lib/lf-tls26/public/ca.crt --resolve lab26.test:8443:127.0.0.1 https://lab26.test:8443/
La respuesta esperada es TLS LAB 26. Este éxito se basa en la verificación bajo condiciones de loopback, CA especificada y nombre especificado, y no refleja resultados del DNS público o de las verificaciones de confianza de un navegador regular.
Distinga errores de confianza y de nombre
Para la primera solicitud a continuación, no especifique la CA de prueba, y para la segunda solicitud, especifique la CA pero conéctese a una dirección IP que no esté incluida en el certificado. Se espera que ambos comandos fallen. Ejecute esta comparación en un shell ordinario y limpio sin habilitar set -e, y lea el código de salida inmediatamente después de cada solicitud; un shell con errexit podría salir antes de que se ejecute echo.
curl --noproxy '*' -sS --resolve lab26.test:8443:127.0.0.1 https://lab26.test:8443/
echo "curl exit: $?"
curl --noproxy '*' -sS --cacert /var/lib/lf-tls26/public/ca.crt https://127.0.0.1:8443/
echo "curl exit: $?"
En la prueba original, ambos casos devolvieron un código de salida 60 de curl, pero el primero se debió a un emisor no confiable, y el segundo a una discrepancia de nombre. No los agrupe solo por el número; lea también el mensaje de error. El resultado que tuvo éxito al desactivar la verificación con -k no se puede usar para las comprobaciones de confianza del certificado.
Verifique la cadena, el nombre y la expiración del archivo en sí de la siguiente manera. La ruta del certificado del servidor está dentro del directorio de solo root, por lo que se utiliza sudo.
sudo openssl verify -CAfile /var/lib/lf-tls26/public/ca.crt -verify_hostname lab26.test /etc/nginx/lf-tls26/server.crt
sudo openssl x509 -in /etc/nginx/lf-tls26/server.crt -noout -serial -dates -ext subjectAltName
sudo openssl x509 -in /etc/nginx/lf-tls26/server.crt -noout -checkend 3600
-checkend 3600 verifica si expirará dentro de los próximos 3600 segundos y devuelve un estado distinto de cero si la expiración está cerca. Esto por sí solo no verifica la cadena ni el nombre. Según la descripción de la opción x509 de OpenSSL, distinga los propósitos de las verificaciones de fecha, SAN y cadena.
Compare el archivo de certificado con el certificado que sirve Nginx
Incluso si sustituye el certificado del servidor, no puede garantizar que Nginx en ejecución sirva el nuevo certificado. Primero, verifique el número de serie del certificado proporcionado en una nueva conexión. -servername pasa el nombre de servidor deseado a través del SNI (Server Name Indication, indicación del nombre del servidor) de TLS. Este comando es para observar el certificado, y la confianza y verificación del nombre reales se realizan con curl y openssl verify previamente.
openssl s_client -connect 127.0.0.1:8443 -servername lab26.test < /dev/null 2>/dev/null | openssl x509 -noout -serial -fingerprint -sha256
Ejecute esta comparación de reemplazo una vez en el laboratorio recién creado. Conserve el primer server-before.crt en lugar de sobrescribirlo en intentos repetidos. Estos certificados expiran intencionalmente después de solo unos pocos días; use un reloj del sistema correcto y prepare de nuevo el laboratorio dedicado cuando sea necesario.
El número de serie inicial es 26 en hexadecimal. A continuación, utilizando la misma CA de prueba y solicitud de firma de certificado (CSR, Certificate Signing Request), cree un nuevo certificado con un período de validez de 2 días y número de serie 27, y después de que se complete la verificación, reemplace el nombre del archivo en el mismo directorio. Esta comparación es una reemisión local donde el paso de despliegue se observa por separado, no es una renovación ACME.
sudo bash <<'ROOT'
set -euo pipefail
umask 077
cp -a /etc/nginx/lf-tls26/server.crt /var/lib/lf-tls26/private/server-before.crt
openssl x509 -req -in /var/lib/lf-tls26/private/server.csr -CA /var/lib/lf-tls26/public/ca.crt -CAkey /var/lib/lf-tls26/private/ca.key -set_serial 0x27 -days 2 -sha256 -extfile /var/lib/lf-tls26/private/leaf.ext -out /etc/nginx/lf-tls26/server.next.crt
openssl verify -CAfile /var/lib/lf-tls26/public/ca.crt -verify_hostname lab26.test /etc/nginx/lf-tls26/server.next.crt
mv /etc/nginx/lf-tls26/server.next.crt /etc/nginx/lf-tls26/server.crt
ROOT
Inmediatamente después de completar el bloque anterior, el número de serie del archivo es 27, pero el certificado recibido en una nueva conexión aún era 26. Esto es evidencia de que el éxito en el guardado del archivo y el éxito en el despliegue son diferentes. El certificado funcional server-before.crt se preservó en este paso.
El script siguiente recarga Nginx solo si la comprobación de su configuración tiene éxito. En esta práctica, se confirmó durante la preparación que un archivo con este nombre aún no existe. No se utiliza para sobrescribir scripts existentes en servidores de producción.
sudo tee /usr/local/sbin/lf-tls26-deploy > /dev/null <<'HOOK'
#!/bin/sh
set -eu
/usr/sbin/nginx -t
/usr/bin/systemctl reload nginx
HOOK
sudo chmod 700 /usr/local/sbin/lf-tls26-deploy
sudo /usr/local/sbin/lf-tls26-deploy
openssl s_client -connect 127.0.0.1:8443 -servername lab26.test < /dev/null 2>/dev/null | openssl x509 -noout -serial -fingerprint -sha256
curl --noproxy '*' -fsS --cacert /var/lib/lf-tls26/public/ca.crt --resolve lab26.test:8443:127.0.0.1 https://lab26.test:8443/
En la prueba original, después de la recarga, el número de serie de la nueva conexión cambió a 27 y la respuesta HTTP fue normal. Los workers antiguos pueden tardar un poco en terminar; compruebe de nuevo el certificado mediante una conexión nueva después de esa transición. Si la verificación de configuración falla, no se realiza la recarga y se investiga la correspondencia de archivos/claves y la ruta/permisos. Al restaurar este certificado de práctica, copie el server-before.crt conservado a server.crt y realice la verificación, la recarga y la comprobación de provisión del certificado en el mismo orden.
Utilice Certbot después de preparar un dominio público
Este procedimiento se aplica solo al operar un dominio real. Separado del sitio local en 127.0.0.1:8443, los registros A IPv4 y cualquier registro AAAA IPv6 publicado del dominio deben apuntar al servidor correcto, y el acceso HTTP-01 en el puerto 80 debe estar disponible en todas las rutas utilizadas. Además, verifique direcciones IPv6 incorrectas, proxy, CDN, firewall y configuraciones de NAT. Verifique el acceso al dominio desde otras redes y ajuste el server_name en el sitio de Nginx para que coincida con el dominio real.
Una ejecución de prueba de Certbot aún contacta el servicio de pruebas (staging) y puede ajustar y recargar temporalmente el servidor web. Primero haga una copia de seguridad de la configuración del sitio relevante. Si nginx -t o la validación en staging falla, deténgase y corríjalo antes de intentar la emisión en producción; los siguientes comandos no son un lote para ejecutar tras un error.
A continuación se muestra un comando condicional aplicado a un sitio Nginx ya preparado. Ingrese el dominio que controla y un correo electrónico de contacto, y primero haga una copia de seguridad de la configuración en el servidor real. --dry-run intenta una verificación en staging, por lo que no necesita ejecutarse en una VM sin condiciones externas.
read -r -p "Real domain you control: " domain
read -r -p "Certificate contact email: " email
sudo nginx -t
sudo certbot certonly --nginx --dry-run -d "$domain" --email "$email" --agree-tos
Los certificados de staging no son confiables para los clientes generales. Siguiendo las instrucciones de staging de Let’s Encrypt , primero resuelva los errores de validación y luego continúe con la emisión en producción. Incluso si la prueba en seco tiene éxito, el certificado de producción no se guarda. Bajo condiciones normales, el siguiente comando emite un certificado de producción y modifica la configuración de Nginx, por lo que los cambios deben ser revisados.
sudo certbot --nginx -d "$domain" --email "$email" --agree-tos --redirect
sudo certbot certificates
sudo nginx -t
curl -I "https://$domain/"
Compruebe el nombre del certificado y la ruta del directorio live a partir de la salida de certbot certificates. Nginx debe estar vinculado con fullchain.pem que contenga el certificado del servidor y los certificados intermedios requeridos, junto con el correspondiente privkey.pem. No termine la verificación simplemente confirmando que los archivos existen; verifique la respuesta HTTPS externa y confirme el nombre, el emisor y la fecha de expiración del certificado proporcionado.
La verificación de renovación operativa se realiza con sudo certbot renew --dry-run. La ayuda de la versión 4.0.0 instalada en la prueba original indica que los ganchos de implementación no se ejecutan en la ejecución simulada por defecto y que se debe agregar --run-deploy-hooks. Si ha configurado sus propios hooks de despliegue además de la reaplicación gestionada por el complemento de Nginx, revise sus destinos y las posibles recargas duplicadas, y se deben realizar pruebas incluyendo los ganchos dentro del alcance de mantenimiento.
certbot --help all | less
sudo certbot renew --dry-run
systemctl list-timers certbot.timer --no-pager
sudo journalctl -u certbot.service -n 50 --no-pager
El resultado de finalizar sin ninguna acción porque no hay nada que renovar no es evidencia de una renovación exitosa. Primero, verifique si realmente se están gestionando certificados, y registre por separado los resultados de la renovación, los resultados de la implementación y los certificados de nuevas conexiones en los momentos requeridos. Para el significado de plugins y hooks, consulte la Guía Oficial de Uso de Certbot , pero priorice comprobar la ayuda de la versión instalada y la configuración real.
Elimine solo el laboratorio TLS local
Los lectores que hayan configurado los ajustes públicos de Certbot no deben aplicar esta sección de limpieza a sitios públicos. El bloque a continuación elimina el enlace para lf-tls26 creado anteriormente, luego verifica y recarga, y solo elimina la clave dedicada, el certificado y la carpeta si la escucha en 8443 ha desaparecido. Dado que el almacén de confianza no ha sido modificado, tampoco hay necesidad de eliminar la CA del sistema.
sudo bash <<'ROOT'
set -euo pipefail
rm -- /etc/nginx/sites-enabled/lf-tls26
nginx -t
systemctl reload nginx
sleep 1
if ss -ltnH | grep -q '127.0.0.1:8443'; then echo 'TLS listener remains' >&2; exit 1; fi
rm -- /etc/nginx/sites-available/lf-tls26 /usr/local/sbin/lf-tls26-deploy /etc/nginx/lf-tls26/server.crt /etc/nginx/lf-tls26/server.key
rm -- /var/lib/lf-tls26/private/ca.key /var/lib/lf-tls26/private/server.csr /var/lib/lf-tls26/private/leaf.ext /var/lib/lf-tls26/private/server-before.crt /var/lib/lf-tls26/public/ca.crt
rmdir /etc/nginx/lf-tls26 /var/lib/lf-tls26/private /var/lib/lf-tls26/public /var/lib/lf-tls26
ROOT
En la VM de la prueba original, se eliminaron los sitios HTTPS dedicados, claves, CAs y scripts de implementación, y se conservó el hash de la configuración predeterminada original de Nginx. El paquete Certbot y los temporizadores activos permanecieron, pero no había certificados gestionados. Este estado no se considera el mismo que la operación de renovación automática de certificados públicos.




