Формат TXT-запису default._bimi

Для завершення впровадження Brand Indicators for Message Identification (BIMI) необхідно опублікувати DNS TXT-запис. Цей запис повідомляє поштовим серверам-отримувачам, де отримати ваш SVG-логотип та сертифікат Mark Certificate.

У цій статті описано необхідний синтаксис, теги та правила форматування TXT-запису BIMI [1].

Ім’я хоста (селектор)

Опублікуйте BIMI-запис як TXT-запис у DNS-зоні вашого домену. Ім’я хоста (селектор) повинно відповідати наступному формату:

[selector]._bimi.[domain]

Селектором за замовчуванням є default. Для домену example.com опублікуйте TXT-запис з наступним ім’ям хоста:

default._bimi.example.com

Примітка: Протокол підтримує власні селектори для піддоменів або бізнес-підрозділів, але більшість впроваджень використовують селектор default. Поштові клієнти запитують default._bimi, коли в заголовках повідомлення не вказано інший селектор.

Синтаксис значення запису

Значення TXT-запису — це список тегів, розділених крапкою з комою, що використовує таку ж структуру, як і запис DMARC.

1. Тег версії (v=)

Цей тег є обов’язковим і повинен бути першим. Він ідентифікує версію протоколу. Синтаксис: v=BIMI1;

2. Тег розташування (l=)

Цей тег є обов’язковим. Він вказує HTTPS URL, за яким поштовий клієнт отримує ваш файл логотипу W3C SVG Tiny P/S. Синтаксис: l=https://example.com/logo.svg; Обмеження: URL повинен використовувати HTTPS. URL з HTTP не проходять валідацію.

3. Тег повноважень (a=)

Цей тег є необов’язковим у базовій специфікації, але на практиці обов’язковий для відображення логотипу в Gmail та Apple Mail. Він вказує HTTPS URL, за яким поштовий клієнт отримує ваш Verified Mark Certificate (VMC) або Common Mark Certificate (CMC) у форматі .pem. Синтаксис: a=https://example.com/certificate.pem; Резервний варіант для самодекларованих записів: Для самодекларованих впроваджень (підтримуються лише Yahoo та AOL) вкажіть тег із порожнім значенням: a=;

Повні приклади записів

Приклад А: Сертифіковане впровадження (Gmail та Apple Mail)

Використовуйте цей формат для відображення вашого логотипу в Gmail та Apple Mail та отримання синьої позначки Gmail.

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

Приклад Б: Самодеклароване впровадження (лише Yahoo)

Використовуйте цей формат для тестування або коли орієнтуєтеся на Yahoo Mail до отримання VMC.

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

Поширені синтаксичні помилки

Наступні помилки призводять до невдалої валідації:

1. Відсутні крапки з комою. Розділяйте кожен тег крапкою з комою.
2. HTTP URL. Теги l= та a= повинні посилатися на https:// адреси.
3. Недійсні SVG-файли. Тег l= повинен посилатися на файл W3C SVG Tiny P/S. Стандартні SVG, PNG або JPG файли призводять до того, що поштовий клієнт пропускає відображення логотипу без повідомлення про помилку.
4. Пропущений тег a=. Для самодекларованих записів включіть тег a= із порожнім значенням (a=;). Деякі парсери відхиляють записи, в яких тег повністю відсутній.

Автоматична генерація запису

Ручне створення запису призводить до синтаксичних помилок. Для генерації SVG-файлу та рядка DNS TXT на основі параметрів вашого домену використовуйте makeBIMI, який надає інтерфейс копіювання одним кліком.

Після генерації запису розгорніть його у вашій DNS-зоні. Якщо вам потрібен VMC для заповнення тегу a= для сумісності з Gmail, скористайтеся брокерським сервісом сертифікатів, таким як veriBIMI, для організації отримання сертифіката.

Посилання

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