Por qué fallan las firmas DKIM
Las firmas DKIM suelen fallar por uno de dos motivos: el mensaje se modificó después de firmarse, o el receptor no encontró una clave pública utilizable en el selector indicado en la firma. Los problemas temporales del DNS y los errores de firma causan el resto. Cada caso necesita una solución distinta. Un pie de página añadido después de la firma no se arregla volviendo a publicar su registro DNS, y un registro que falta no se arregla cambiando su pasarela de correo. Y si DKIM pasó pero DMARC no, no es en absoluto un fallo de DKIM. Es la alineación (alignment).
Qué significa «DKIM fail»
Cuando un receptor comprueba una firma, devuelve un fallo permanente (PERMFAIL) o uno temporal (TEMPFAIL), con un breve motivo entre paréntesis, como «body hash did not verify» o «no key for signature». Los receptores suelen registrar el resultado en la cabecera Authentication-Results como fail, neutral, policy, temperror o permerror. Una línea típica:
Authentication-Results: mx.receiver.example;
dkim=fail (body hash did not verify) header.d=example.com header.s=mail2026
header.d es el dominio firmante y header.s es el selector. Esos dos datos, junto con el texto del motivo, le indican a qué familia de problemas se enfrenta.
Un fallo de DKIM no hace, por sí solo, que el receptor rechace el mensaje. Una firma fallida no obliga al rechazo. Lo que ocurra después depende del filtrado del receptor y de su política DMARC. Sin embargo, para los remitentes masivos que envían a Gmail, un fallo de DKIM tiene un coste directo. Gmail enumera estas respuestas:
- 4.7.30: «Your email has been rate limited because DKIM authentication didn’t pass for this message. Gmail requires all email bulk senders to authenticate their email with DKIM.»
- 5.7.30: «This message was blocked because it didn’t pass DKIM authentication. Gmail requires bulk email senders to authenticate their email with DKIM.»
Las reglas más amplias de los proveedores están en Requisitos de Google, Yahoo y Microsoft para remitentes.
Motivos frecuentes de fallo de DKIM
1. El mensaje cambió después de firmarse («body hash did not verify»)
Si DKIM «funcionaba ayer», empiece por aquí.
«Body hash did not verify» significa que el cuerpo cambió después de firmarse. Google lo dice sin rodeos: si el texto junto a la entrada DKIM es «body hash did not verify», «el mensaje se modificó durante el tránsito». Los culpables típicos:
- Una pasarela de salida o una herramienta de avisos legales que añade un pie de página después de que su plataforma de correo firmara el mensaje. Google advierte precisamente de esto.
- Herramientas de reescritura de enlaces o de seguimiento que modifican el cuerpo después de la firma.
- Listas de correo que añaden pies de página (DKIM, listas de correo y servicios de reenvío).
Si ve este error en Microsoft 365, significa lo mismo: algo en el recorrido modificó el cuerpo después de la firma.
«Signature did not verify» con un hash del cuerpo que coincide puede significar que cambió una cabecera firmada. Una lista que añade [tag] al asunto es el caso clásico.
Los cambios de codificación también cuentan. Convertir contenido de 8 bits a 7 bits en tránsito rompe las firmas DKIM, así que los firmantes deberían codificar el mensaje antes de firmarlo, tal como se espera que se reciba.
La canonicalización importa. simple falla con casi cualquier cambio; relaxed tolera los espacios en blanco y las cabeceras reajustadas, pero no las modificaciones del contenido. Microsoft 365 usa relaxed por defecto tanto para la cabecera como para el cuerpo.
La solución: firme después del último sistema que modifica el mensaje, o impida que ese sistema toque el contenido firmado. El mismo consejo vale para las listas de correo: firme después de preparar el mensaje para su distribución. No cambie el DNS ni regenere las claves. Ninguna de las dos cosas ayuda con un cuerpo que se ha reescrito.
2. El receptor no encuentra o no puede leer la clave
El receptor consulta exactamente <s=>._domainkey.<d=>. Si esa consulta falla, el resultado depende del motivo:
- No key for signature (PERMFAIL). No hay nada publicado en ese nombre. Nunca se publicó, se publicó con un nombre de host incorrecto (Microsoft señala el dominio duplicado, como
selector1._domainkey.example.com.example.com), está en la zona DNS equivocada, el selector está mal escrito o la clave se eliminó demasiado pronto durante una rotación (Cómo rotar una clave DKIM). Si el remitente firma con un selector o un dominiod=que usted nunca publicó, también acaba aquí. El diagnóstico completo del caso «sin registro» está en Firma DKIM no encontrada. - Key unavailable (TEMPFAIL). El DNS no respondió. Es el único caso en que una respuesta SMTP temporal 4xx es adecuada. En Microsoft 365, los
dkim=temperrorintermitentes suelen estar relacionados con TTL muy bajos en los CNAME de DKIM; se recomienda un TTL de al menos 3600 segundos. - Key syntax error (PERMFAIL). El registro está mal formado. El caso clásico es una clave de 2048 bits cortada en 255 caracteres, o cadenas divididas guardadas en desorden (Claves DKIM de 1024 o de 2048 bits).
- Key revoked (PERMFAIL). El registro tiene un
p=vacío. Es una retirada deliberada, así que el correo que todavía se firma con esa clave falla. - Tipo de registro incorrecto. Un TXT donde el proveedor espera un CNAME, o un CNAME con proxy de Cloudflare en lugar de configurado como DNS only.
- Demasiado pronto. Una clave nueva puede tardar hasta 48 horas en empezar a funcionar.
Los formatos de registro y la trampa del dominio duplicado se explican en Selectores DKIM y registros DNS.
3. La propia firma está mal configurada
Son problemas de configuración del firmante, y son fallos permanentes:
- Falta una etiqueta obligatoria (
v,a,b,bh,d,h,s). - La cabecera From no está en
h=(«From field not signed»). - El dominio
i=no es el dominiod=ni un subdominio de él («domain mismatch»). - La firma ha caducado (
x=está en el pasado). Los verificadores pueden considerarla fallida, lo que afecta sobre todo al correo muy retrasado o reenviado de nuevo. - El algoritmo es
rsa-sha1, cuya evaluación falla de forma permanente, o la clave RSA tiene menos de 1024 bits.
También conviene revisar dos opciones relacionadas:
- La etiqueta de longitud del cuerpo
l=deja sin verificar el contenido que supera el límite. Esto se puede aprovechar de forma abusiva, y los evaluadores pueden ignorar las firmas que usan esa etiqueta. No usel=, porque los mensajes que la usan son vulnerables a abusos. - Un registro de clave con
t=y(prueba) no es un fallo, pero los receptores deben tratar el correo como si no estuviera firmado, así que no obtiene ningún beneficio de DKIM.
Si envía correo de marketing con baja con un solo clic, compruebe también que h= incluye las cabeceras de lista. El mensaje debe tener una firma DKIM válida que cubra al menos List-Unsubscribe y List-Unsubscribe-Post.
4. Falló después de salir de sus sistemas
El reenvío simple suele mantener intacto DKIM. Las listas de correo que etiquetan los asuntos, añaden pies de página o reescriben partes MIME suelen romperlo. Los mensajes reenviados pueden fallar DKIM aunque su configuración sea correcta. No puede solucionarlo por completo desde el lado del remitente. Consulte DKIM, listas de correo y servicios de reenvío.
Cuando DKIM pasó para el dominio equivocado
A veces el informe dice dkim=pass y DMARC sigue sin pasar. No es un fallo de DKIM. La firma se verificó, pero su dominio d= no está alineado con su dominio From. Una firma válida de d=vendor.example no es un pass de DKIM alineado para From: news@example.com. DMARC sigue pasando si hay otro pass de SPF o DKIM alineado. Microsoft enumera exactamente este síntoma en su guía de resolución de problemas de DKIM, y la respuesta 4.7.32 de Gmail dice que la cabecera From «isn’t aligned with either the authenticated SPF or DKIM organizational domain.»
Con la alineación relaxed, la solución es una firma cuyo d= comparta su dominio organizativo, como d=example.com o d=mail.example.com. No necesita el dominio From exacto. La alineación se explica en Alineación de identificadores para SPF y DKIM, y la versión de este problema con terceros, en El correo de terceros falla la alineación.
Hay además una particularidad de Gmail. Gmail solo comprueba las cinco primeras firmas que figuran en Authentication-Results. Si su firma alineada no está entre ellas, el mensaje falla DKIM, y eso «también podría hacer que el mensaje falle DMARC».
Cómo diagnosticar un fallo de DKIM, por orden
- Lea
Authentication-Resultsen una copia recibida. Anote el resultadodkim=, el texto del motivo,header.dyheader.s. - «Body hash did not verify» → busque pasarelas, herramientas de pies de página, reescritores de seguimiento o listas en el recorrido (motivo 1).
- «No key», permerror o un error de sintaxis de la clave → consulte el selector en el DNS y compárelo con el valor que le dio su proveedor (motivo 2).
- temperror → vuelva a intentarlo más tarde y después revise su proveedor de DNS y sus TTL (motivo 2).
dkim=passpero sin pass de DMARC → compareheader.dcon el dominio From (sección anterior).- Compruebe el alcance. Sus informes agregados de DMARC muestran el dominio DKIM, el selector y el resultado por fuente. Si una fuente falla y las demás pasan, el problema está en la configuración o el recorrido de ese remitente, no en «DKIM para todo el dominio» (Un informe agregado de DMARC explicado campo por campo).
Errores que conviene evitar
- Suponer que un fallo de DKIM significa que el registro DNS está mal. Un cuerpo modificado es una causa frecuente, y ningún cambio en el DNS lo arregla.
- Suponer que un fallo significa que un atacante manipuló el correo. Una pasarela o una lista legítimas también pueden cambiar el contenido firmado.
- Regenerar las claves para arreglar un fallo del hash del cuerpo. No cambia nada.
- Publicar la clave y no activar nunca la firma. Google tiene un paso Iniciar autenticación; Microsoft 365 tiene su propia opción de activación (Problemas de configuración con Microsoft 365 o Google Workspace).
- Usar
l=para que los pies de página no rompan la firma.
Cuenta DMARC gratuita
Convierta los informes DMARC en bruto en un panel legible
Dirija su dirección rua a nuestra plataforma y consulte los resultados por remitente y por fuente en lugar de abrir archivos XML.
- Resultados agrupados por fuente de envío
- Resultados de SPF, DKIM y alineación por remitente
- Los informes XML originales siguen disponibles para descargar
Preguntas frecuentes
¿Por qué falla mi DKIM?
Empiece por el texto del motivo en Authentication-Results. «Body hash did not verify» significa que algo cambió el cuerpo después de la firma. «No key» o un error de sintaxis significa que el registro falta, está mal ubicado o está truncado. temperror significa que el DNS no respondió.
¿Qué significa «body hash did not verify»?
El cuerpo cambió después de la firma, normalmente por un pie de página, una pasarela o una lista. Corrija el sistema que modifica el mensaje, no el DNS.
¿Por qué DKIM falla solo a veces?
Busque errores temporales del DNS, correo que sigue recorridos distintos (parte pasa por una pasarela o una lista) o una rotación que eliminó una clave demasiado pronto.
¿Puedo hacer que DKIM sobreviva a las listas de correo?
No de forma fiable desde el lado del remitente. Consulte DKIM, listas de correo y servicios de reenvío.