¿Te resulta más fácil leer con fondo crema, un tono de color, más contraste o un texto más grande? Elige tus colores y tu texto una sola vez, para todas las páginas.

Lección gratuita

Cómo funciona el protocolo ACME

Después de esta lección: Puedo describir los pasos de un pedido ACME, desde la cuenta hasta el certificado descargado.

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

ACME consigue un certificado sin que nadie teclee

ACME (Automatic Certificate Management Environment) es el protocolo con el que un programa pide certificados a una CA sin intervención humana. Lo define el RFC 8555.

Sin él, un certificado de 47 días significa que alguien lo renueva cada pocas semanas, para cada nombre. Con él, la renovación es un trabajo que se hace solo.

Al final de esta lección

Nota

Puedo describir los pasos de un pedido ACME, desde la cuenta hasta el certificado descargado.

Palabras clave

PalabraQué significa
Directoriola lista de direcciones ACME de la CA
Cuentaun par de claves con el que la CA reconoce al cliente
Pedido (order)una solicitud de un certificado y sus nombres
Autorizaciónel registro de la CA de la prueba de un nombre
Finalizarenviar la solicitud de firma cuando todos los nombres están probados
CSRuna solicitud de firma de certificado que contiene la clave pública

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Todo empieza en el directorio

Al cliente se le da una sola dirección, la del directorio. La lee y allí encuentra todas las demás. Dicen dónde pedir un nonce, crear una cuenta, hacer un pedido, revocar y cambiar de clave.

Un nonce es un número que se usa una sola vez. Cada petición lleva uno nuevo, así que nadie puede volver a enviar una petición antigua.

Lee el directorio de la CA del laboratorio

Comando
docker exec client curl -s https://ca:9000/acme/acme/directory --cacert /ca/certs/root_ca.crt

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Lo que lista el directorio

Nombre en la respuestaPara qué lo usa el cliente
newNonceConseguir un nonce nuevo antes de una petición
newAccountRegistrar la clave de la cuenta
newOrderPedir un certificado para unos nombres
revokeCertDecir que ya no hay que confiar en un certificado
keyChangeCambiar la clave de la cuenta por otra nueva

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Un pedido pasa por cinco estados

Cada petición va firmada con la clave de la cuenta. El cliente hace un pedido para unos nombres. Cada nombre recibe una autorización, que ofrece desafíos.

El pedido está en pending hasta que todos los nombres están probados, y luego pasa a ready. El cliente lo finaliza con una CSR y el pedido pasa a processing y después a valid. Una prueba fallida lo deja en invalid.

Imprime un pedido grabado paso a paso

Comando
docker exec python python3 steps/order.py

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Lo que muestra el pedido grabado

PasoEstadoLo que pasó
1 new-accountaccount validLa clave del cliente ya es una cuenta
2 new-orderorder pendingPide un certificado para shop
3 y 4 authorization, challengepending, luego processingEl cliente dice: ven a mirar
5 authorizationvalidLa CA descargó la prueba y coincidía
6 a 8 order, finalize, orderready, processing, validLa CSR queda firmada
9 certificateissuedEl cliente descarga la cadena

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Un error frecuente

Advertencia

Mucha gente cree que la CA crea la clave del servidor y se la envía. El cliente crea su propio par de claves y solo envía la mitad pública, dentro de la CSR. La clave privada nunca sale del servidor.

Ahora haz un pedido real

El contenedor client tiene el comando step, que ya sabe dónde está la CA y en qué raíz confiar. La siguiente ejecución crea una cuenta, pide un certificado para el nombre client, lo prueba con http-01 y finaliza.

Imprime done! para el desafío, la espera hasta ready y la finalización, y después nombra client.crt y client.key.

Pide un certificado para client

Comando
docker exec client step ca certificate client client.crt client.key --provisioner acme --standalone --force

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Mira lo que te han dado

Comando
docker exec client step certificate inspect client.crt --short

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Tu certificado, en resumen

La vista corta muestra Subject: client, Issuer: Lab Private CA Intermediate CA y Provisioner: acme, con tu propio número de serie y unas fechas separadas por un día.

La tienda hizo lo mismo sola al arrancar. Escribe docker logs shop en el terminal para ver sus líneas de cuenta, pedido, desafío y finalización. Sus horas e identificadores son los suyos.

Sobre este laboratorio y su código: Laboratorio de automatización de certificados: ACME, certificados TLS de vida corta y renovación automática con una CA privada

¿Enseñas a una clase? Asigna este módulo a tus alumnos con guía del profesor, tareas con corrección automática y un laboratorio para cada alumno.