Het BIMI DNS-record: De l= en a= tags uitgelegd
Een complete technische referentie voor de BIMI TXT-record syntax, met uitleg over de l= logo-tag en a= certificaat-tag, ondersteunde configuraties en veelvoorkomende fouten.
Het complete BIMI DNS-record
Een BIMI (Brand Indicators for Message Identification) DNS-record is een enkel TXT-record dat deelnemende e-mailclients vertelt waar ze uw merklogo kunnen vinden en — indien vereist — het certificaat dat bewijst dat u de eigenaar bent. De syntax moet exact kloppen: één onjuiste tag veroorzaakt een stille fout zonder bounce, zonder foutmelding en zonder logo.
Dit artikel behandelt elk onderdeel van het BIMI TXT-record, de regels voor elke tag, de drie gangbare recordconfiguraties en de fouten die logoweergave ongemerkt verstoren.
Vereisten
Controleer voordat u een BIMI-record publiceert of het volgende geregeld is:
- DMARC-beleid is ingesteld op
p=quarantineofp=rejectmet minimaalpct=100(of gelijkwaardige handhaving). - Uw logobestand is in SVG Tiny P/S-formaat en gehost op een publiek toegankelijke HTTPS-URL.
- Als u zich richt op Gmail of Apple Mail, beschikt u over een geldig VMC (Verified Mark Certificate) of CMC (Common Mark Certificate) in PEM-formaat, eveneens gehost op een publiek toegankelijke HTTPS-URL.
Structuur van het BIMI-record
Een BIMI TXT-record volgt deze algemene syntax:
v=BIMI1; l=<logo-url>; a=<certificate-url>
| Tag | Naam | Verplicht | Beschrijving |
|-----|------|-----------|--------------|
| v= | Versie | Ja | Altijd BIMI1. |
| l= | Logo-URL | Ja | HTTPS-URL die verwijst naar uw SVG Tiny P/S-logobestand. |
| a= | Bewijs van autoriteit | Voorwaardelijk | HTTPS-URL die verwijst naar uw VMC of CMC in PEM-formaat. Vereist voor Gmail en Apple Mail. |
Het record wordt gepubliceerd als een DNS TXT-record op het volgende subdomein:
default._bimi.<uwdomein.nl>
Let op: De default-selector is de standaardselector die door alle grote e-mailclients wordt gebruikt. Aangepaste selectors worden ondersteund door de specificatie, maar zijn nog niet breed geïmplementeerd door ontvangers.
De l=-tag: Logo-URL
Wat het doet
De l=-tag bevat de URL waarvandaan ontvangende e-mailclients uw merklogo ophalen. Wanneer een bericht door de DMARC-afstemming komt, haalt de client dit bestand op en toont het naast de afzendernaam.
Vereisten
- Protocol: Moet
https://zijn. HTTP-URL's worden geweigerd. - Toegankelijkheid: De URL moet publiek toegankelijk zijn — geen authenticatie, geen redirects, geen geoblokkering. Mailservers halen deze URL op vanuit hun eigen infrastructuur, niet vanuit een browser.
- Bestandsformaat: Het bestand moet voldoen aan SVG Tiny P/S (Portable/Secure), een beperkte subset van SVG 1.2 Tiny. Standaard SVG-bestanden zullen de validatie niet doorstaan, ook al worden ze correct weergegeven in een browser.
- Content-Type header: De server moet
image/svg+xmlretourneren. - Bestandsgrootte: Houd het bestand onder 32 KB. Sommige ontvangers hanteren strengere limieten.
Belangrijkste beperkingen van SVG Tiny P/S
SVG Tiny P/S verbiedt de volgende elementen en attributen die vaak in standaard SVG-bestanden voorkomen:
- Externe verwijzingen (
,xlink:hrefdie buiten het bestand verwijst) - Scripts (
) - Animaties (
,) - Ingesloten rasterafbeeldingen
- Willekeurige lettertypen (alleen systeemlettertypen, of tekst omgezet naar paden)
Belangrijk: Een bestand dat valide SVG is maar geen valide SVG Tiny P/S, zorgt ervoor dat de logoweergave op de meeste clients stilzwijgend mislukt. Valideer altijd met een speciale BIMI SVG-checker voordat u publiceert.
l= instellen op leeg
De specificatie staat l= met een lege waarde toe (l=;) om expliciet af te zien van BIMI-weergave voor een domein terwijl er toch een record gepubliceerd blijft. Dit is een randgeval dat gebruikt wordt bij het onderdrukken van subdomeinen.
De a=-tag: Bewijs van autoriteit (Certificaat-URL)
Wat het doet
De a=-tag verwijst naar een Mark Verifying Certificate (VMC) of Common Mark Certificate (CMC) in PEM-formaat. Dit certificaat koppelt uw logo cryptografisch aan uw domein en wordt uitgegeven door een geaccrediteerde Certificate Authority (CA). Ontvangende e-mailclients halen dit certificaat op, valideren de keten en bevestigen dat het ingebedde logo overeenkomt met de l=-URL voordat ze het merk weergeven.
Vereisten
- Protocol: Moet
https://zijn. HTTP-URL's worden geweigerd. - Toegankelijkheid: Publiek toegankelijk zonder authenticatie of redirects.
- Formaat: PEM-gecodeerde certificaatketen (
.pem). Het bestand moet de volledige keten bevatten, van het eindentiteitscertificaat tot de vertrouwde root. - Vertrouwensketen: Het certificaat moet ketenen naar een vertrouwde root-CA die erkend wordt door de ontvangende e-mailprovider. Zelfondertekende certificaten worden niet geaccepteerd.
- Overeenkomende logo-hash: Het SVG-bestand op
l=moet overeenkomen met de logo-hash die in het certificaat is ingebed. Het bijwerken van uw logo zonder het certificaat opnieuw uit te geven verstoort de weergave. - Geldigheid: Het certificaat mag niet verlopen of ingetrokken zijn.
VMC vs CMC
| Certificaattype | Volledige naam | Handelsmerk vereist | Uitgegeven door | |---|---|---|---| | VMC | Verified Mark Certificate | Ja — geregistreerd handelsmerk | DigiCert, Entrust | | CMC | Common Mark Certificate | Nee — common law-merk geaccepteerd | DigiCert, Entrust |
CMC's verlagen de drempel door de eis van handelsmerkregistratie te verwijderen, waardoor BIMI met certificaatverificatie toegankelijk wordt voor een bredere groep organisaties.
Self-asserted versus gecertificeerde records
Self-asserted record (alleen l=, geen a=)
Een self-asserted record bevat alleen de l=-tag. Er wordt geen certificaat vermeld.
default._bimi.example.com. IN TXT "v=BIMI1; l=https:class="hl-cmt">//bimi.example.com/logo.svg;"
Waar het werkt:
- Yahoo Mail / AOL Mail: Toont het logo zonder certificaat, mits DMARC wordt gehandhaafd.
- Fastmail: Ondersteunt self-asserted records.
Waar het niet werkt:
- Gmail: Vereist een geldig VMC of CMC. Self-asserted records worden genegeerd.
- Apple Mail: Vereist een geldig VMC of CMC. Self-asserted records worden genegeerd.
- Microsoft Outlook (365): Gebruikt een eigen BIMI-achtig systeem (BIMI wordt momenteel niet native ondersteund).
Samenvatting: Een self-asserted record is een goed startpunt en biedt waarde bij Yahoo Mail, maar het activeert geen logoweergave bij Gmail of Apple Mail.
VMC-record (Verified Mark Certificate)
Gebruik deze configuratie wanneer u een geregistreerd handelsmerk bezit en een VMC hebt verkregen van een geaccrediteerde CA.
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;"
Ondersteund door: Gmail, Yahoo Mail, Apple Mail, Fastmail en alle andere BIMI-deelnemende clients.
CMC-record (Common Mark Certificate)
Gebruik deze configuratie wanneer u een CMC hebt verkregen. De DNS-record syntax is identiek aan die van een VMC-record — het verschil zit in het certificaat zelf, niet in het DNS-record.
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;"
Ondersteund door: Gmail (sinds de uitrol van CMC-ondersteuning), Yahoo Mail, Apple Mail, Fastmail.
Let op: Bevestig altijd de actuele CMC-ondersteuningsstatus bij uw doelmailclients, aangezien uitroltijdlijnen per provider verschillen.
Veelvoorkomende fouten
1. Kapotte a=-URL veroorzaakt stille fout
Dit is de meest schadelijke en