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
| Palabra | Qué significa |
|---|---|
| Huella (thumbprint) | un hash corto que representa la clave de la cuenta |
| Autorización de clave | el valor de la CA, un punto y la huella |
| HTTP-01 | una prueba servida en el puerto 80 en una ruta fija |
| DNS-01 | una prueba publicada en un registro TXT |
| Registro TXT | un registro DNS que guarda texto plano |
| Comodín | un 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
docker exec python python3 steps/challenges.pySe muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.
Lo que imprime el modelo
| Línea | Lo que significa |
|---|---|
| key authorisation: e8Kq2LvX0n4RcT7wYb1mPz9hJd3s.jW5aL0b7Qm3x... | El valor de la CA, un punto, la huella |
| http://shop.example/.well-known/acme-challenge/e8Kq2LvX0n4RcT7wYb1mPz9hJd3s | Dónde se descarga HTTP-01 |
| _acme-challenge.shop.example TXT vmbbIVBfAfWejbz8l4MJmQwQ6JlM5mjoPCqB4qPA2Hw | El registro de DNS-01 |
| 43 characters | Un hash SHA-256 en base64url, sin relleno |
| *.shop.example dns-01 only | Un 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ón | Desafío | Por qué |
|---|---|---|
| shop.example en un servidor web público | HTTP-01 | El puerto 80 ya está abierto |
| *.shop.example | DNS-01 | Un comodín solo se puede probar en el DNS |
| Un servidor del personal al que no se llega desde fuera | DNS-01 | La CA nunca se conecta a él |
| Puerto 80 bloqueado, puerto 443 abierto | TLS-ALPN-01 | Un 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
docker exec client step ca certificate bank bank.crt bank.key --provisioner acme --standaloneSe muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.
Pide un nombre que sirve otro
docker exec client step ca certificate shop mine.crt mine.key --provisioner acme --standaloneSe 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ínea | Lo que pasó |
|---|---|---|
| bank | Unable to validate challenge: The server could not connect to validation target | Nadie respondió en el puerto 80 |
| shop | Unable to validate challenge: The server will not issue certificates for the identifier | Respondió Caddy, no tu cliente, así que la prueba era incorrecta |
Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.