Format TXT Record default._bimi

Untuk menyelesaikan implementasi Brand Indicators for Message Identification (BIMI), Anda perlu mempublikasikan sebuah DNS TXT record. Record ini memberitahu server email penerima di mana mereka dapat mengambil logo SVG dan Mark Certificate Anda.

Artikel ini mendokumentasikan sintaks, tag, dan aturan format yang diperlukan untuk BIMI TXT record [1].

Hostname (Selector)

Publikasikan BIMI record sebagai TXT record di zona DNS domain Anda. Hostname (selector) harus menggunakan format berikut:

[selector]._bimi.[domain]

Selector default adalah default. Untuk domain example.com, publikasikan TXT record pada hostname berikut:

default._bimi.example.com

Catatan: Protokol ini mendukung selector kustom untuk subdomain atau unit bisnis, tetapi sebagian besar implementasi menggunakan selector default. Klien email akan mengkueri default._bimi ketika tidak ada selector lain yang ditentukan dalam header pesan.

Sintaks Nilai Record

Nilai TXT record adalah daftar tag yang dipisahkan titik koma, menggunakan struktur yang sama seperti DMARC record.

1. Tag Versi (v=)

Tag ini wajib dan harus muncul pertama. Tag ini mengidentifikasi versi protokol. Sintaks: v=BIMI1;

2. Tag Lokasi (l=)

Tag ini wajib. Tag ini menentukan URL HTTPS tempat klien email mengambil file logo SVG Tiny P/S W3C Anda. Sintaks: l=https://example.com/logo.svg; Batasan: URL harus menggunakan HTTPS. URL HTTP akan gagal validasi.

3. Tag Authority (a=)

Tag ini bersifat opsional dalam spesifikasi dasar tetapi wajib dalam praktiknya untuk menampilkan logo di Gmail dan Apple Mail. Tag ini menentukan URL HTTPS tempat klien email mengambil Verified Mark Certificate (VMC) atau Common Mark Certificate (CMC) Anda dalam format .pem. Sintaks: a=https://example.com/certificate.pem; Fallback self-asserted: Untuk implementasi self-asserted (hanya didukung oleh Yahoo dan AOL), sertakan tag dengan nilai kosong: a=;

Contoh Record Lengkap

Contoh A: Implementasi tersertifikasi (Gmail dan Apple Mail)

Gunakan format ini untuk menampilkan logo Anda di Gmail dan Apple Mail serta menerima tanda centang biru Gmail.

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

Contoh B: Implementasi self-asserted (khusus Yahoo)

Gunakan format ini untuk pengujian atau ketika menargetkan Yahoo Mail sebelum Anda memperoleh VMC.

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

Kesalahan Sintaks Umum

Kesalahan-kesalahan berikut menyebabkan kegagalan validasi:

1. Titik koma yang hilang. Pisahkan setiap tag dengan titik koma.
2. URL HTTP. Baik tag l= maupun a= harus merujuk ke endpoint https://.
3. File SVG tidak valid. Tag l= harus merujuk ke file W3C SVG Tiny P/S. File SVG standar, PNG, atau JPG akan menyebabkan klien email melewatkan tampilan logo tanpa pesan error.
4. Tag a= yang dihilangkan. Untuk record self-asserted, sertakan tag a= dengan nilai kosong (a=;). Beberapa parser menolak record yang menghilangkan tag ini sepenuhnya.

Pembuatan Record Otomatis

Pembuatan record secara manual rentan terhadap kesalahan sintaks. Untuk menghasilkan file SVG dan string DNS TXT dari parameter domain Anda, gunakan makeBIMI, yang menyediakan antarmuka salin sekali klik.

Setelah Anda menghasilkan record, deploy ke zona DNS Anda. Jika Anda memerlukan VMC untuk mengisi tag a= agar kompatibel dengan Gmail, gunakan layanan perantara sertifikat seperti veriBIMI untuk menangani penyediaan sertifikat.

Referensi

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