Rocky Linux 10: tutorial / Emitir, renovar y supervisar certificados HTTPS con Certbot
Para operar HTTPS en Rocky Linux 10, debe no solo emitir certificados sino también aplicarlos al servidor web, ejecutar la renovación automática y monitorizar los certificados realmente servidos y su expiración. Este tutorial reproduce la emisión y renovación real de ACME usando una autoridad de certificación de prueba separada y distingue DNS, puertos y condiciones de confianza necesarias al aplicarlos a servicios públicos.
Diferencia entre los certificados públicos y los certificados de prueba locales
HTTPS protege la comunicación HTTP utilizando TLS (Seguridad de la Capa de Transporte). Las Autoridades de Certificación (CAs) firman certificados vinculando el nombre del sitio y la clave pública, y los clientes verifican el nombre, el período de validez y la cadena emisora. ACME (Entorno de Gestión Automática de Certificados) es un protocolo que automatiza la validación del control del dominio y la emisión y renovación de certificados, y Certbot es un cliente que realiza estas acciones.
Como explica la documentación de desafíos de Let’s Encrypt , la validación pública HTTP-01 solicita el archivo de autenticación en el puerto 80. Los registros A y AAAA del dominio, los cortafuegos externos, el reenvío de puertos y la ruta real del servidor web deben ser correctos. Modificar el archivo hosts local o elegir otro puerto de escucha de Certbot no cambia cómo se conecta la autoridad de certificación pública. DNS-01 valida mediante registros DNS TXT y necesita la automatización del proveedor DNS para renovar automáticamente.
| Entorno | Alcance de la validación y confianza |
|---|---|
| Esta práctica de Pebble | Dentro de la VM, en realidad verificamos el nombre de la prueba y HTTP-01. Es una CA de prueba privada y no es generalmente confiable por los navegadores. |
| Entorno de pruebas de Let’s Encrypt | Emitido para pruebas con DNS público y condiciones de acceso. Los certificados de prueba no son certificados generalmente confiables. |
| Autoridad de Certificación de Producción | Emitido para cumplir con los requisitos reales de dominio público y políticas. La confianza del cliente, los nombres, las cadenas y el acceso externo se verifican por separado. |
Guía de Entorno de Prueba de Let’s Encrypt recomienda realizar pruebas antes de la emisión en producción e introduce Pebble como un servidor ACME local para desarrollo. Este ejercicio no refleja resultados verificados utilizando emisión de prueba o producción con un dominio público.
Preparación de Herramientas y Entorno de Prueba ACME Local
Proceda en una máquina virtual separada con Rocky Linux 10. El entorno de laboratorio original fue Rocky Linux 10.2, Python 3.12.15, Certbot 5.10.0, Pebble 2.10.3, Nginx 1.26.3, OpenSSL 3.5.8, SELinux activado. El archivo de distribución de Pebble a continuación es para x86_64. Para otras arquitecturas de CPU, seleccione la distribución oficial correspondiente y su suma de verificación. No ejecute tal cual en servidores que ya tengan sitios, certificados o archivos de práctica con los mismos nombres.
El paquete EPEL Certbot en este entorno no se instaló porque algunas dependencias no coinciden con el repositorio de Rocky 10.2. Sin reemplazar forzosamente los paquetes del sistema, Certbot se instaló en un entorno virtual de Python dedicado. En la documentación de instalación de Certbot puede ver que el método pip es un método de soporte limitado que utiliza un entorno virtual. En producción, los métodos de instalación y las responsabilidades de actualización se determinan conjuntamente, y no se mezclan diferentes instalaciones de Certbot.
sudo dnf install python3 tar openssl nginx policycoreutils-python-utils
sudo ss -lntp
sudo bash <<'ROOT'
set -euo pipefail
test ! -e /root/lf-course26
test ! -e /usr/local/bin/lf-course26-pebble
for path in /etc/pki/tls/lf-course26 /etc/nginx/conf.d/lf-course26.conf /usr/local/sbin/lf-course26-deploy /usr/local/sbin/lf-course26-renew /etc/systemd/system/lf-course26-renew.service /etc/systemd/system/lf-course26-renew.timer; do
test ! -e "$path"
done
for port in 14000 15000 5001 5002 18426; do
listeners=$(ss -H -lnt "sport = :$port")
test -z "$listeners"
done
if grep -Eq '(^|[[:space:]])course26[.]test([[:space:]]|$)' /etc/hosts; then
printf 'The test hostname already exists in hosts. Stop.\n' >&2
exit 1
fi
install -d -m 0700 /root/lf-course26
cp -a /etc/hosts /root/lf-course26/hosts.before
cp -a /etc/nginx /root/lf-course26/nginx.before
python3 -m venv /root/lf-course26/venv
/root/lf-course26/venv/bin/python -m pip install 'certbot==5.10.0'
cd /root/lf-course26
curl -fL -o pebble.tar.gz https://github.com/letsencrypt/pebble/releases/download/v2.10.3/pebble-linux-amd64.tar.gz
printf '7e33cf3e426b67e9e647c44e8cc91683caa8ab331f7a99e5e27fcee291c4c7e2 pebble.tar.gz\n' | sha256sum -c -
tar -xzf pebble.tar.gz --strip-components=3
install -m 0755 pebble /usr/local/bin/lf-course26-pebble
restorecon /usr/local/bin/lf-course26-pebble
openssl req -x509 -newkey rsa:2048 -noenc -keyout api.key -out api.pem -days 2 -subj /CN=localhost -addext 'subjectAltName=DNS:localhost,IP:127.0.0.1'
chmod 0600 api.key
printf '\n127.0.0.1 course26.test # lf-course26\n' >> /etc/hosts
ROOT
Antes de la ejecución, asegúrese de que los números 14000, 15000, 5002 y 18426 no estén en uso, y que course26.test no esté en las entradas de hosts existentes. El sudo bash que está dentro se ejecuta con privilegios de administrador, y si ocurre un error, los comandos posteriores se detienen. Se debe comparar el valor SHA-256 esperado del archivo de distribución con la información de la versión del lanzamiento oficial. No ejecute si el hash es diferente.
Ejecute sudoedit /root/lf-course26/pebble.json y guarde el siguiente contenido en /root/lf-course26/pebble.json. El certificado de acceso API api.pem y los certificados emitidos para sitios posteriores son diferentes entre sí. Ambas APIs solo reciben conexiones en la dirección loopback y no modifican el almacén de CA a nivel del sistema.
{
"pebble": {
"listenAddress": "127.0.0.1:14000",
"managementListenAddress": "127.0.0.1:15000",
"certificate": "/root/lf-course26/api.pem",
"privateKey": "/root/lf-course26/api.key",
"httpPort": 5002,
"tlsPort": 5001,
"keyAlgorithm": "ecdsa",
"profiles": {
"default": {
"description": "Local course26 test",
"validityPeriod": 7776000
}
}
}
}
sudo systemd-run --unit=lf-course26-pebble --property=WorkingDirectory=/root/lf-course26 --setenv=PEBBLE_VA_NOSLEEP=1 --setenv=PEBBLE_AUTHZREUSE=0 /usr/local/bin/lf-course26-pebble -config /root/lf-course26/pebble.json
sudo curl --retry 3 --retry-connrefused --cacert /root/lf-course26/api.pem -fsS https://localhost:14000/dir
sudo curl --cacert /root/lf-course26/api.pem -fsS https://localhost:15000/roots/0 -o /root/lf-course26/issuer-root.pem
La primera consulta devuelve un JSON que contiene la ruta de ACME, y la segunda guarda el certificado raíz de la cadena de emisión de prueba. PEBBLE_VA_NOSLEEP=1 solo elimina retrasos artificiales, y PEBBLE_AUTHZREUSE=0 deshabilita la reutilización de resultados de autorización previos para observar la verificación repetida. No utilice modos que siempre traten la verificación como exitosa. El estado de la autoridad certificadora de Pebble se almacena en memoria durante la ejecución, por lo que no se debe asumir que los estados anteriores de raíz, cuenta o emisión se conservan después de un reinicio. Si se reinicia, verifique nuevamente la emisión y las relaciones de confianza del nuevo entorno de prueba. Para configuraciones detalladas, consulte Pebble 2.10.3 README oficial .
El primer intento de colocar el binario para ser ejecutado por systemd en /root falló debido a la denegación de permisos en la etapa de ejecución. Después de colocarlo en la ruta de ejecución estándar /usr/local/bin y restaurar el contexto, se ejecutó normalmente. Cuando aparezca 203/EXEC, revise journalctl -u lf-course26-pebble junto con la ruta del archivo, los permisos y el contexto de SELinux, y no lo resuelva deshabilitando las funciones de seguridad.
Emitir un certificado de prueba mediante la validación HTTP-01
sudo env REQUESTS_CA_BUNDLE=/root/lf-course26/api.pem /root/lf-course26/venv/bin/certbot certonly --standalone --http-01-address 127.0.0.1 --http-01-port 5002 --preferred-challenges http --server https://localhost:14000/dir --config-dir /root/lf-course26/config --work-dir /root/lf-course26/work --logs-dir /root/lf-course26/logs --cert-name course26 --register-unsafely-without-email --agree-tos --non-interactive -d course26.test
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -serial -dates -issuer -ext subjectAltName
sudo journalctl -u lf-course26-pebble -n 25 --no-pager
Este comando crea una cuenta solo en el servidor de prueba local, y un servidor independiente temporal proporciona el archivo de autenticación en el puerto 5002. La opción de omitir el correo electrónico está limitada a esta prueba privada. REQUESTS_CA_BUNDLE se utiliza solo para la confianza TLS de la API de esa ejecución. No hay necesidad de una opción para omitir la verificación TLS.
En los registros de origen, los registros muestran tres verificaciones usando http://course26.test:5002/.well-known/acme-challenge/... y la autenticación se completó, y se emitió el certificado. Este puerto 5002 es el puerto de prueba configurado en Pebble. Este puerto local personalizado no implica que una CA pública HTTP-01 valide en un puerto arbitrario.
cert.pem es el certificado del sitio, chain.pem es el certificado intermedio, fullchain.pem es el certificado del sitio y la cadena intermedia, y privkey.pem es la clave privada. Los archivos dentro de live son enlaces simbólicos a archivos versionados en archive. Las claves privadas y las claves de cuenta no deben colocarse en la ruta de documentos web o en copias de seguridad públicas. Esta configuración establece el período de validez de prueba en 90 días, pero no se debe asumir un período de validez uniforme para los certificados de producción; verifique el notAfter real.
Aplicando a Nginx y verificando el nombre y la cadena
El sitio de prueba se proporciona únicamente desde 127.0.0.1:18426. Los certificados se despliegan en una ruta TLS dedicada desde la cual Nginx leerá, sin exponer directamente la ruta de almacenamiento de Certbot. Primero, verifique que la nueva ruta y el puerto no se estén usando en la configuración existente.
sudo install -d -m 0700 /etc/pki/tls/lf-course26
sudo install -m 0644 /root/lf-course26/config/live/course26/fullchain.pem /etc/pki/tls/lf-course26/fullchain.pem
sudo install -m 0600 /root/lf-course26/config/live/course26/privkey.pem /etc/pki/tls/lf-course26/privkey.pem
sudo restorecon -Rv /etc/pki/tls/lf-course26
sudo semanage port -a -t http_port_t -p tcp 18426
Ejecute sudoedit /etc/nginx/conf.d/lf-course26.conf y guarde el bloque completo en ese archivo. Mantenga la configuración del sitio por defecto en el puerto 80.
server {
listen 127.0.0.1:18426 ssl;
server_name course26.test;
ssl_certificate /etc/pki/tls/lf-course26/fullchain.pem;
ssl_certificate_key /etc/pki/tls/lf-course26/privkey.pem;
location / {
default_type text/plain;
return 200 "LF26 HTTPS works\n";
}
}
sudo nginx -t && sudo systemctl start nginx
sudo curl --cacert /root/lf-course26/issuer-root.pem --resolve course26.test:18426:127.0.0.1 -sS -w 'HTTP %{http_code}\n' https://course26.test:18426/
Si Nginx ya se está ejecutando, aplique la nueva configuración con sudo systemctl reload nginx en lugar de start. Este ejercicio se verificó en el caso iniciado desde un estado detenido. LF26 HTTPS works y 200 son los resultados esperados. --resolve especifica solo la dirección de acceso para esta solicitud mientras mantiene el nombre de URL y TLS SNI (Indicación de Nombre de Servidor). --cacert especifica solo la CA de prueba para este laboratorio y no cambia la configuración de confianza de un navegador normal.
En la comparación real, curl sin especificar la raíz de prueba falló con el código de salida 60 porque no podía confiar en la cadena de emisión. Incluso si se especifica la raíz de prueba, cambiar el nombre de la URL a wrong26.test resulta en el mismo código de salida 60 debido a la incongruencia del nombre del certificado. No distinga la causa únicamente por el código de salida; verifique también el mensaje de error. Verifique tanto la negociación TLS exitosa como la identidad del servidor presentada al cliente. Esta prueba no configura la autenticación de cliente TLS mutua.
Verificación real de renovación y despliegue de hooks
Incluso si Certbot guarda un nuevo archivo de certificado, el certificado de Nginx copiado a una ruta separada no cambia automáticamente. El hook de despliegue, ejecutado después de una renovación exitosa, se encarga de la copia, la restauración del contexto, la verificación de la configuración y la recarga. Ejecute sudoedit /usr/local/sbin/lf-course26-deploy y guarde el siguiente contenido en ese archivo. Este hook está limitado al nombre de prueba y la ruta de almacenamiento para este laboratorio.
#!/bin/bash
set -euo pipefail
test "${RENEWED_LINEAGE:-}" = /root/lf-course26/config/live/course26
openssl x509 -in "$RENEWED_LINEAGE/cert.pem" -noout -checkend 0
openssl verify -CAfile /root/lf-course26/issuer-root.pem -untrusted "$RENEWED_LINEAGE/chain.pem" -verify_hostname course26.test "$RENEWED_LINEAGE/cert.pem"
BACKUP=$(mktemp -d /root/lf-course26/deploy-backup.XXXXXXXX)
cp -a /etc/pki/tls/lf-course26/fullchain.pem /etc/pki/tls/lf-course26/privkey.pem "$BACKUP/"
install -m 0644 "$RENEWED_LINEAGE/fullchain.pem" /etc/pki/tls/lf-course26/fullchain.pem
install -m 0600 "$RENEWED_LINEAGE/privkey.pem" /etc/pki/tls/lf-course26/privkey.pem
restorecon -R /etc/pki/tls/lf-course26
if ! nginx -t || ! systemctl reload nginx; then
install -m 0644 "$BACKUP/fullchain.pem" /etc/pki/tls/lf-course26/fullchain.pem
install -m 0600 "$BACKUP/privkey.pem" /etc/pki/tls/lf-course26/privkey.pem
nginx -t && systemctl reload nginx
exit 1
fi
openssl x509 -in "$RENEWED_LINEAGE/cert.pem" -noout -serial >> /root/lf-course26/deploy-serials.log
Antes de aplicar, verifique la cadena, el nombre y la fecha de expiración, y guarde los archivos de implementación existentes en un lugar protegido. Si la verificación de configuración o la recarga fallan, restaure los archivos de despliegue anteriores y termine con un error. Si la restauración también falla, debe revisar los registros del servicio y la respuesta real, y no se considerará una recuperación automática exitosa. Esta vez, se ejecutó para verificación la ruta donde se desplegó el certificado normal, y esta rama de recuperación por falla no se reprodujo deliberadamente.
Ejecute sudoedit /usr/local/sbin/lf-course26-renew y guarde el contenido siguiente en ese archivo. Ejecute el script de consola de Certbot con Python en el entorno virtual.
#!/bin/bash
set -euo pipefail
export REQUESTS_CA_BUNDLE=/root/lf-course26/api.pem
exec /root/lf-course26/venv/bin/python /root/lf-course26/venv/bin/certbot renew --server https://localhost:14000/dir --config-dir /root/lf-course26/config --work-dir /root/lf-course26/work --logs-dir /root/lf-course26/logs --cert-name course26 --non-interactive --no-random-sleep-on-renew --deploy-hook /usr/local/sbin/lf-course26-deploy "$@"
sudo chmod 0750 /usr/local/sbin/lf-course26-deploy /usr/local/sbin/lf-course26-renew
sudo restorecon /usr/local/sbin/lf-course26-deploy /usr/local/sbin/lf-course26-renew
sudo /usr/local/sbin/lf-course26-renew --force-renewal
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -serial
sudo bash -o pipefail <<'BASH'
openssl s_client -connect 127.0.0.1:18426 -servername course26.test -verify_hostname course26.test -CAfile /root/lf-course26/issuer-root.pem -verify_return_error </dev/null | openssl x509 -noout -serial
BASH
--force-renewal es una opción para observar la renovación en esta prueba local. La renovación forzada no se aplica al temporizador de producción. El número de serie inicial era 4DFCA979CEB14834, y el número guardado y proporcionado después de la renovación real fue 4E9CBB509103CA00. En la primera conexión inmediatamente después del comando de recarga, se observó brevemente el certificado anterior, y después de reconectar, se confirmó la coincidencia entre el número guardado y el número proporcionado. No juzgue que la aplicación del servicio está completa solo por verificar la finalización del comando.
sudo bash <<'ROOT'
set -euo pipefail
sha256sum /root/lf-course26/config/live/course26/cert.pem > /root/lf-course26/dryrun-before.sha256
/usr/local/sbin/lf-course26-renew --dry-run --run-deploy-hooks
sha256sum -c /root/lf-course26/dryrun-before.sha256
ROOT
La renovación simulada real ejecutó con éxito HTTP-01 y los hooks, y el hash del certificado actual permaneció igual. Los hooks especificados para la prueba en seco en --run-deploy-hooks usan el certificado actualmente activo, no un certificado de prueba temporal. La operación y las opciones también se pueden confirmar en Guía del Usuario de Certbot . Una prueba en seco exitosa no significa que el archivo actual haya sido reemplazado por un nuevo certificado.
Verifique por separado la ejecución del temporizador y el monitoreo de la expiración.
Ejecute sudoedit /etc/systemd/system/lf-course26-renew.service y guarde la siguiente unidad de servicio en ese archivo.
[Unit]
Description=Local course26 certificate renewal test
[Service]
Type=oneshot
ExecStart=/usr/local/sbin/lf-course26-renew
Ejecute sudoedit /etc/systemd/system/lf-course26-renew.timer y guarde la siguiente unidad de temporizador en ese archivo. OnActiveSec=3s es una línea para observar la ejecución programada inmediata en la práctica. En producción, elimine esta línea de prueba y establezca los tiempos de ejecución y los retrasos de distribución según la carga de servicio y la política de gestión.
[Unit]
Description=Local course26 renewal timer test
[Timer]
OnActiveSec=3s
OnCalendar=*-*-* 03,15:00:00
Persistent=true
Unit=lf-course26-renew.service
[Install]
WantedBy=timers.target
sudo systemctl daemon-reload
sudo systemctl start lf-course26-renew.timer
systemctl list-timers lf-course26-renew.timer --no-pager
systemctl show lf-course26-renew.service -p Result -p ExecMainStatus -p ActiveState
sudo journalctl -u lf-course26-renew.service -n 25 --no-pager
La llamada del temporizador de origen ocurrió después de 3 segundos, y los estados finales fueron Result=success, ExecMainStatus=0 y ActiveState=inactive. El certificado aún no estaba próximo a renovarse, por lo que el registro indicó que se omitieron los hooks de reemisión y despliegue. Por lo tanto, 'el temporizador se ejecutó', 'intentó actualizarse' y 'se emitió/distribuyó un nuevo certificado' son elementos de confirmación separados. Es normal que un servicio de una sola ejecución esté inactivo después de finalizar normalmente. 'Iniciar' se refiere a esta ejecución de arranque, y los ajustes de habilitación son necesarios por separado para la ejecución automática al reiniciar.
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -enddate
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -checkend 604800
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -checkend 8640000
Este certificado de prueba no caduca dentro de 7 días, lo que resulta en un código de salida 0 en una verificación de 604,800 segundos, y caduca dentro de 100 días, lo que da como resultado 1 en una verificación de 8,640,000 segundos. Esto último no significa "ya expirado". -checkend verifica la caducidad dentro del número especificado de segundos. Por favor, consulte el significado de las opciones en el documento OpenSSL x509 . La supervisión operativa no solo verifica archivos locales, sino también certificados realmente proporcionados externamente, y en caso de fallo, se debe probar la ruta de notificación para que el administrador pueda ser informado.
Condiciones para cambiar al solicitar servicios públicos
En un dominio real, no se utilizan CA de prueba privadas, entradas de hosts, verificación del puerto 5002 ni APIs de loopback. Primero, compruebe el DNS público y las conexiones externas al puerto 80, y si desea mantener el servidor web existente, puede proporcionar el archivo de autenticación usando el método webroot. Prepare una ruta separada de Certbot y un directorio de configuración para la operación, y no mezcle cuentas de prueba ni certificados de prueba con certificados operativos.
- Verifique que los registros A y AAAA de su dominio apunten al servidor real y sean accesibles externamente. Además, compruebe que los registros IPv6 no utilizados no apunten a servidores incorrectos.
- En Nginx, verifique desde fuera que el archivo de prueba
/.well-known/acme-challenge/se esté sirviendo en la ruta de documento correcta. El bloqueo de rutas ocultas, los requisitos de autenticación o redirecciones incorrectas pueden interferir con la verificación. - Primero, realice la verificación pública de staging desde el Certbot operativo hacia
certonly --webroot -w /srv/example-webroot -d www.example.com --dry-run. Reemplace el webroot y el dominio de ejemplo con sus valores reales, ingrese un correo electrónico de cuenta accesible y revise los términos de la CA. - Después de una prueba exitosa, realice la emisión operativa y aplique las rutas de la cadena completa y la clave privada en Nginx. Los hooks de renovación operativa deben escribirse según la ruta real, el nombre y la cadena de confianza, y los hooks de la CA privada de este tutorial no deben reutilizarse tal cual.
- Verifique la respuesta externa en el puerto 443, nombre, cadena, expiración, prueba de renovación y hook de despliegue, así como la próxima ejecución y el resultado reciente del temporizador. También siga las políticas y restricciones de emisión y renovación requeridas por la CA pública.
Esta sección es para las condiciones para cambiar al servicio público. La verificación local en esta ocasión no puede considerarse como confirmación de DNS, cortafuegos de internet, o emisión por una autoridad certificadora pública para el dominio que realmente posee.
Deteniendo el entorno de prueba y restaurando la configuración existente
Después de terminar la prueba, primero detenga el temporizador y Pebble. Mueva los archivos de Nginx que creó a la ubicación de respaldo, y después de la inspección y recarga, solo permanece el sitio predeterminado existente.
sudo systemctl stop lf-course26-renew.timer lf-course26-renew.service lf-course26-pebble.service
sudo mv /etc/nginx/conf.d/lf-course26.conf /root/lf-course26/lf-course26.conf.saved
sudo nginx -t && sudo systemctl reload nginx
sudo semanage port -d -p tcp 18426
sudo rm -- /etc/systemd/system/lf-course26-renew.service /etc/systemd/system/lf-course26-renew.timer
sudo systemctl daemon-reload
En el archivo /etc/hosts de la VM Rocky, elimine únicamente la línea exacta añadida durante esta práctica. Si no hay otras modificaciones, se puede restaurar comparando con el original protegido. Además, después de verificar la propiedad, elimine los ejecutables de prueba no utilizados, los certificados de distribución dedicados y los archivos de estado del temporizador, y conserve los archivos o reglas utilizados por otros sitios. Si almacena claves secretas e información de cuentas, protéjalas con permisos solo para root como antes.
Después de la limpieza en el laboratorio de origen, Nginx, la configuración del firewall, los hosts y la política local de SELinux eran los mismos que antes del ejercicio, y el contenido del sitio predeterminado existente también era el mismo. SSH y firewalld permanecieron activos, y SELinux continuó en modo Enforcing. Se eliminaron la API de prueba, los oyentes HTTPS y las tareas programadas, y solo se conservó la carpeta de registros dedicada con permisos 0700.




