Het default._bimi TXT-recordformaat

Om een Brand Indicators for Message Identification (BIMI)-implementatie te voltooien, publiceert u een DNS TXT-record. Dit record vertelt ontvangende mailservers waar ze uw SVG-logo en uw Mark Certificate kunnen ophalen.

Dit artikel documenteert de vereiste syntax, tags en opmaakregels voor het BIMI TXT-record [1].

De hostnaam (selector)

Publiceer het BIMI-record als een TXT-record in de DNS-zone van uw domein. De hostnaam (de selector) moet het volgende formaat gebruiken:

[selector]._bimi.[domein]

De standaardselector is default. Voor het domein example.com publiceert u het TXT-record op de volgende hostnaam:

default._bimi.example.com

Opmerking: Het protocol ondersteunt aangepaste selectors voor subdomeinen of bedrijfsonderdelen, maar de meeste implementaties gebruiken de default-selector. Mailclients bevragen default._bimi wanneer er geen andere selector is opgegeven in de berichtkoppen.

De recordwaarde-syntax

De TXT-recordwaarde is een door puntkomma's gescheiden lijst van tags, met dezelfde structuur als een DMARC-record.

1. De versietag (v=)

Deze tag is verplicht en moet als eerste verschijnen. Hij identificeert de protocolversie. Syntax: v=BIMI1;

2. De locatietag (l=)

Deze tag is verplicht. Hij specificeert de HTTPS-URL waar de mailclient uw W3C SVG Tiny P/S-logobestand ophaalt. Syntax: l=https://example.com/logo.svg; Beperking: De URL moet HTTPS gebruiken. HTTP-URL's slagen niet voor validatie.

3. De autoriteitstag (a=)

Deze tag is optioneel in de basisspecificatie, maar in de praktijk verplicht voor logoweergave in Gmail en Apple Mail. Hij specificeert de HTTPS-URL waar de mailclient uw Verified Mark Certificate (VMC) of Common Mark Certificate (CMC) in .pem-formaat ophaalt. Syntax: a=https://example.com/certificate.pem; Self-asserted fallback: Voor self-asserted implementaties (alleen ondersteund door Yahoo en AOL), neemt u de tag op met een lege waarde: a=;

Volledige recordvoorbeelden

Voorbeeld A: Gecertificeerde implementatie (Gmail en Apple Mail)

Gebruik dit formaat om uw logo weer te geven in Gmail en Apple Mail en om het Gmail blauwe vinkje te ontvangen.

Type:  TXT

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

Voorbeeld B: Self-asserted implementatie (alleen Yahoo)

Gebruik dit formaat voor testen of wanneer u Yahoo Mail target voordat u een VMC verkrijgt.

Type:  TXT

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

Veelvoorkomende syntaxfouten

De volgende fouten veroorzaken validatiefouten:

1. Ontbrekende puntkomma's. Scheid elke tag met een puntkomma.
2. HTTP-URL's. Zowel de l=- als a=-tags moeten verwijzen naar https://-eindpunten.
3. Ongeldige SVG-bestanden. De l=-tag moet verwijzen naar een W3C SVG Tiny P/S-bestand. Standaard SVG-, PNG- of JPG-bestanden zorgen ervoor dat de mailclient de logoweergave overslaat zonder foutmelding.
4. Weggelaten a=-tag. Voor self-asserted records neemt u de a=-tag op met een lege waarde (a=;). Sommige parsers weigeren records die de tag volledig weglaten.

Geautomatiseerde recordgeneratie

Handmatige recordconstructie introduceert syntaxfouten. Om het SVG-bestand en de DNS TXT-string te genereren vanuit uw domeinparameters, gebruikt u makeBIMI, dat een kopieerinterface met één klik biedt.

Nadat u het record heeft gegenereerd, implementeert u het in uw DNS-zone. Als u een VMC nodig heeft om de a=-tag te vullen voor Gmail-compatibiliteit, gebruik dan een certificaatmakelaar zoals veriBIMI voor de certificaatprovisioning.

Referenties

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