¿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

Desafíos ACME: HTTP-01 y DNS-01

Después de esta lección: Puedo calcular el valor que publica un desafío HTTP-01 o DNS-01 y decir qué desafío necesita un nombre.

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

Cómo comprueba la CA tu nombre

Un desafío ACME es la prueba que pone una CA para comprobar que controlas un nombre de dominio antes de firmarle un certificado. HTTP-01 te pide publicar un valor en una dirección web, y DNS-01 te pide publicarlo en un registro DNS.

Si eliges mal, la renovación falla a las tres de la madrugada.

Al final de esta lección

Nota

Puedo calcular el valor que publica un desafío HTTP-01 o DNS-01 y decir qué desafío necesita un nombre.

Palabras clave

PalabraQué significa
Huella (thumbprint)un hash corto que representa la clave de la cuenta
Autorización de claveel valor de la CA, un punto y la huella
HTTP-01una prueba servida en el puerto 80 en una ruta fija
DNS-01una prueba publicada en un registro TXT
Registro TXTun registro DNS que guarda texto plano
Comodínun nombre como *.shop.example que cubre un nivel

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

Los dos desafíos publican una autorización de clave

La CA elige un valor aleatorio para cada desafío. El cliente lo une con un punto a la huella de la clave de su cuenta. El resultado es la autorización de clave.

Solo quien tiene la clave de la cuenta puede crearla. Publicarla prueba dos cosas a la vez: que controlas el nombre y que eres esa cuenta.

HTTP-01 la sirve en el puerto 80

Con HTTP-01 la CA descarga http://<name>/.well-known/acme-challenge/<value> en el puerto 80. La respuesta tiene que ser la autorización de clave.

Va bien para un servidor web al que ya se llega con ese nombre. No puede probar un comodín, y falla si el puerto 80 está cerrado o el nombre apunta a otro sitio.

Calcula las dos pruebas en Python

Comando
docker exec python python3 steps/challenges.py

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

Lo que imprime el modelo

LíneaLo que significa
key authorisation: e8Kq2LvX0n4RcT7wYb1mPz9hJd3s.jW5aL0b7Qm3x...El valor de la CA, un punto, la huella
http://shop.example/.well-known/acme-challenge/e8Kq2LvX0n4RcT7wYb1mPz9hJd3sDónde se descarga HTTP-01
_acme-challenge.shop.example TXT vmbbIVBfAfWejbz8l4MJmQwQ6JlM5mjoPCqB4qPA2HwEl registro de DNS-01
43 charactersUn hash SHA-256 en base64url, sin relleno
*.shop.example dns-01 onlyUn comodín necesita DNS-01

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

DNS-01 pone un hash en el DNS

Con DNS-01 el cliente calcula el SHA-256 de la autorización de clave y lo escribe, en base64url, como registro TXT en _acme-challenge.<name>. La CA consulta ese registro.

No hace falta que nada sea accesible desde internet, así que un servidor interno puede probar su nombre. Es el único desafío posible para un comodín. El precio: el cliente necesita una clave que pueda cambiar tu DNS.

Ejemplo resuelto: elegir un desafío

Nombre o situaciónDesafíoPor qué
shop.example en un servidor web públicoHTTP-01El puerto 80 ya está abierto
*.shop.exampleDNS-01Un comodín solo se puede probar en el DNS
Un servidor del personal al que no se llega desde fueraDNS-01La CA nunca se conecta a él
Puerto 80 bloqueado, puerto 443 abiertoTLS-ALPN-01Un tercer desafío, probado por TLS en el 443

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

Un error frecuente

Advertencia

Mucha gente cree que HTTP-01 se comprueba en el puerto 443 porque el sitio funciona con HTTPS. La CA siempre descarga HTTP plano en el puerto 80. Si cierras el puerto 80, todas las renovaciones por HTTP-01 fallan, por bueno que sea tu HTTPS.

Mira cómo falla HTTP-01 dos veces

En la lección 2 el nombre client pasó, porque la CA llegó al contenedor client. Ahora pide dos nombres que no son tuyos.

Nada en el laboratorio responde a bank. El nombre shop sí responde, pero el servidor web que hay allí no es tu cliente, así que no puede servir tu prueba.

Pide un nombre al que nadie responde

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

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

Pide un nombre que sirve otro

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

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

Lo que imprimen los dos fallos

NombreÚltima líneaLo que pasó
bankUnable to validate challenge: The server could not connect to validation targetNadie respondió en el puerto 80
shopUnable to validate challenge: The server will not issue certificates for the identifierRespondió Caddy, no tu cliente, así que la prueba era incorrecta

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

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.