Format rekordu TXT default._bimi

Aby ukończyć wdrożenie Brand Indicators for Message Identification (BIMI), musisz opublikować rekord TXT w DNS. Ten rekord informuje odbierające serwery pocztowe, skąd pobrać Twoje logo SVG oraz certyfikat znaku.

Niniejszy artykuł dokumentuje wymaganą składnię, tagi i zasady formatowania rekordu TXT BIMI [1].

Nazwa hosta (selektor)

Opublikuj rekord BIMI jako rekord TXT w strefie DNS Twojej domeny. Nazwa hosta (selektor) musi mieć następujący format:

[selektor]._bimi.[domena]

Domyślnym selektorem jest default. Dla domeny example.com opublikuj rekord TXT pod następującą nazwą hosta:

default._bimi.example.com

Uwaga: Protokół obsługuje niestandardowe selektory dla subdomen lub jednostek biznesowych, jednak większość wdrożeń wykorzystuje selektor default. Klienci poczty odpytują default._bimi, gdy w nagłówkach wiadomości nie określono innego selektora.

Składnia wartości rekordu

Wartość rekordu TXT to lista tagów rozdzielonych średnikami, o strukturze identycznej jak rekord DMARC.

1. Tag wersji (v=)

Ten tag jest wymagany i musi pojawić się jako pierwszy. Identyfikuje wersję protokołu. Składnia: v=BIMI1;

2. Tag lokalizacji (l=)

Ten tag jest wymagany. Określa adres URL HTTPS, z którego klient poczty pobiera Twój plik logo SVG Tiny P/S zgodny ze standardem W3C. Składnia: l=https://example.com/logo.svg; Ograniczenie: Adres URL musi używać protokołu HTTPS. Adresy HTTP nie przechodzą walidacji.

3. Tag autorytetu (a=)

Ten tag jest opcjonalny w specyfikacji podstawowej, ale w praktyce wymagany do wyświetlania logo w Gmail i Apple Mail. Określa adres URL HTTPS, z którego klient poczty pobiera Twój Verified Mark Certificate (VMC) lub Common Mark Certificate (CMC) w formacie .pem. Składnia: a=https://example.com/certificate.pem; Wariant samodeklarowany: W przypadku wdrożeń samodeklarowanych (obsługiwanych tylko przez Yahoo i AOL) należy dołączyć tag z pustą wartością: a=;

Kompletne przykłady rekordów

Przykład A: Wdrożenie certyfikowane (Gmail i Apple Mail)

Użyj tego formatu, aby wyświetlać logo w Gmail i Apple Mail oraz otrzymać niebieski znacznik weryfikacji Gmail.

Type:  TXT

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

Przykład B: Wdrożenie samodeklarowane (tylko Yahoo)

Użyj tego formatu do testów lub gdy kierujesz działania do Yahoo Mail przed uzyskaniem VMC.

Type:  TXT

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

Częste błędy składniowe

Poniższe błędy powodują niepowodzenie walidacji:

1. Brakujące średniki. Każdy tag musi być oddzielony średnikiem.
2. Adresy URL HTTP. Zarówno tag l=, jak i a= muszą wskazywać na adresy https://.
3. Nieprawidłowe pliki SVG. Tag l= musi wskazywać na plik SVG Tiny P/S zgodny ze standardem W3C. Standardowe pliki SVG, PNG lub JPG powodują, że klient poczty pomija wyświetlanie logo bez komunikatu o błędzie.
4. Pominięty tag a=. W przypadku rekordów samodeklarowanych należy dołączyć tag a= z pustą wartością (a=;). Niektóre parsery odrzucają rekordy, w których tag został całkowicie pominięty.

Automatyczne generowanie rekordu

Ręczne tworzenie rekordu prowadzi do błędów składniowych. Aby wygenerować plik SVG i ciąg TXT DNS na podstawie parametrów Twojej domeny, użyj makeBIMI, który oferuje interfejs kopiowania jednym kliknięciem.

Po wygenerowaniu rekordu wdróż go w swojej strefie DNS. Jeśli potrzebujesz VMC do wypełnienia tagu a= w celu zapewnienia kompatybilności z Gmail, skorzystaj z pośrednika certyfikatów, takiego jak veriBIMI, który zajmie się pozyskaniem certyfikatu.

Bibliografia

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