Il Record DNS BIMI: I Tag l= e a= Spiegati
Una guida tecnica completa sulla sintassi del record TXT BIMI, che copre il tag l= per il logo e il tag a= per il certificato, le configurazioni supportate e gli errori di configurazione più comuni.
Il Record DNS BIMI Completo
Un record DNS BIMI (Brand Indicators for Message Identification) è un singolo record TXT che indica ai client di posta elettronica partecipanti dove trovare il logo del tuo brand e — quando richiesto — il certificato che dimostra che ne sei il proprietario. La sintassi deve essere esattamente corretta: un singolo tag malformato causa un fallimento silenzioso senza bounce, senza log di errore e senza logo.
Questo articolo copre ogni componente del record TXT BIMI, le regole che governano ciascun tag, le tre configurazioni canoniche del record e gli errori di configurazione che compromettono silenziosamente la visualizzazione del logo.
Prerequisiti
Prima di pubblicare un record BIMI, verifica che siano presenti i seguenti elementi:
- La policy DMARC è impostata su
p=quarantineop=rejectcon almenopct=100(o enforcement equivalente). - Il tuo file logo è in formato SVG Tiny P/S e ospitato su un URL HTTPS pubblicamente accessibile.
- Se il tuo obiettivo è Gmail o Apple Mail, disponi di un VMC valido (Verified Mark Certificate) o CMC (Common Mark Certificate) in formato PEM, anch'esso ospitato su un URL HTTPS pubblicamente accessibile.
Struttura del Record BIMI
Un record TXT BIMI segue questa sintassi generale:
v=BIMI1; l=<logo-url>; a=<certificate-url>
| Tag | Nome | Obbligatorio | Descrizione |
|-----|------|--------------|-------------|
| v= | Versione | Sì | Sempre BIMI1. |
| l= | URL del Logo | Sì | URL HTTPS che punta al tuo file logo SVG Tiny P/S. |
| a= | Prova di Autorità | Condizionale | URL HTTPS che punta al tuo VMC o CMC in formato PEM. Richiesto per Gmail e Apple Mail. |
Il record viene pubblicato come record TXT DNS nel seguente sottodominio:
default._bimi.<tuodominio.com>
Nota: Il selettore default è il selettore standard utilizzato da tutti i principali client di posta. I selettori personalizzati sono supportati dalla specifica ma non sono ancora ampiamente implementati dai destinatari.
Il Tag l=: URL del Logo
Cosa Fa
Il tag l= fornisce l'URL da cui i client di posta riceventi recuperano il logo del tuo brand. Quando un messaggio supera l'allineamento DMARC, il client recupera questo file e lo visualizza accanto al nome del mittente.
Requisiti
- Protocollo: Deve essere
https://. Gli URL HTTP vengono rifiutati. - Accessibilità: L'URL deve essere pubblicamente accessibile — nessuna autenticazione, nessun redirect, nessun geo-blocking. I server di posta recuperano questo URL dalla propria infrastruttura, non da un browser.
- Formato file: Il file deve essere conforme a SVG Tiny P/S (Portable/Secure), un sottoinsieme ristretto di SVG 1.2 Tiny. I file SVG standard non supereranno la validazione anche se vengono visualizzati correttamente in un browser.
- Header Content-Type: Il server deve restituire
image/svg+xml. - Dimensione file: Mantieni il file sotto i 32 KB. Alcuni destinatari applicano limiti più stringenti.
Restrizioni Chiave di SVG Tiny P/S
SVG Tiny P/S proibisce i seguenti elementi e attributi comunemente presenti nei file SVG standard:
- Riferimenti esterni (
,xlink:hrefche punta all'esterno del file) - Script (
) - Animazioni (
,) - Immagini raster incorporate
- Font arbitrari (solo font di sistema, oppure testo convertito in tracciati)
Importante: Un file che è SVG valido ma non SVG Tiny P/S valido causerà il fallimento silenzioso della visualizzazione del logo sulla maggior parte dei client. Valida sempre con un checker SVG BIMI dedicato prima della pubblicazione.
Impostare l= come Vuoto
La specifica permette l= con un valore vuoto (l=;) per disattivare esplicitamente la visualizzazione BIMI per un dominio pur continuando a pubblicare un record. Questo è un caso limite utilizzato in scenari di soppressione dei sottodomini.
Il Tag a=: Prova di Autorità (URL del Certificato)
Cosa Fa
Il tag a= punta a un Mark Verifying Certificate (VMC) o Common Mark Certificate (CMC) in formato PEM. Questo certificato lega crittograficamente il tuo logo al tuo dominio ed è emesso da un'Autorità di Certificazione (CA) accreditata. I client di posta riceventi recuperano questo certificato, validano la catena e confermano che il logo incorporato corrisponda all'URL l= prima di visualizzare il marchio.
Requisiti
- Protocollo: Deve essere
https://. Gli URL HTTP vengono rifiutati. - Accessibilità: Pubblicamente accessibile senza autenticazione o redirect.
- Formato: Catena di certificati codificata in PEM (
.pem). Il file deve includere la catena completa dal certificato end-entity alla root attendibile. - Catena di fiducia: Il certificato deve concatenarsi a una root CA attendibile riconosciuta dal provider di posta ricevente. I certificati auto-firmati non sono accettati.
- Corrispondenza hash del logo: Il file SVG all'URL
l=deve corrispondere all'hash del logo incorporato nel certificato. Aggiornare il logo senza riemettere il certificato interrompe la visualizzazione. - Validità: Il certificato non deve essere scaduto o revocato.
VMC vs CMC
| Tipo di Certificato | Nome Completo | Marchio Richiesto | Emesso Da | |---|---|---|---| | VMC | Verified Mark Certificate | Sì — marchio registrato | DigiCert, Entrust | | CMC | Common Mark Certificate | No — accettato marchio di common law | DigiCert, Entrust |
I CMC abbassano la barriera d'ingresso eliminando il requisito della registrazione del marchio, rendendo BIMI con verifica del certificato accessibile a una gamma più ampia di organizzazioni.
Record Auto-Dichiarati vs Certificati
Record Auto-Dichiarato (solo l=, senza a=)
Un record auto-dichiarato contiene solo il tag l=. Nessun certificato viene referenziato.
default._bimi.example.com. IN TXT "v=BIMI1; l=https:class="hl-cmt">//bimi.example.com/logo.svg;"
Dove funziona:
- Yahoo Mail / AOL Mail: Visualizza il logo senza certificato, a condizione che DMARC sia applicato.
- Fastmail: Supporta i record auto-dichiarati.
Dove non funziona:
- Gmail: Richiede un VMC o CMC valido. I record auto-dichiarati vengono ignorati.
- Apple Mail: Richiede un VMC o CMC valido. I record auto-dichiarati vengono ignorati.
- Microsoft Outlook (365): Utilizza un proprio sistema adiacente a BIMI (BIMI non è attualmente supportato nativamente).
Riepilogo: Un record auto-dichiarato è un punto di partenza valido e offre valore su Yahoo Mail, ma non sbloccherà la visualizzazione del logo su Gmail o Apple Mail.
Record VMC (Verified Mark Certificate)
Usa questa configurazione quando possiedi un marchio registrato e hai ottenuto un VMC da una CA accreditata.
default._bimi.example.com. IN TXT "v=BIMI1; l=https:class="hl-cmt">//bimi.example.com/logo.svg; a=https://bimi.example.com/vmc.pem;"
Supportato da: Gmail, Yahoo Mail, Apple Mail, Fastmail e tutti gli altri client partecipanti a BIMI.
Record CMC (Common Mark Certificate)
Usa questa configurazione quando hai ottenuto un CMC. La sintassi del record DNS è identica a quella di un record VMC — la distinzione è nel certificato stesso, non nel record DNS.
default._bimi.example.com. IN TXT "v=BIMI1; l=https:class="hl-cmt">//bimi.example.com/logo.svg; a=https://bimi.example.com/cmc.pem;"
Supportato da: Gmail (dal rollout del supporto CMC), Yahoo Mail, Apple Mail, Fastmail.
Nota: Conferma sempre lo stato attuale del supporto CMC con i tuoi client di posta target, poiché le tempistiche di rollout variano a seconda del provider.
Errori di Configurazione Comuni
1. URL a= Non Funzionante Causa Fallimento Silenzioso
Questo è l'errore più dannoso e