Laboratorio de automatización de certificados: ACME, certificados TLS de vida corta y renovación automática con una CA privada

Este laboratorio da a cada estudiante su propio pequeño mundo de certificados TLS: una autoridad de certificación (CA) privada que habla ACME, el protocolo con el que los programas consiguen certificados sin que nadie teclee, un servidor web que obtiene y renueva solo su certificado, la línea de comandos step para pedir uno a mano, y Python con OpenSSL para leerlos. Los certificados públicos duran como mucho 200 días desde marzo de 2026 y durarán 47 días desde marzo de 2029, así que la renovación tiene que ser automática, y aquí es donde los estudiantes ven cómo.

No es un laboratorio de ataque. Cada copia no tiene ruta a internet ni a ningún otro estudiante, y ningún navegador confía en nada de lo que hay dentro: la CA crea sus propias claves la primera vez que arranca el laboratorio. No tiene página web, así que todo se escribe en el terminal de al lado, y la CA firma certificados que duran 24 horas, de modo que renovar es algo diario y no anual.

Qué aprenden los estudiantes

Cómo se lee un certificado con openssl x509 (sus nombres en el nombre alternativo del sujeto, su emisor, sus fechas y la cadena hasta una raíz, comprobada con openssl verify), cómo va un pedido ACME desde la cuenta hasta el certificado descargado (el directorio de la CA, un pedido, un desafío, finalize), cómo el desafío http-01 se supera para un nombre que controlas y falla para uno que no, cuándo renovar (dos tercios de la vida útil, step certificate needs-renewal, jitter y ACME Renewal Information), por qué la revocación solo ayuda a los clientes que comprueban mientras que una vida útil corta limita una clave robada para todos, y cómo se gestiona la renovación a escala: sondear el certificado en vivo, un inventario y alertas. Sirve para un curso de seguridad de redes, de administración de sistemas o de DevOps, y el módulo Certificados de vida corta y automatización con ACME se trabaja en él.

Ejecútalo en tu navegador

El laboratorio arranca cuatro servicios, ca, shop, client y python, y espera a que cada uno esté sano. Para entonces el servidor web ya le ha pedido su certificado a la CA. El terminal llega a cada servicio con docker exec seguido de su nombre.

  1. Abre la página Contenedor. Abre «Crear» en la barra y elige «Ejecutar un contenedor». Cualquiera puede abrir la página, y el laboratorio de Git y el de SQL se inician sin cuenta. Todos los demás laboratorios necesitan una cuenta gratuita: crea una, inicia sesión y pulsa «Iniciar».
  2. Busca el laboratorio. La tarjeta «Laboratorios de ejemplo» lista todos los ejemplos. Busca Certificados: ACME y renovación automática.
  3. Pulsa «Iniciar». «Iniciar» lo ejecuta tal cual, con una sola pulsación. «Editar el archivo primero» abre el archivo compose para que lo cambies antes de iniciarlo.
  4. Ábrelo. En la página del laboratorio, pulsa «Abrir terminal». No hay enlace bajo «En tu navegador» porque el laboratorio no tiene página web. Escribe docker exec client curl -sS --cacert /ca/certs/root_ca.crt https://shop y la tienda responde por HTTPS con un certificado de la propia CA del laboratorio. Después, docker exec python python3 steps/read_shop.py imprime los nombres para los que vale, su emisor y su vida útil de 24 horas.

Qué es real y qué es un modelo

Real: la CA (step-ca) y su directorio ACME, las cuentas y los pedidos, el servidor web (Caddy) que obtiene y renueva su certificado por http-01, un certificado pedido a mano con el cliente step, http-01 fallando para un nombre al que nadie responde y para un nombre que tiene otro servidor, la cadena leída y verificada con OpenSSL, las comprobaciones de renovación, y una revocación seguida de la renovación que la CA rechaza. Modelos en Python, que lo dicen en la página: dns-01, porque el laboratorio no tiene un servidor DNS al que un estudiante pueda añadir un registro TXT, y ACME Renewal Information (RFC 9773), porque la CA del laboratorio aún no lo ofrece. Los dos siguen las reglas del propio protocolo sobre valores inventados. Los números de serie y las fechas cambian cada vez que se emite un certificado, así que los scripts imprimen vidas útiles y reglas, no fechas.

Qué pedir a los estudiantes que entreguen

Un informe breve: el certificado de la tienda leído con openssl (sujeto, nombres, emisor, vida útil y cadena), un certificado que hayan pedido ellos mismos, una comprobación de renovación que dice que sí y otra que dice que no, una revocación seguida de la renovación que la CA rechazó, y una frase sobre por qué los certificados de vida corta hacen el trabajo que debía hacer la revocación. Una buena frase dice que la mayoría de los clientes no comprueban la revocación, así que solo la fecha de fin detiene una clave robada para todos.

A basic lesson on this lab

Certificate Automation Basics es una lección pequeña que se hace en este laboratorio. En ella el estudiante lee el directorio ACME de la CA, abre la tienda por HTTPS y lee su certificado, pide un certificado a mano, ve cómo se rechaza un nombre que no controla, y comprueba si un certificado necesita renovarse.

Las cuentas personales gratuitas la tienen en el módulo Basics, que está en Inicio, cada centro puede copiarla desde la carpeta Basics de la Biblioteca, y un centro nuevo la tiene en un módulo llamado DevOps Labs (Sample). Es deliberadamente pequeña: muestra a un docente qué es una lección que se hace en un laboratorio, y el laboratorio hace el resto. Cópiala en un módulo propio para cambiarla.

El código en GitHub

El archivo compose no tiene Dockerfile: ejecuta imágenes públicas estándar fijadas a una versión, step-ca para la CA y el cliente (Apache-2.0), Caddy para el servidor web (Apache-2.0) y la imagen oficial de Python, que trae OpenSSL, con 384 MB de memoria en total. No distribuimos ninguna de ellas. La CA guarda sus claves en un volumen con nombre, así que los certificados emitidos antes de parar el laboratorio siguen verificándose después de arrancarlo, y los demás servicios solo leen su raíz. Los scripts de steps/ los escribe el propio archivo compose a partir de texto fijo. El laboratorio no tiene salida a internet ni guarda ninguna clave ni contraseña: la CA crea las suyas, al azar, cuando arranca por primera vez.

Ponlo como trabajo

Indica en la tarea qué hay que entregar.

  1. Crea el laboratorio. En tu módulo añade una tarea y elige la tarjeta «Laboratorio de contenedores», y después «En un repositorio de GitHub». Indica https://github.com/mitsurutech/lab-acme-lab con la rama main. El archivo compose es el predeterminado, compose.yaml. Haz un fork del repositorio antes si quieres modificarlo.
  2. Publica y pruébalo. «Publicar» fija el commit que te mostraron, así que un cambio posterior en el repositorio no altera un laboratorio que ya has asignado. Inicia primero tu propia copia.
  3. Asígnalo. Asígnalo como cualquier tarea, con una fecha de entrega si quieres, e indica en la tarea qué hacer y qué entregar.
  4. Califica lo entregado. Abre la copia de un alumno y el trabajo que ha entregado, califícalo y devuélvelo con un motivo si necesita más.

Prueba este laboratorio, y lo que cuesta

Con una cuenta personal gratuita puedes seguir las lecciones básicas de este laboratorio, con crédito gratuito suficiente cada mes para seguir la mayoría de las lecciones y sin tarjeta. Para una clase, un centro tiene gratis sus primeros 365 días, hasta 50 alumnos, y después paga por alumno y año, con todos los laboratorios incluidos y el profesorado gratis.

Preguntas frecuentes

¿Por qué los certificados de este laboratorio duran solo 24 horas?
Es el valor por defecto de la propia CA del laboratorio, y hace que los estudiantes vean una renovación en una sola sesión y no una vez al año. Los certificados públicos van en la misma dirección: 200 días desde marzo de 2026, 100 desde marzo de 2027 y 47 desde marzo de 2029.
¿Confiará un navegador en el certificado de la tienda?
No, y no debe hacerlo. La raíz pertenece solo a esta copia del laboratorio, creada cuando arrancó por primera vez. Dentro del laboratorio, a curl y a OpenSSL se les dice que confíen en ella con --cacert y -CAfile, que es exactamente lo que hace una empresa con su propia CA privada.
¿Por qué dns-01 y ARI son modelos y no lo real?
dns-01 necesita un servidor DNS al que el estudiante pueda añadir un registro TXT, y el laboratorio no lo tiene. ACME Renewal Information necesita una CA que lo ofrezca, y la CA del laboratorio aún no lo hace. Los dos se calculan en Python con las reglas del propio protocolo, así que los valores son los que calcularía un cliente real.
¿Por qué un certificado revocado sigue verificándose?
step certificate verify, como la mayoría de los clientes, comprueba las firmas y las fechas y no pregunta a la CA si el certificado fue revocado. La propia CA sí lo recuerda, y por eso después se niega a renovarlo. Ese hueco es la idea de la lección: solo la fecha de fin detiene una clave robada para todos los clientes.