이메일 유효성 검사

이 참조 문서에서는 이메일 주소의 로컬 및 호스트 부분 유효성 검사 규칙을 다룹니다. 유효성 검사는 대시보드 이메일 주소, 최종 사용자 이메일 주소(고객), 이메일 메시지의 발신자 및 회신 주소에 사용됩니다.

작동 방식

Braze는 이메일 주소가 업데이트되거나 API, CSV 업로드, SDK를 통해 가져오거나 대시보드에서 수정될 때 이메일 주소를 검증합니다. 이메일 주소에는 공백이 포함될 수 없습니다. API를 사용하는 경우, 공백은 400 오류를 반환합니다.

Braze는 특정 문자를 거부하고 주소를 유효하지 않다고 표시합니다. 이메일이 반송되면 Braze는 주소를 유효하지 않다고 표시하고 구독 상태를 변경하지 않습니다. 이메일 본문에 비표준 ASCII 문자가 포함된 경우, Braze는 이메일을 전송하지 않습니다.

이 유효성 검사는 구문 검사이며, 유효성 검사 서비스가 아닙니다. 이 프로세스의 목표 중 하나는 이메일 주소의 로컬 부분에서 국제 문자를 지원하는 것입니다(예: UTF-8).

Braze는 이메일 주소의 로컬 부분과 호스트 부분 모두에 대한 구문을 검증합니다. 로컬 부분은 앳 기호(@) 이전의 모든 것이며, 호스트 부분은 이후의 모든 것입니다. 로컬 부분은 마침표(.)를 제외한 모든 허용된 문자로 시작하고 끝날 수 있습니다. 이 프로세스는 도메인에 유효한 MX 서버가 있는지 또는 해당 도메인에 사용자가 존재하는지를 고려하지 않습니다.

Braze가 유효하지 않은 이메일 주소를 가진 사용자를 추가하라는 요청을 받으면, API는 오류를 반환합니다. CSV 업로드의 경우, Braze는 사용자를 생성하지만 유효하지 않은 이메일 주소는 생략합니다.

로컬 부분 유효성 검사 규칙

일반 이메일 유효성 검사

대부분의 도메인에서는 로컬 부분이 다음 매개변수를 따라야 합니다:

• 모든 문자, 숫자를 포함할 수 있으며, 유니코드 문자와 숫자 및 다음 문자를 포함할 수 있습니다: (+) (&) (#) (_) (-) (^) 또는 (/)
• 다음을 포함할 수 있지만 다음 문자로 시작하거나 끝날 수 없습니다: (.)
• 큰따옴표(“)를 포함할 수 없습니다
• 1과 64자 사이여야 합니다

다음 정규표현식을 사용하여 이메일 주소가 유효한지 확인할 수 있습니다:

1
/\A([a-zA-Z0-9_\-\^+$'\&#\/!%\*=\?`\|~]|[[^\p{ASCII}\p{Space}]&&\p{Alnum}\p{Punct}\p{S}])(([a-zA-Z0-9_\-\^+$'\&#\/!%\*=\?`\|~\.]|[[^\p{ASCII}\p{Space}]&&\p{Alnum}\p{Punct}\p{S}])*([a-zA-Z0-9_\-\^+$'\&#\/!%\*=\?`\|~]|[[^\p{ASCII}\p{Space}]&&\p{Alnum}\p{Punct}\p{S}]))?\z/

Gmail 주소

도메인 부분이 Gmail인 경우, 로컬 부분은 최소 두 글자 이상이어야 하며 위에 나열된 정규표현식 유효성 검사를 따라야 합니다.

Microsoft 도메인

호스트 도메인에 “msn”, “hotmail”, “outlook” 또는 “live”가 포함된 경우, Braze는 로컬 부분을 검증하기 위해 다음 정규표현식을 사용합니다: /\A\w[\-\w]*(?:\.[\-\w]+)*\z/i

Microsoft 주소 로컬 부분은 다음 매개변수를 따라야 합니다:

• 문자(a-z), 밑줄 (_), 또는 숫자(0-9)로 시작할 수 있습니다.
• 알파벳 숫자(a-z 또는 0-9) 또는 밑줄 (_)을 포함할 수 있습니다.
• 다음 문자를 포함할 수 있습니다: (.) 또는 (-)
• 마침표(.)로 시작할 수 없습니다
• 두 개 이상의 연속된 마침표(.)를 포함할 수 없습니다
• 마침표(.)로 끝날 수 없습니다

유효성 검사 테스트는 “+” 앞의 로컬 부분이 정규표현식과 일치하는지 확인합니다.

호스트 부분 유효성 검사 규칙

호스트 부분은 IPv4 또는 IPv6 주소일 수 없습니다. .com, .org, .net과 같은 최상위 도메인은 완전히 숫자일 수 없습니다.

다음 정규표현식은 도메인을 검증하는 데 사용됩니다:
/^[a-z\d](?:[a-z\d-]{0,61}[a-z\d])?(?:\.[a-z\d](?:[a-z\d-]{0,61}[a-z\d])?)+$/i

도메인 이름은 다음 매개변수를 충족해야 합니다:

• 두 개 이상의 기간으로 구분된 레이블로 구성됩니다
  • 도메인 이름의 각 부분은 “레이블”이라고 합니다. 예를 들어, 도메인 이름 “example.com”은 “example” 레이블과 “com” 레이블로 구성됩니다.
• 적어도 하나의 마침표(.)를 포함해야 합니다
• 두 개 이상의 연속된 마침표를 포함할 수 없습니다
• 각 기간별 레이블은 다음을 충족해야 합니다:
  • 알파벳 숫자(a-z 또는 0-9)와 하이픈(-)만 포함해야 합니다.
  • 알파벳 문자(a-z) 또는 숫자(0-9)로 시작
  • 알파벳 또는 숫자 문자(a-z 또는 0-9)로 끝납니다
  • 1에서 63자 사이로 포함

추가 검증 필요

도메인의 마지막 레이블은 최종 마침표(.) 이후의 모든 것에 의해 결정되는 유효한 최상위 도메인(TLD)이어야 합니다. 이 TLD는 ICANN의 TLD 목록에 나타나야 합니다. Braze 검증기는 구문만 확인합니다. 오타나 존재하지 않는 주소는 잡지 않습니다.