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
| Palabra | Qué significa |
|---|---|
| Directorio | la lista de direcciones ACME de la CA |
| Cuenta | un par de claves con el que la CA reconoce al cliente |
| Pedido (order) | una solicitud de un certificado y sus nombres |
| Autorización | el registro de la CA de la prueba de un nombre |
| Finalizar | enviar la solicitud de firma cuando todos los nombres están probados |
| CSR | una 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
docker exec client curl -s https://ca:9000/acme/acme/directory --cacert /ca/certs/root_ca.crtSe 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 respuesta | Para qué lo usa el cliente |
|---|---|
| newNonce | Conseguir un nonce nuevo antes de una petición |
| newAccount | Registrar la clave de la cuenta |
| newOrder | Pedir un certificado para unos nombres |
| revokeCert | Decir que ya no hay que confiar en un certificado |
| keyChange | Cambiar 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
docker exec python python3 steps/order.pySe muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.
Lo que muestra el pedido grabado
| Paso | Estado | Lo que pasó |
|---|---|---|
| 1 new-account | account valid | La clave del cliente ya es una cuenta |
| 2 new-order | order pending | Pide un certificado para shop |
| 3 y 4 authorization, challenge | pending, luego processing | El cliente dice: ven a mirar |
| 5 authorization | valid | La CA descargó la prueba y coincidía |
| 6 a 8 order, finalize, order | ready, processing, valid | La CSR queda firmada |
| 9 certificate | issued | El 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
docker exec client step ca certificate client client.crt client.key --provisioner acme --standalone --forceSe muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.
Mira lo que te han dado
docker exec client step certificate inspect client.crt --shortSe 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.