O Formato do Registro TXT default._bimi

Para concluir uma implantação de Brand Indicators for Message Identification (BIMI), você publica um registro TXT no DNS. Este registro informa aos servidores de e-mail receptores onde recuperar seu logotipo SVG e seu Certificado de Marca.

Este artigo documenta a sintaxe obrigatória, as tags e as regras de formatação para o registro TXT do BIMI [1].

O Hostname (Seletor)

Publique o registro BIMI como um registro TXT na zona DNS do seu domínio. O hostname (o seletor) deve usar o seguinte formato:

[seletor]._bimi.[domínio]

O seletor padrão é default. Para o domínio example.com, publique o registro TXT no seguinte hostname:

default._bimi.example.com

Observação: O protocolo suporta seletores personalizados para subdomínios ou unidades de negócio, mas a maioria das implantações usa o seletor default. Os clientes de e-mail consultam default._bimi quando nenhum outro seletor é especificado nos cabeçalhos da mensagem.

A Sintaxe do Valor do Registro

O valor do registro TXT é uma lista de tags separadas por ponto e vírgula, usando a mesma estrutura de um registro DMARC.

1. A Tag de Versão (v=)

Esta tag é obrigatória e deve aparecer primeiro. Ela identifica a versão do protocolo. Sintaxe: v=BIMI1;

2. A Tag de Localização (l=)

Esta tag é obrigatória. Ela especifica a URL HTTPS onde o cliente de e-mail recupera seu arquivo de logotipo W3C SVG Tiny P/S. Sintaxe: l=https://example.com/logo.svg; Restrição: A URL deve usar HTTPS. URLs HTTP falham na validação.

3. A Tag de Autoridade (a=)

Esta tag é opcional na especificação base, mas obrigatória na prática para exibição de logotipo no Gmail e Apple Mail. Ela especifica a URL HTTPS onde o cliente de e-mail recupera seu Verified Mark Certificate (VMC) ou Common Mark Certificate (CMC) no formato .pem. Sintaxe: a=https://example.com/certificate.pem; Fallback auto-declarado: Para implantações auto-declaradas (suportadas apenas por Yahoo e AOL), inclua a tag com um valor vazio: a=;

Exemplos Completos de Registro

Exemplo A: Implantação certificada (Gmail e Apple Mail)

Use este formato para exibir seu logotipo no Gmail e Apple Mail e receber a marca de verificação azul do Gmail.

Type:  TXT

Host:  default._bimi
Value: v=BIMI1; l=https://example.com/logo.svg; a=https://example.com/cert.pem;

Exemplo B: Implantação auto-declarada (apenas Yahoo)

Use este formato para testes ou quando estiver direcionando o Yahoo Mail antes de obter um VMC.

Type:  TXT

Host:  default._bimi
Value: v=BIMI1; l=https://example.com/logo.svg; a=;

Erros Comuns de Sintaxe

Os seguintes erros causam falhas de validação:

1. Ponto e vírgula ausente. Separe todas as tags com ponto e vírgula.
2. URLs HTTP. Tanto a tag l= quanto a tag a= devem referenciar endpoints https://.
3. Arquivos SVG inválidos. A tag l= deve referenciar um arquivo W3C SVG Tiny P/S. Arquivos SVG padrão, PNG ou JPG fazem com que o cliente de e-mail ignore a exibição do logotipo sem apresentar erro.
4. Tag a= omitida. Para registros auto-declarados, inclua a tag a= com um valor vazio (a=;). Alguns parsers rejeitam registros que omitem completamente a tag.

Geração Automatizada de Registro

A construção manual de registros introduz erros de sintaxe. Para gerar o arquivo SVG e a string TXT do DNS a partir dos parâmetros do seu domínio, use o makeBIMI, que oferece uma interface de cópia com um clique.

Após gerar o registro, implante-o na sua zona DNS. Se você precisar de um VMC para preencher a tag a= para compatibilidade com o Gmail, use uma corretora de certificados como a veriBIMI para gerenciar o provisionamento do certificado.

Referências

[1] M. Blank, et al. "Brand Indicators for Message Identification (BIMI)." IETF Datatracker, RFC 9091, https://datatracker.ietf.org/doc/html/rfc9091