Formatet för TXT-posten default._bimi

För att slutföra en BIMI-implementation (Brand Indicators for Message Identification) publicerar du en DNS TXT-post. Denna post anger för mottagande e-postservrar var de kan hämta din SVG-logotyp och ditt Mark Certificate.

Denna artikel dokumenterar den obligatoriska syntaxen, taggarna och formateringsreglerna för BIMI TXT-posten [1].

Värdnamnet (Selector)

Publicera BIMI-posten som en TXT-post i din domäns DNS-zon. Värdnamnet (selektorn) måste använda följande format:

[selector]._bimi.[domän]

Standardselektorn är default. För domänen example.com publicerar du TXT-posten på följande värdnamn:

default._bimi.example.com

Observera: Protokollet stöder anpassade selektorer för underdomäner eller affärsenheter, men de flesta implementationer använder selektorn default. E-postklienter frågar default._bimi när ingen annan selektor anges i meddelandehuvudena.

Syntaxen för postvärdet

TXT-postens värde är en semikolonseparerad lista med taggar, med samma struktur som en DMARC-post.

1. Versionstaggen (v=)

Denna tagg är obligatorisk och måste placeras först. Den identifierar protokollversionen. Syntax: v=BIMI1;

2. Platstaggen (l=)

Denna tagg är obligatorisk. Den anger HTTPS-URL:en där e-postklienten hämtar din W3C SVG Tiny P/S-logotypfil. Syntax: l=https://example.com/logo.svg; Begränsning: URL:en måste använda HTTPS. HTTP-URL:er klarar inte valideringen.

3. Auktoritetstaggen (a=)

Denna tagg är valfri i basspecifikationen men krävs i praktiken för logotypvisning i Gmail och Apple Mail. Den anger HTTPS-URL:en där e-postklienten hämtar ditt Verified Mark Certificate (VMC) eller Common Mark Certificate (CMC) i .pem-format. Syntax: a=https://example.com/certificate.pem; Självdeklarerad reservlösning: För självdeklarerade implementationer (stöds endast av Yahoo och AOL), inkludera taggen med ett tomt värde: a=;

Kompletta postexempel

Exempel A: Certifierad implementation (Gmail och Apple Mail)

Använd detta format för att visa din logotyp i Gmail och Apple Mail och för att få Gmail:s blåa bockmarkering.

Type:  TXT

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

Exempel B: Självdeklarerad implementation (endast Yahoo)

Använd detta format för testning eller när du riktar dig mot Yahoo Mail innan du skaffar ett VMC.

Type:  TXT

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

Vanliga syntaxfel

Följande fel orsakar valideringsmisslyckanden:

1. Saknade semikolon. Separera varje tagg med ett semikolon.
2. HTTP-URL:er. Både l=- och a=-taggarna måste referera till https://-slutpunkter.
3. Ogiltiga SVG-filer. Taggen l= måste referera till en W3C SVG Tiny P/S-fil. Standard-SVG, PNG eller JPG-filer gör att e-postklienten hoppar över logotypvisning utan felmeddelande.
4. Utelämnad a=-tagg. För självdeklarerade poster, inkludera a=-taggen med ett tomt värde (a=;). Vissa parsers avvisar poster som helt utelämnar taggen.

Automatiserad postgenerering

Manuell postkonstruktion introducerar syntaxfel. För att generera SVG-filen och DNS TXT-strängen från dina domänparametrar, använd makeBIMI, som erbjuder ett gränssnitt med ett-klicks-kopiering.

Efter att du genererat posten, publicera den i din DNS-zon. Om du behöver ett VMC för att fylla i a=-taggen för Gmail-kompatibilitet, använd en certifikatförmedlare som veriBIMI för att hantera certifikatanskaffningen.

Referenser

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