Das default._bimi TXT-Eintrag Format
Das default._bimi TXT-Eintrag Format
Um eine Brand Indicators for Message Identification (BIMI)-Implementierung abzuschließen, veröffentlichen Sie einen DNS TXT-Eintrag. Dieser Eintrag teilt empfangenden Mailservern mit, wo sie Ihr SVG-Logo und Ihr Mark-Zertifikat abrufen können.
Dieser Artikel dokumentiert die erforderliche Syntax, Tags und Formatierungsregeln für den BIMI TXT-Eintrag [1].
Der Hostname (Selektor)
Veröffentlichen Sie den BIMI-Eintrag als TXT-Eintrag in der DNS-Zone Ihrer Domain. Der Hostname (der Selektor) muss folgendes Format verwenden:
[selector]._bimi.[domain]
Der Standardselektor ist default. Für die Domain example.com veröffentlichen Sie den TXT-Eintrag unter folgendem Hostnamen:
default._bimi.example.com
Hinweis: Das Protokoll unterstützt benutzerdefinierte Selektoren für Subdomains oder Geschäftsbereiche, aber die meisten Implementierungen verwenden den default-Selektor. Mail-Clients fragen default._bimi ab, wenn kein anderer Selektor in den Nachrichtenheadern angegeben ist.
Die Syntax des Eintragswerts
Der TXT-Eintragswert ist eine durch Semikolons getrennte Liste von Tags, die dieselbe Struktur wie ein DMARC-Eintrag verwendet.
1. Das Versions-Tag (v=)
Dieses Tag ist erforderlich und muss an erster Stelle stehen. Es identifiziert die Protokollversion.
Syntax: v=BIMI1;
2. Das Standort-Tag (l=)
Dieses Tag ist erforderlich. Es gibt die HTTPS-URL an, unter der der Mail-Client Ihre W3C SVG Tiny P/S-Logodatei abruft.
Syntax: l=https://example.com/logo.svg;
Einschränkung: Die URL muss HTTPS verwenden. HTTP-URLs bestehen die Validierung nicht.
3. Das Autoritäts-Tag (a=)
Dieses Tag ist in der Basisspezifikation optional, in der Praxis jedoch für die Logoanzeige in Gmail und Apple Mail erforderlich. Es gibt die HTTPS-URL an, unter der der Mail-Client Ihr Verified Mark Certificate (VMC) oder Common Mark Certificate (CMC) im .pem-Format abruft.
Syntax: a=https://example.com/certificate.pem;
Selbstdeklarierte Alternative: Für selbstdeklarierte Implementierungen (nur von Yahoo und AOL unterstützt) fügen Sie das Tag mit einem leeren Wert ein: a=;
Vollständige Eintragsbeispiele
Beispiel A: Zertifizierte Implementierung (Gmail und Apple Mail)
Verwenden Sie dieses Format, um Ihr Logo in Gmail und Apple Mail anzuzeigen und das blaue Gmail-Häkchen zu erhalten.
Type: TXT
Host: default._bimi
Value: v=BIMI1; l=https://example.com/logo.svg; a=https://example.com/cert.pem;
Beispiel B: Selbstdeklarierte Implementierung (nur Yahoo)
Verwenden Sie dieses Format zum Testen oder wenn Sie Yahoo Mail ansprechen möchten, bevor Sie ein VMC erhalten.
Type: TXT
Host: default._bimi
Value: v=BIMI1; l=https://example.com/logo.svg; a=;
Häufige Syntaxfehler
Die folgenden Fehler führen zu Validierungsfehlern:
- Fehlende Semikolons. Trennen Sie jedes Tag mit einem Semikolon.
- HTTP-URLs. Sowohl das
l=- als auch dasa=-Tag müssen aufhttps://-Endpunkte verweisen. - Ungültige SVG-Dateien. Das
l=-Tag muss auf eine W3C SVG Tiny P/S-Datei verweisen. Standard-SVG-, PNG- oder JPG-Dateien führen dazu, dass der Mail-Client die Logoanzeige ohne Fehlermeldung überspringt. - Ausgelassenes
a=-Tag. Für selbstdeklarierte Einträge fügen Sie dasa=-Tag mit einem leeren Wert ein (a=;). Einige Parser lehnen Einträge ab, die das Tag vollständig auslassen.
Automatisierte Eintragsgenerierung
Manuelle Eintragskonstruktion führt zu Syntaxfehlern. Um die SVG-Datei und die DNS TXT-Zeichenkette aus Ihren Domain-Parametern zu generieren, verwenden Sie makeBIMI, das eine Ein-Klick-Kopierfunktion bietet.
Nachdem Sie den Eintrag generiert haben, stellen Sie ihn in Ihrer DNS-Zone bereit. Wenn Sie ein VMC benötigen, um das a=-Tag für Gmail-Kompatibilität zu befüllen, verwenden Sie einen Zertifikatsvermittler wie veriBIMI für die Zertifikatsbereitstellung.
Referenzen
[1] M. Blank, et al. "Brand Indicators for Message Identification (BIMI)." IETF Datatracker, RFC 9091, https://datatracker.ietf.org/doc/html/rfc9091