BIMI DNS 레코드: l= 및 a= 태그 완벽 가이드
l= 로고 태그와 a= 인증서 태그를 포함한 BIMI TXT 레코드 문법, 지원되는 구성, 그리고 흔한 구성 오류에 대한 완전한 기술 참조 문서입니다.
완전한 BIMI DNS 레코드 가이드
BIMI (Brand Indicators for Message Identification) DNS 레코드는 참여 이메일 클라이언트에게 브랜드 로고의 위치와 — 필요한 경우 — 소유권을 증명하는 인증서의 위치를 알려주는 단일 TXT 레코드입니다. 문법을 정확하게 작성하는 것은 타협의 여지가 없습니다: 단 하나의 잘못된 태그만으로도 반송 메일 없이, 오류 로그 없이, 로고 없이 조용히 실패하게 됩니다.
이 문서는 BIMI TXT 레코드의 모든 구성 요소, 각 태그를 규정하는 규칙, 세 가지 표준 레코드 구성, 그리고 로고 표시를 조용히 중단시키는 구성 오류들을 다룹니다.
선행 조건
BIMI 레코드를 게시하기 전에 다음 사항들이 갖춰져 있는지 확인하세요:
- DMARC 정책이
p=quarantine또는p=reject로 설정되어 있고 최소pct=100(또는 동등한 적용 수준)이어야 합니다. - 로고 파일이 SVG Tiny P/S 형식이며 공개적으로 접근 가능한 HTTPS URL에서 호스팅되어야 합니다.
- Gmail 또는 Apple Mail을 대상으로 하는 경우, PEM 형식의 유효한 VMC (Verified Mark Certificate) 또는 CMC (Common Mark Certificate)가 공개적으로 접근 가능한 HTTPS URL에서 호스팅되어야 합니다.
BIMI 레코드 구조
BIMI TXT 레코드는 다음과 같은 일반적인 문법을 따릅니다:
v=BIMI1; l=<logo-url>; a=<certificate-url>
| 태그 | 명칭 | 필수 여부 | 설명 |
|-----|------|----------|-------------|
| v= | 버전 | 예 | 항상 BIMI1입니다. |
| l= | 로고 URL | 예 | SVG Tiny P/S 로고 파일을 가리키는 HTTPS URL입니다. |
| a= | 권한 증거 | 조건부 | PEM 형식의 VMC 또는 CMC를 가리키는 HTTPS URL입니다. Gmail과 Apple Mail에서 필수입니다. |
레코드는 다음 하위 도메인에 DNS TXT 레코드로 게시됩니다:
default._bimi.<yourdomain.com>
참고: default 선택자는 모든 주요 이메일 클라이언트에서 사용하는 표준 선택자입니다. 사용자 정의 선택자는 사양에서 지원되지만 수신자 측에서 아직 널리 구현되지 않았습니다.
l= 태그: 로고 URL
역할
l= 태그는 수신 메일 클라이언트가 브랜드 로고를 가져오는 URL을 제공합니다. 메시지가 DMARC 정렬을 통과하면 클라이언트는 이 파일을 가져와 발신자 이름 옆에 렌더링합니다.
요구 사항
- 프로토콜: 반드시
https://여야 합니다. HTTP URL은 거부됩니다. - 접근성: URL은 공개적으로 접근 가능해야 합니다 — 인증 없이, 리다이렉트 없이, 지역 차단 없이. 메일 서버는 브라우저가 아닌 자체 인프라에서 이 URL을 가져옵니다.
- 파일 형식: 파일은 SVG Tiny P/S (Portable/Secure)를 준수해야 합니다. 이는 SVG 1.2 Tiny의 제한된 하위 집합입니다. 표준 SVG 파일은 브라우저에서 정상적으로 렌더링되더라도 검증에 실패합니다.
- Content-Type 헤더: 서버는
image/svg+xml을 반환해야 합니다. - 파일 크기: 파일을 32 KB 미만으로 유지하세요. 일부 수신자는 더 엄격한 제한을 적용합니다.
SVG Tiny P/S 주요 제한 사항
SVG Tiny P/S는 표준 SVG 파일에서 흔히 발견되는 다음 요소 및 속성들을 금지합니다:
- 외부 참조 (
, 파일 외부를 가리키는xlink:href) - 스크립트 (
) - 애니메이션 (
,) - 래스터 이미지 임베드
- 임의의 폰트 (시스템 폰트만 허용, 또는 텍스트를 패스로 변환)
중요: 유효한 SVG이지만 유효한 SVG Tiny P/S가 아닌 파일은 대부분의 클라이언트에서 로고 표시가 조용히 실패합니다. 게시 전에 항상 전용 BIMI SVG 검사기로 검증하세요.
l=를 비워두기
사양에서는 빈 값을 가진 l= (l=;)를 사용하여 레코드를 게시하면서도 도메인에 대한 BIMI 표시를 명시적으로 거부할 수 있습니다. 이는 하위 도메인 억제 시나리오에서 사용되는 예외적인 경우입니다.
a= 태그: 권한 증거 (인증서 URL)
역할
a= 태그는 PEM 형식의 Mark Verifying Certificate (VMC) 또는 Common Mark Certificate (CMC)를 가리킵니다. 이 인증서는 로고를 도메인에 암호학적으로 바인딩하며 공인된 인증 기관(CA)에서 발급됩니다. 수신 메일 클라이언트는 이 인증서를 가져와 체인을 검증하고, 내장된 로고가 l= URL과 일치하는지 확인한 후 마크를 표시합니다.
요구 사항
- 프로토콜: 반드시
https://여야 합니다. HTTP URL은 거부됩니다. - 접근성: 인증이나 리다이렉트 없이 공개적으로 접근 가능해야 합니다.
- 형식: PEM으로 인코딩된 인증서 체인(
.pem)이어야 합니다. 파일에는 최종 엔티티 인증서부터 신뢰할 수 있는 루트까지의 전체 체인이 포함되어야 합니다. - 신뢰 체인: 인증서는 수신 메일 제공업체가 인정하는 신뢰할 수 있는 루트 CA에 체인되어야 합니다. 자체 서명 인증서는 허용되지 않습니다.
- 로고 해시 일치:
l=의 SVG 파일은 인증서에 내장된 로고 해시와 일치해야 합니다. 인증서를 재발급하지 않고 로고를 업데이트하면 표시가 중단됩니다. - 유효성: 인증서가 만료되거나 폐지되지 않아야 합니다.
VMC vs CMC
| 인증서 유형 | 정식 명칭 | 상표 필요 여부 | 발급 기관 | |---|---|---|---| | VMC | Verified Mark Certificate | 예 — 등록 상표 필요 | DigiCert, Entrust | | CMC | Common Mark Certificate | 아니오 — 관습법상 마크 허용 | DigiCert, Entrust |
CMC는 상표 등록 요구 사항을 제거하여 진입 장벽을 낮추고, 더 넓은 범위의 조직이 인증서 검증이 포함된 BIMI에 접근할 수 있게 합니다.
자체 주장 vs 인증된 레코드
자체 주장 레코드 (l=만 있고 a= 없음)
자체 주장 레코드는 l= 태그만 포함합니다. 인증서가 참조되지 않습니다.
default._bimi.example.com. IN TXT "v=BIMI1; l=https:class="hl-cmt">//bimi.example.com/logo.svg;"
적용되는 곳:
- Yahoo Mail / AOL Mail: DMARC가 적용되어 있으면 인증서 없이도 로고를 표시합니다.
- Fastmail: 자체 주장 레코드를 지원합니다.
적용되지 않는 곳:
- Gmail: 유효한 VMC 또는 CMC가 필요합니다. 자체 주장 레코드는 무시됩니다.
- Apple Mail: 유효한 VMC 또는 CMC가 필요합니다. 자체 주장 레코드는 무시됩니다.
- Microsoft Outlook (365): 자체 BIMI 유사 시스템을 사용합니다(현재 BIMI를 기본적으로 지원하지 않습니다).
요약: 자체 주장 레코드는 유효한 시작점이며 Yahoo Mail에서 가치를 제공하지만, Gmail이나 Apple Mail에서는 로고 표시가 활성화되지 않습니다.
VMC 레코드 (Verified Mark Certificate)
등록 상표를 보유하고 있으며 공인된 CA에서 VMC를 획득한 경우 이 구성을 사용하세요.
default._bimi.example.com. IN TXT "v=BIMI1; l=https:class="hl-cmt">//bimi.example.com/logo.svg; a=https://bimi.example.com/vmc.pem;"
지원 범위: Gmail, Yahoo Mail, Apple Mail, Fastmail, 및 모든 BIMI 참여 클라이언트.
CMC 레코드 (Common Mark Certificate)
CMC를 획득한 경우 이 구성을 사용하세요. DNS 레코드 문법은 VMC 레코드와 동일합니다 — 차이점은 DNS 레코드가 아닌 인증서 자체에 있습니다.
default._bimi.example.com. IN TXT "v=BIMI1; l=https:class="hl-cmt">//bimi.example.com/logo.svg; a=https://bimi.example.com/cmc.pem;"
지원 범위: Gmail(CMC 지원 출시 이후), Yahoo Mail, Apple Mail, Fastmail.
참고: 출시 일정이 제공업체마다 다르므로 항상 대상 메일 클라이언트의 현재 CMC 지원 상태를 확인하세요.
흔한 구성 오류
1. 손상된 a= URL로 인한 조용한 실패
이것은 가장 치명적이며