Passa al contenuto
  • Non sono presenti suggerimenti perché il campo di ricerca è vuoto.

Perché le firme DKIM falliscono

Le firme DKIM di solito falliscono per uno di due motivi: il messaggio è stato modificato dopo la firma, oppure il server ricevente non ha trovato una chiave pubblica utilizzabile sul selettore indicato nella firma. I problemi DNS temporanei e gli errori di firma spiegano il resto. Ognuno richiede una soluzione diversa. Un piè di pagina aggiunto dopo la firma non si risolve ripubblicando il record DNS, e un record mancante non si risolve modificando il gateway di posta. E se DKIM ha superato il controllo ma DMARC no, non si tratta affatto di un fallimento DKIM: è una questione di allineamento (alignment).

Che cosa significa «DKIM fail»

Quando un server ricevente verifica una firma, restituisce un fallimento permanente (PERMFAIL) o temporaneo (TEMPFAIL), con un breve motivo tra parentesi, come «body hash did not verify» o «no key for signature». I server riceventi di solito registrano l’esito nell’intestazione Authentication-Results come fail, neutral, policy, temperror o permerror. Una riga tipica:

Authentication-Results: mx.receiver.example;
  dkim=fail (body hash did not verify) header.d=example.com header.s=mail2026

header.d è il dominio di firma e header.s è il selettore. Questi due valori, insieme al testo del motivo, vi dicono con quale famiglia di problemi avete a che fare.

Un fallimento DKIM, da solo, non fa rifiutare il messaggio al server ricevente. Una firma non valida non obbliga al rifiuto. Che cosa succede dopo dipende dai filtri del server ricevente e dalla vostra politica DMARC. Per chi invia grandi volumi a Gmail, però, un fallimento DKIM ha un costo diretto. Gmail elenca queste risposte:

  • 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.»

Le regole più ampie dei provider sono in Requisiti per i mittenti di Google, Yahoo e Microsoft.

Motivi comuni di fallimento DKIM

1. Il messaggio è cambiato dopo la firma («body hash did not verify»)

Se DKIM «ieri funzionava», partite da qui.

«Body hash did not verify» significa che il corpo è cambiato dopo la firma. Google lo dice chiaramente: se accanto alla voce DKIM compare il testo «body hash did not verify», il messaggio è stato modificato durante il transito. I colpevoli tipici:

  • Un gateway in uscita o uno strumento per i disclaimer che aggiunge un piè di pagina dopo che la vostra piattaforma di posta ha firmato il messaggio. Google mette in guardia proprio da questo.
  • Strumenti di riscrittura dei link o di tracciamento che modificano il corpo dopo la firma.
  • Mailing list che aggiungono piè di pagina (DKIM, mailing list e servizi di inoltro).

Se vedete questo errore in Microsoft 365, significa la stessa cosa: qualcosa lungo il percorso ha modificato il corpo dopo la firma.

«Signature did not verify» con un hash del corpo corrispondente può significare che è cambiata un’intestazione firmata. Una lista che aggiunge [tag] al Subject è il caso classico.

Contano anche le modifiche di codifica. Convertire contenuti a 8 bit in 7 bit durante il transito rompe le firme DKIM, quindi i firmatari dovrebbero codificare il messaggio prima della firma, nel modo in cui ci si aspetta che venga ricevuto.

La canonicalizzazione conta. simple si rompe quasi a ogni modifica; relaxed tollera gli spazi bianchi e le intestazioni riformattate, ma non le modifiche al contenuto. Microsoft 365 usa per impostazione predefinita relaxed sia per le intestazioni sia per il corpo.

La soluzione: firmate dopo l’ultimo sistema che modifica il messaggio, oppure impedite a quel sistema di toccare il contenuto firmato. Lo stesso consiglio vale per le mailing list: firmare dopo che il messaggio è stato preparato per la distribuzione. Non modificate il DNS e non rigenerate le chiavi. Nessuna delle due cose aiuta un corpo che è stato riscritto.

2. Il server ricevente non trova o non riesce a leggere la chiave

Il server ricevente cerca esattamente <s=>._domainkey.<d=>. Se quella ricerca non va a buon fine, il risultato dipende dal motivo:

  • No key for signature (PERMFAIL). Su quel nome non è pubblicato nulla. Non è mai stato pubblicato, è finito sotto il nome host sbagliato (Microsoft segnala il dominio raddoppiato, come selector1._domainkey.example.com.example.com), si trova nella zona DNS sbagliata, il selettore è scritto male oppure la chiave è stata eliminata troppo presto durante una rotazione (Come ruotare una chiave DKIM). Si finisce qui anche se il mittente firma con un selettore o un dominio d= che non avete mai pubblicato. La diagnosi completa del record mancante è in Firma DKIM non trovata.
  • Key unavailable (TEMPFAIL). Il DNS non ha risposto. È l’unico caso in cui è appropriata una risposta SMTP temporanea 4xx. Per Microsoft 365, i dkim=temperror intermittenti sono spesso legati a TTL molto bassi sui CNAME DKIM; si consiglia un TTL di almeno 3600 secondi.
  • Key syntax error (PERMFAIL). Il record è malformato. Il caso classico è una chiave a 2048 bit tagliata a 255 caratteri, o stringhe divise salvate nell’ordine sbagliato (Chiavi DKIM a 1024 o 2048 bit).
  • Key revoked (PERMFAIL). Il record ha un p= vuoto. È un ritiro deliberato, quindi la posta ancora firmata con quella chiave non supera il controllo.
  • Tipo di record sbagliato. Un TXT dove il provider si aspetta un CNAME, oppure un CNAME in proxy su Cloudflare invece che impostato su DNS only.
  • Troppo presto. Una nuova chiave può richiedere fino a 48 ore per iniziare a funzionare.

I formati dei record e la trappola del dominio raddoppiato sono in Selettori DKIM e record DNS.

3. La firma stessa è configurata male

Sono problemi di configurazione del firmatario e sono fallimenti permanenti:

  • Manca un tag obbligatorio (v, a, b, bh, d, h, s).
  • L’intestazione From non è in h= («From field not signed»).
  • Il dominio i= non è il dominio d= né un suo sottodominio («domain mismatch»).
  • La firma è scaduta (x= è nel passato). I verificatori possono considerarla non valida, il che riguarda soprattutto la posta molto in ritardo o riproposta.
  • L’algoritmo è rsa-sha1, che fallisce sempre la valutazione, oppure la chiave RSA è più corta di 1024 bit.

Meritano un controllo anche due impostazioni correlate:

  • Il tag di lunghezza del corpo l= lascia non verificato il contenuto oltre il limite. Può essere sfruttato in modo abusivo, e chi valuta i messaggi potrebbe ignorare le firme che usano questo tag. Non usate l=, perché i messaggi che lo usano sono esposti ad abusi.
  • Un record di chiave con t=y (test) non è un fallimento, ma i server riceventi devono trattare la posta come posta non firmata, quindi non ottenete alcun vantaggio da DKIM.

Se inviate posta di marketing con disiscrizione in un clic, controllate che h= includa anche le intestazioni della lista. Il messaggio deve avere una firma DKIM valida che copra almeno List-Unsubscribe e List-Unsubscribe-Post.

4. Ha fallito dopo essere partito da voi

Il semplice inoltro di solito lascia intatto DKIM. Le mailing list che contrassegnano gli oggetti, aggiungono piè di pagina o riscrivono le parti MIME di solito lo rompono. I messaggi inoltrati possono non superare DKIM anche quando la vostra configurazione è corretta. Dal lato dell’invio non potete risolverlo del tutto. Consultate DKIM, mailing list e servizi di inoltro.

Quando DKIM supera il controllo per il dominio sbagliato

A volte il report indica dkim=pass e DMARC continua a non superare il controllo. Non è un fallimento DKIM. La firma è stata verificata, ma il suo dominio d= non è allineato con il vostro dominio From. Una firma valida di d=vendor.example non è un pass DKIM allineato per From: news@example.com. DMARC dà comunque esito pass se c’è un altro pass SPF o DKIM allineato. Microsoft elenca proprio questo sintomo nella sua guida alla risoluzione dei problemi DKIM, e la risposta 4.7.32 di Gmail dice che l’intestazione From «isn’t aligned with either the authenticated SPF or DKIM organizational domain.»

Con l’allineamento relaxed, la soluzione è una firma il cui d= condivida il vostro dominio organizzativo, come d=example.com o d=mail.example.com. Non serve il dominio From esatto. L’allineamento è spiegato in Allineamento degli identificatori per SPF e DKIM, e la versione di questo problema con i mittenti di terze parti in La posta di terze parti non supera l’allineamento.

C’è anche una particolarità di Gmail. Gmail verifica solo le prime cinque firme elencate in Authentication-Results. Se la vostra firma allineata non è tra queste, il messaggio non supera DKIM e, secondo Google, questo può far fallire anche DMARC.

Come diagnosticare un fallimento DKIM, in ordine

  1. Leggete Authentication-Results su una copia ricevuta. Annotate il risultato dkim=, il testo del motivo, header.d e header.s.
  2. «Body hash did not verify» → cercate gateway, strumenti per i piè di pagina, sistemi che riscrivono i link per il tracciamento o liste lungo il percorso (motivo 1).
  3. «No key», permerror o un errore di sintassi della chiave → cercate il selettore nel DNS e confrontatelo con il valore fornito dal vostro provider (motivo 2).
  4. temperror → riprovate più tardi, poi controllate il vostro provider DNS e i TTL (motivo 2).
  5. dkim=pass ma nessun pass DMARC → confrontate header.d con il dominio From (sezione precedente).
  6. Verificate la portata. I vostri report aggregati DMARC mostrano il dominio DKIM, il selettore e il risultato per ogni fonte. Se una fonte fallisce e le altre superano il controllo, il problema è nella configurazione o nel percorso di quel mittente, non in «DKIM per tutto il dominio» (Un report aggregato DMARC analizzato campo per campo).

Errori da evitare

  • Dare per scontato che un fallimento DKIM significhi un record DNS sbagliato. Un corpo modificato è una causa frequente, e nessuna modifica DNS la risolve.
  • Dare per scontato che un fallimento significhi che un malintenzionato ha manomesso la posta. Anche un gateway o una lista legittimi possono modificare il contenuto firmato.
  • Rigenerare le chiavi per risolvere un errore di body hash. Non cambia nulla.
  • Pubblicare la chiave senza mai attivare la firma. Google ha un passaggio Avvia autenticazione; Microsoft 365 ha una propria impostazione di attivazione (Problemi di configurazione di Microsoft 365 o Google Workspace).
  • Usare l= perché i piè di pagina non rompano la firma.

Account DMARC gratuito

Dai report DMARC grezzi a una dashboard leggibile

Indirizzate il vostro indirizzo rua alla nostra piattaforma e leggete i risultati per mittente e per fonte, senza aprire file XML.

  • Risultati raggruppati per fonte di invio
  • Risultati SPF, DKIM e di allineamento per mittente
  • I report XML originali restano disponibili per il download

Aprite un account DMARC gratuitoParlate con un esperto

Domande frequenti

Perché il mio DKIM non supera il controllo?

Partite dal testo del motivo in Authentication-Results. «Body hash did not verify» significa che qualcosa ha modificato il corpo dopo la firma. «No key» o un errore di sintassi significa che il record manca, è nel posto sbagliato o è troncato. temperror significa che il DNS non ha risposto.

Che cosa significa «body hash did not verify»?

Il corpo è cambiato dopo la firma, di solito a causa di un piè di pagina, di un gateway o di una lista. Correggete il sistema che modifica il messaggio, non il DNS.

Perché DKIM fallisce solo a volte?

Cercate errori DNS temporanei, posta che segue percorsi diversi (in parte attraverso un gateway o una lista) oppure una rotazione che ha rimosso una chiave troppo presto.

Posso far sopravvivere DKIM alle mailing list?

Non in modo affidabile dal lato dell’invio. Consultate DKIM, mailing list e servizi di inoltro.