이메일 유효성 검사

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

작동 방식

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

Braze는 특정 문자를 거부하고 해당 주소를 유효하지 않은 것으로 표시합니다. 이메일이 반송되면 Braze는 해당 주소를 유효하지 않은 것으로 표시하며, 가입 상태는 변경하지 않습니다. 이메일 본문에 비표준 ASCII 문자가 포함되어 있으면 Braze는 이메일을 보내지 않습니다.

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

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

중요

도메인 부분에 비표준 ASCII 문자가 포함되어 있는 경우, Braze에 제공하기 전에 퓨니코드로 인코딩해야 합니다.

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

로컬 파트 유효성 검사 규칙

일반 이메일 유효성 검사

대부분의 도메인에서 로컬 파트는 다음 조건을 따라야 합니다.

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

참고

Braze는 대문자를 소문자로 변환하고 앞뒤 공백을 제거하여 이메일 주소를 정규화합니다. 이 정규화는 API, CSV 업로드, SDK 또는 대시보드를 통해 이메일 주소를 생성하거나 업데이트할 때 적용됩니다.

다음 정규표현식을 사용하여 이메일 주소가 유효한 것으로 간주되는지 확인할 수 있습니다.

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인 경우, 로컬 파트는 최소 2자 이상이어야 하며 이 섹션 앞부분에 나온 정규표현식 유효성 검사를 따라야 합니다.

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 유효성 검사기는 구문만 확인합니다. 오타나 존재하지 않는 주소는 감지하지 않습니다.

중요

유니코드는 이메일 주소의 로컬 부분에서만 허용됩니다. 도메인 부분에서는 유니코드가 허용되지 않지만, 퓨니코드(Punycode)로 인코딩할 수는 있습니다.