TL;DR

  • MailAuthGuard의 Node.js·JavaScript·TypeScript 클라이언트가 이메일 도메인을 30밀리초 이내에 점검하고 전달성 상태를 감사함.
  • SPF, DKIM, DMARC, BIMI, MTA-STS, MX 레코드를 분석해 0~100점 건강 점수와 A+~F 등급을 산출함.
  • RFC 7208, RFC 7489, RFC 6376과 Google·Yahoo의 2024년 이후 대량 발신자 전달성 요구사항을 기준으로 도메인을 감사함.
  • SPF 조회 깊이와 DMARC 정책·정렬, DKIM 키 길이, BIMI 로고·인증서 상태를 개별적으로 확인함.
  • 단일 API 요청으로 최대 25개 도메인을 병렬 감사하며, 패키지 라이선스는 MIT임.

MailAuthGuard JavaScript·TypeScript SDK

  • mailauthguard-client는 MailAuthGuard용 공식 Node.js·JavaScript·TypeScript 클라이언트임.
  • MailAuthGuard는 B2B 이메일 전달성, SPF, DKIM, DMARC, BIMI, MTA-STS 상태를 감사하는 고속 엔진임.
  • 모든 이메일 도메인을 30밀리초 이내에 RFC 7208, RFC 7489, RFC 6376, BIMI, Google·Yahoo의 2024년 이후 대량 발신자 전달성 요구사항과 대조함.

설치

  • npm을 사용하는 설치 명령은 npm install mailauthguard-client임.
  • Yarn, pnpm, Bun을 사용하는 설치 명령은 각각 yarn add mailauthguard-client, pnpm add mailauthguard-client, bun add mailauthguard-client임.

빠른 시작

  • MailAuthGuard의 RapidAPI Hub에서 무료 RapidAPI 키를 발급받아 RAPIDAPI_KEY 환경 변수로 전달함.
  • 클라이언트를 초기화한 뒤 client.audit('stripe.com')을 호출해 전체 전달성 감사를 실행함.
  • 감사 결과에서 등급 A+, 점수 98/100, Google·Yahoo 규정 준수 여부 true, SPF 상태 valid, DMARC 정책 reject 같은 필드를 확인함.

API 참고

통합 전달성 감사

  • client.audit('github.com', 'selector1')은 SPF, DMARC, DKIM, BIMI, MTA-STS, MX 레코드를 동시에 분석함.
  • 종합 건강 점수(0~100)와 문자 등급(A+~F)을 계산하며, 결과의 권장 사항을 확인할 수 있음.

상세 SPF 레코드 분석

  • client.checkSpf('airbnb.com')은 DNS SPF 레코드를 확인하고 구문을 검증하며 DNS 조회 깊이를 계산함.
  • RFC 7208의 10회 조회 제한을 적용하고 누락된 메커니즘을 표시함. 예시 결과의 lookup_count는 4임.

DMARC 정책 및 정렬 감사

  • client.checkDmarc('shopify.com')은 DMARC 레코드를 검증하고 reject, quarantine, none 정책의 엄격도를 보고함.
  • 집계·포렌식 보고용 메일함(rua)을 추출하고 2024년 Google·Yahoo 받은 편지함 규칙에 맞는 정렬 여부를 확인함. 예시 정책은 reject임.

DKIM 선택자 검증

  • client.checkDkim('google.com', '20230601')은 선택자의 공개 키를 조회하고 1024비트와 2048비트 보안 수준을 확인함.
  • 오래되고 취약한 암호화 키를 표시하며, 예시 결과의 키 길이는 2048비트임.

BIMI 및 브랜드 아바타 검증

  • client.checkBimi('cnn.com')은 BIMI DNS 레코드, SVG 아이콘 자산, 검증 마크 인증서(VMC)를 검증함.
  • 검증 결과를 통해 Gmail, Yahoo, Apple Mail에 브랜드 로고를 표시할 수 있으며, 결과에서 로고 URL을 확인함.

도메인 일괄 감사

  • client.batchAudit는 단일 API 요청으로 최대 25개 도메인을 병렬 감사함.
  • 예시 대상은 stripe.com, uber.com, notion.so이며, 결과에서 감사 도메인 수와 소요 시간(밀리초)을 확인함.

라이선스

  • 라이선스는 MIT이며 저작권 표기는 NexusGrid임.