Por qué una autoridad de certificación pide pruebas
Un certificado TLS afirma que una clave pública pertenece a un dominio. Antes de firmar esa afirmación, una autoridad necesita pruebas de que quien pide el certificado controla el dominio. Con ACME, el protocolo que usan Let's Encrypt y otras autoridades, la prueba es un desafío: la autoridad entrega a su cliente ACME un token aleatorio, el cliente lo publica en un lugar al que solo podría acceder el propietario del dominio, y la autoridad lo busca.
Los tres tipos de desafío se diferencian solo en el lugar donde va el token. Esa única diferencia decide qué certificados puede obtener, dónde tiene que ejecutarse su cliente y si importa lo que haya delante de su sitio.
HTTP-01, TLS-ALPN-01 y DNS-01 comparados
HTTP-01. El cliente sirve un archivo en http://<domain>/.well-known/acme-challenge/<token> y la autoridad lo obtiene por el puerto 80. Es el valor por defecto en la mayoría de los clientes y el más fácil para empezar. El dominio debe apuntar ya a un servidor que pueda servir el archivo, el puerto 80 debe estar abierto y no puede emitir certificados wildcard.
TLS-ALPN-01. El cliente responde a una conexión TLS en el puerto 443 con un certificado especial para el protocolo acme-tls/1. Encaja en configuraciones que mantienen cerrado el puerto 80, requiere controlar el propio listener TLS y tampoco puede emitir wildcards.
DNS-01. El cliente publica un registro TXT en _acme-challenge.<domain> con un valor derivado del token, y la autoridad lo consulta en el DNS. No interviene nada del servidor web. Valida wildcards, funciona para hosts a los que internet no llega y funciona sea lo que sea lo que haya delante del sitio. A cambio, el cliente necesita una forma de escribir registros DNS: una API, o sus manos.
Cómo funciona DNS-01, paso a paso
1. Pedido. Su cliente ACME solicita un certificado que cubra, por ejemplo, example.com y *.example.com.
2. Token. Para cada nombre, la autoridad devuelve un desafío DNS-01, y el cliente calcula el valor que hay que publicar a partir del token y de la clave de su cuenta.
3. Registro TXT. El valor va en un registro TXT llamado _acme-challenge.example.com. El wildcard usa el mismo nombre que el dominio base, así que un certificado para ambos necesita dos valores TXT bajo un mismo nombre. Es normal: añada ambos.
4. Propagación. El registro tiene que llegar a todos los servidores de nombres autoritativos de la zona, porque la autoridad puede consultar a cualquiera de ellos, desde varios lugares.
5. Validación y emisión. El cliente pide a la autoridad que compruebe; la autoridad encuentra los valores, marca los nombres como validados y el cliente descarga el certificado. Después se pueden eliminar los registros TXT.
Puede ver lo que verá la autoridad antes de pedirle que mire.
Compruebe el registro TXT antes de la validación
# lo que ve su resolvedor
dig +short TXT _acme-challenge.example.com
# consulte directamente a cada servidor de nombres autoritativo
for ns in $(dig +short NS example.com); do
echo "$ns: $(dig +short TXT _acme-challenge.example.com @$ns)"
done
Los certificados wildcard necesitan DNS-01
Un certificado wildcard cubre todos los nombres de primer nivel bajo un dominio: *.example.com coincide con www.example.com, api.example.com y cualquier subdominio que añada el año que viene, pero no con example.com mismo ni con a.b.example.com. Por eso los pedidos wildcard suelen solicitar example.com y *.example.com juntos.
Let's Encrypt valida los nombres wildcard solo con DNS-01, y el motivo es sencillo: un archivo en un servidor web demuestra el control de un nombre de host, mientras que un wildcard habla en nombre de todos los hosts de la zona, así que la prueba tiene que venir de la propia zona.
Antes de una migración, detrás de un CDN, en hosts privados
Como DNS-01 nunca toca el servidor web, no le importa adónde va el tráfico.
Antes de una migración. Emita el certificado para la nueva plataforma mientras el dominio sigue apuntando a la antigua. Cuando cambie el DNS, el certificado ya está en su sitio y HTTPS funciona desde la primera solicitud.
Detrás de un CDN o de un proxy. La validación no depende de qué servidor responde en el puerto 80, así que el mismo cliente funciona tanto si el sitio se sirve directamente como si se sirve a través de un CDN.
Hosts privados e internos. Un servidor de staging, una aplicación de intranet o un servidor de correo al que internet no llega pueden obtener igualmente un certificado de confianza pública, siempre que su nombre esté en una zona DNS pública en la que usted pueda escribir.
Muchos servidores, un nombre. Detrás de un balanceador de carga, HTTP-01 tiene que encontrar el token en el servidor que responda. DNS-01 se valida una vez, y usted distribuye el certificado.
certbot, acme.sh y cert-manager
certbot admite DNS-01 de dos maneras. Un plugin de DNS escribe y elimina los registros TXT a través de la API de su proveedor de DNS, lo que además hace posible la renovación desatendida; hay plugins para la mayoría de los grandes proveedores de DNS y para las actualizaciones dinámicas RFC 2136 hacia sus propios servidores de nombres. El modo manual muestra el registro y espera a que usted lo añada: sirve para un certificado puntual, pero cada renovación necesita a una persona.
acme.sh admite DNS-01 con bastante más de un centenar de API de proveedores, y en Kubernetes cert-manager hace lo mismo a través del solver dns01 de un Issuer. Use el que use, deje las credenciales de la API legibles solo para root y dé al token el permiso más estrecho que ofrezca su proveedor, idealmente editar el DNS de una sola zona. La guía de certbot cubre la instalación, la renovación y la parte de HTTP-01.
certbot: un certificado wildcard con DNS-01
# con un plugin de DNS (aquí: actualizaciones dinámicas RFC 2136 a su propio servidor de nombres)
sudo certbot certonly \
--dns-rfc2136 --dns-rfc2136-credentials /etc/letsencrypt/rfc2136.ini \
-d example.com -d '*.example.com'
# manual: certbot muestra los valores TXT y espera
sudo certbot certonly --manual --preferred-challenges dns \
-d example.com -d '*.example.com'
# prueba de renovación (funciona con un plugin; el modo manual vuelve a necesitarle)
sudo certbot renew --dry-run
En cdn.com.tr: el certificado del edge, listo antes de cambiar el DNS
Cuando traslada un dominio en producción a cdn.com.tr, el panel emite el certificado del edge con DNS-01 mientras el dominio sigue apuntando a su proveedor actual. En la pestaña Dominios de Dominios y reglas, pulse Establecer certificado y elija Obtener un certificado antes de cambiar el DNS. El asistente indica el dominio raíz y su wildcard, muestra el registro TXT que debe añadir en su proveedor de DNS actual, comprueba el registro por usted y emite un certificado wildcard de Let's Encrypt que se instala automáticamente en los servidores del CDN.
Cambie el DNS cuando quiera: el dominio se sirve por HTTPS desde el primer segundo, sin ningún intervalo mientras se emite un certificado. El panel muestra la fecha de caducidad del certificado, y volver a ejecutar el asistente lleva los mismos pocos minutos. La guía de validación DNS recorre cada pantalla.
Cuándo DNS-01 es el desafío adecuado
El certificado de la nueva plataforma existe antes de que llegue el primer visitante.
Un solo certificado wildcard para todos los nombres de primer nivel, incluidos los que añada más adelante.
Certificados de confianza pública para servidores de staging, intranet y correo a los que internet no llega.
Cómo configurarlo
Guías paso a paso en el centro de ayuda:
Preguntas frecuentes sobre DNS-01
¿Cuál es la diferencia entre HTTP-01 y DNS-01?
HTTP-01 demuestra el control con un archivo servido en el puerto 80 del dominio; DNS-01 lo demuestra con un registro TXT en el DNS del dominio. HTTP-01 necesita que el dominio apunte al servidor que pide el certificado; DNS-01 funciona vaya donde vaya el dominio y es el desafío que emite los certificados wildcard.
¿Por qué hay dos registros TXT con el mismo nombre?
Un certificado para example.com y *.example.com necesita una validación por nombre, y ambas usan _acme-challenge.example.com. Añada ambos valores como registros TXT separados y consérvelos hasta que termine la validación.
¿Cuánto tarda la propagación?
Normalmente unos minutos, según su proveedor de DNS y el TTL del registro. Consulte con dig a cada servidor de nombres autoritativo antes de iniciar la validación; si alguno sigue respondiendo sin el nuevo valor, espere.
¿Funciona DNS-01 detrás de un CDN?
Sí. El desafío lo responde su DNS, no el servidor que responde al tráfico web, así que funciona igual con o sin un CDN delante del sitio.
¿Se renueva automáticamente un certificado DNS-01?
Con un cliente que escribe en su DNS a través de una API, como un plugin de DNS de certbot, acme.sh o cert-manager, sí. En modo manual alguien añade el registro TXT en cada renovación, así que prográmelo o pase a una API.
¿Es seguro dar a un cliente ACME acceso a mi DNS?
Límitelo. Cree un token que pueda editar solo la zona en cuestión, o apunte _acme-challenge con un CNAME a una zona aparte usada solo para la validación, de modo que el cliente no pueda cambiar nada más. Deje las credenciales legibles solo para root.