Risoluzione problemi BIMI: Perché il tuo logo non viene visualizzato (Guida completa)

Brand Indicators for Message Identification (BIMI) consente ai provider di posta elettronica di visualizzare il tuo logo accanto alle email autenticate. Quando il logo non appare, la causa è quasi sempre riconducibile a uno di sette problemi ben definiti. Questa guida analizza ciascuno di essi in ordine di frequenza, fornisce i passaggi diagnostici esatti e spiega come risolverli.

Prima di iniziare: Come funziona la visualizzazione del logo BIMI

Quando un server di posta ricevente elabora un messaggio in arrivo:

1. Verifica che il dominio mittente superi DMARC con una policy di enforcement.
2. Cerca il record DNS TXT BIMI su default._bimi..
3. Recupera il logo SVG dall'URL nel tag l=.
4. (Per i provider che lo richiedono) Valida il Verified Mark Certificate (VMC) o il Common Mark Certificate (CMC) dall'URL nel tag a=.
5. Renderizza il logo nell'interfaccia della casella di posta.

Un errore in qualsiasi passaggio sopprime silenziosamente il logo. Nessun errore viene mostrato al mittente o al destinatario.

Causa 1: La policy DMARC non è impostata su p=quarantine o p=reject

Questa è la singola causa più comune per cui i loghi BIMI non vengono visualizzati.

Ogni provider di posta che supporta BIMI — inclusi Google, Yahoo, Apple, Fastmail e altri — richiede una policy DMARC di p=quarantine o p=reject prima di renderizzare un logo. Una policy di p=none viene trattata come assenza di enforcement e BIMI viene completamente ignorato.

Come diagnosticare

Esegui una query DNS sul tuo record DMARC:

dig TXT _dmarc.tuodominio.com

Verifica il valore p= nella risposta. Controlla anche:

• sp= — la policy per i sottodomini. Se le tue email vengono inviate da un sottodominio, sp=none bloccherà BIMI su quel sottodominio anche se il dominio principale è impostato su p=reject.
• pct= — il tag percentuale. Alcuni provider richiedono pct=100. Un valore inferiore a 100 può causare una visualizzazione inconsistente del logo.

Come risolvere

1. Verifica che la tua autenticazione email (SPF e DKIM) passi costantemente prima di aumentare la policy.
2. Passa DMARC da p=none a p=quarantine, monitora per due-quattro settimane.
3. Passa a p=reject quando sei sicuro che nessuna email legittima stia fallendo.
4. Imposta pct=100 esplicitamente.
5. Se invii da sottodomini, aggiungi sp=quarantine o sp=reject.

Esempio di record DMARC corretto:

v=DMARC1; p=reject; sp=reject; pct=100; rua=mailto:[email protected];

Nota: Aumentare la policy DMARC influisce sulla consegna delle email. Non saltare la fase di monitoraggio.

Causa 2: Il file SVG non è accessibile tramite HTTPS

I server del provider di posta recuperano il tuo logo al momento della renderizzazione. Se il file restituisce qualcosa di diverso da una risposta 200 OK valida tramite HTTPS, il logo viene soppresso.

Cause secondarie comuni

| Sintomo | Causa probabile | |---|---| | 404 Not Found | URL errato nel tag l=, file spostato o eliminato | | 403 Forbidden | CDN o WAF che blocca user agent non browser | | 301/302 Redirect | Alcuni provider non seguono i redirect | | Errore certificato SSL | Certificato TLS scaduto o auto-firmato sul dominio di hosting | | URL HTTP | HTTP semplice non è accettato; HTTPS è obbligatorio |

Come diagnosticare

1. Copia l'URL esatto dal tuo tag l=.
2. Testalo con curl per simulare una richiesta non browser:

curl -I "https://tuodominio.com/bimi/logo.svg"

1. Controlla il codice di stato HTTP, l'header Content-Type e se si verifica qualche redirect.
2. Testa da più posizioni geografiche o usa un verificatore di header HTTP online per escludere il blocco geografico.

Come risolvere

1. Verifica che l'URL nel tuo record DNS BIMI corrisponda esattamente al percorso del file ospitato — inclusa la distinzione tra maiuscole e minuscole.
2. Se usi una CDN, inserisci nella whitelist gli user agent utilizzati dai principali provider di posta, oppure configura la CDN per servire il file pubblicamente senza protezione bot.
3. Assicurati che il dominio di hosting abbia un certificato TLS valido e affidabile (non auto-firmato).
4. Se un redirect è inevitabile, aggiorna il tag l= per puntare direttamente all'URL finale.
5. Verifica che il file sia accessibile dall'esterno della tua rete.

Causa 3: Il server restituisce il tipo MIME errato

Anche se il file SVG è accessibile, il provider di posta valida l'header Content-Type restituito dal tuo server. Il tipo MIME corretto è image/svg+xml. Qualsiasi altro valore — inclusi text/plain, application/octet-stream o text/html — causerà il rifiuto del logo.

Come diagnosticare

curl -I "https://tuodominio.com/bimi/logo.svg"

Cerca la riga Content-Type negli header della risposta:

Content-Type: image/svg+xml

Se vedi qualcos'altro, il tipo MIME è configurato in modo errato.

Come risolvere

La soluzione dipende dal tuo server web o piattaforma di hosting.

Apache — aggiungi a .htaccess o alla configurazione del server:

AddType image/svg+xml .svg .svgz

Nginx — aggiungi a mime.types o al blocco server:

types {

image/svg+xml svg svgz;
}

Amazon S3 / CloudFront — imposta i metadati Content-Type dell'oggetto su image/svg+xml durante il caricamento. S3 non deduce automaticamente i tipi MIME.

Cloudflare Pages / Netlify — aggiungi un file _headers:

/bimi/logo.svg

Content-Type: image/svg+xml

Dopo aver apportato le modifiche, esegui nuovamente il controllo curl -I per confermare che l'header sia corretto.

Causa 4: Il file SVG non supera la validazione W3C Tiny P/S

BIMI non accetta file SVG standard. La specifica richiede SVG Tiny 1.2 Portable/Secure (SVG Tiny P/S), un profilo ristretto progettato per essere sicuro per la renderizzazione in contesti non affidabili. La maggior parte dei file SVG esportati da strumenti di design come Adobe Illustrator, Figma o Inkscape non sono conformi a questo profilo senza modifiche.

Errori di validazione comuni

| Problema | Perché fallisce | |---|---| | baseProfile mancante o errato | Deve essere baseProfile="tiny" nell'elemento | | Attributo version="1.2" mancante | Richiesto dalla specifica | | Immagini raster incorporate () | Non permesse in Tiny P/S | | JavaScript o gestori di eventi | Rigorosamente proibiti | | Riferimenti esterni o con href esterno | Non permessi | | CSS @import o fogli di stile esterni | Non permessi | | Filtri, maschere o gradienti (in alcune implementazioni) | Supporto limitato | | File non racchiuso in come elemento radice | Requisito strutturale |

Come diagnosticare

1. Apri il tuo SVG in un editor di testo e ispeziona il tag di apertura. Deve includere:

```xml