Định dạng bản ghi TXT default._bimi
Định dạng bản ghi TXT default._bimi
Để hoàn tất việc triển khai Brand Indicators for Message Identification (BIMI), bạn cần xuất bản một bản ghi TXT trong DNS. Bản ghi này cho các máy chủ mail nhận biết nơi để lấy logo SVG và Mark Certificate của bạn.
Bài viết này mô tả cú pháp bắt buộc, các thẻ và quy tắc định dạng cho bản ghi TXT BIMI [1].
Hostname (Selector)
Xuất bản bản ghi BIMI dưới dạng bản ghi TXT trong vùng DNS của tên miền. Hostname (selector) phải tuân theo định dạng sau:
[selector]._bimi.[domain]
Selector mặc định là default. Đối với tên miền example.com, xuất bản bản ghi TXT tại hostname sau:
default._bimi.example.com
Lưu ý: Giao thức hỗ trợ các selector tùy chỉnh cho subdomain hoặc đơn vị kinh doanh, nhưng hầu hết các triển khai sử dụng selector default. Ứng dụng mail sẽ truy vấn default._bimi khi không có selector nào khác được chỉ định trong header của thư.
Cú pháp giá trị bản ghi
Giá trị bản ghi TXT là danh sách các thẻ phân cách bằng dấu chấm phẩy, sử dụng cấu trúc tương tự như bản ghi DMARC.
1. Thẻ phiên bản (v=)
Thẻ này bắt buộc và phải xuất hiện đầu tiên. Nó xác định phiên bản giao thức.
Cú pháp: v=BIMI1;
2. Thẻ vị trí (l=)
Thẻ này bắt buộc. Nó chỉ định URL HTTPS nơi ứng dụng mail lấy file logo W3C SVG Tiny P/S của bạn.
Cú pháp: l=https://example.com/logo.svg;
Ràng buộc: URL phải sử dụng HTTPS. URL HTTP sẽ không vượt qua xác thực.
3. Thẻ cơ quan cấp (a=)
Thẻ này là tùy chọn theo đặc tả cơ bản nhưng bắt buộc trong thực tế để hiển thị logo trong Gmail và Apple Mail. Nó chỉ định URL HTTPS nơi ứng dụng mail lấy Verified Mark Certificate (VMC) hoặc Common Mark Certificate (CMC) của bạn ở định dạng .pem.
Cú pháp: a=https://example.com/certificate.pem;
Phương án tự khai báo: Đối với triển khai tự khai báo (chỉ được hỗ trợ bởi Yahoo và AOL), bao gồm thẻ với giá trị trống: a=;
Ví dụ bản ghi hoàn chỉnh
Ví dụ A: Triển khai có chứng chỉ (Gmail và Apple Mail)
Sử dụng định dạng này để hiển thị logo trong Gmail và Apple Mail và nhận dấu tích xanh của Gmail.
Type: TXT
Host: default._bimi
Value: v=BIMI1; l=https://example.com/logo.svg; a=https://example.com/cert.pem;
Ví dụ B: Triển khai tự khai báo (chỉ Yahoo)
Sử dụng định dạng này để thử nghiệm hoặc khi nhắm mục tiêu Yahoo Mail trước khi bạn có VMC.
Type: TXT
Host: default._bimi
Value: v=BIMI1; l=https://example.com/logo.svg; a=;
Các lỗi cú pháp thường gặp
Các lỗi sau đây gây ra thất bại trong xác thực:
- Thiếu dấu chấm phẩy. Phân cách mỗi thẻ bằng dấu chấm phẩy.
- URL HTTP. Cả thẻ
l=vàa=đều phải tham chiếu đến endpointhttps://. - File SVG không hợp lệ. Thẻ
l=phải tham chiếu đến file W3C SVG Tiny P/S. Các file SVG tiêu chuẩn, PNG hoặc JPG sẽ khiến ứng dụng mail bỏ qua hiển thị logo mà không báo lỗi. - Bỏ sót thẻ
a=. Đối với bản ghi tự khai báo, bao gồm thẻa=với giá trị trống (a=;). Một số trình phân tích sẽ từ chối bản ghi hoàn toàn bỏ sót thẻ này.
Tạo bản ghi tự động
Việc xây dựng bản ghi thủ công dễ gây ra lỗi cú pháp. Để tạo file SVG và chuỗi TXT DNS từ các thông số tên miền của bạn, sử dụng makeBIMI, công cụ cung cấp giao diện sao chép một cú nhấp.
Sau khi tạo bản ghi, triển khai nó vào vùng DNS của bạn. Nếu bạn cần VMC để điền vào thẻ a= cho tương thích với Gmail, sử dụng dịch vụ môi giới chứng chỉ như veriBIMI để xử lý việc cấp phát chứng chỉ.
Tài liệu tham khảo
[1] M. Blank, et al. “Brand Indicators for Message Identification (BIMI).” IETF Datatracker, RFC 9091, https://datatracker.ietf.org/doc/html/rfc9091