Amazon SES 이메일 수신에 대한 알림 내용 - Amazon Simple Email Service

Amazon SES 이메일 수신에 대한 알림 내용

이메일 수신에 대한 모든 알림은 Amazon Simple Notification Service(Amazon SNS) 주제에 JavaScript Object Notation(JSON) 형식으로 게시됩니다.

알림 예는 알림 예제 단원을 참조하십시오.

최상위 JSON 객체

최상위 JSON 객체는 다음 필드로 구성됩니다.

필드 이름 설명
notificationType

알림 유형입니다. 이 유형의 알림의 경우 값은 항상 Received입니다.

receipt

이메일 전송 관련 정보가 포함된 객체

mail

알림과 연결된 이메일 관련 정보를 포함하는 객체입니다.

content

일반적으로 다목적 인터넷 전자 우편(MIME) 형식으로 작성된 수정되지 않은 원본 이메일이 포함된 문자열입니다. MIME 형식에 대한 자세한 내용은 RFC 2045를 참조하세요.

참고

이 필드는 SNS 작업에 의해 알림이 트리거된 경우에만 표시됩니다. 다른 모든 작업에 의해 트리거된 알림에는 이 필드가 포함되지 않습니다.

수신 객체

receipt 객체에는 다음 필드가 있습니다.

필드 이름 설명

action

실행된 작업에 대한 정보를 캡슐화하는 객체입니다. 가능한 값 목록은 작업 객체 단원을 참조하십시오.

dkimVerdict

DomainKeys Identified Mail(DKIM) 검사를 통과했는지 여부를 나타내는 객체입니다. 가능한 값 목록은 dkimVerdict 객체 단원을 참조하십시오.

dmarcPolicy

발신 도메인에 대한 Domain-based Message Authentication, Reporting & Conformance(DMARC) 설정을 나타냅니다. 이 필드는 메시지가 DMARC 인증에 실패한 경우에만 나타납니다.

이 필드에 가능한 값은 다음과 같습니다.

  • none: 발신 도메인의 소유자가 DMARC 인증에 실패한 메시지에 대해 특정 작업을 수행하도록 요청합니다.

  • quarantine: 발신 도메인의 소유자가 DMARC 인증에 실패한 메시지를 수신자가 의심스러운 것으로 처리하도록 요청합니다.

  • reject: 발신 도메인의 소유자가 DMARC 인증에 실패한 메시지를 거부하도록 요청합니다.

dmarcVerdict Domain-based Message Authentication, Reporting & Conformance(DMARC) 검사를 통과했는지 여부를 나타내는 객체입니다. 가능한 값 목록은 dmarcVerdict 객체 단원을 참조하십시오.
processingTimeMillis

Amazon SES가 메시지를 수신한 시간부터 작업을 트리거한 시간까지의 기간(밀리초)을 지정하는 문자열입니다.

recipients

활성 수신 규칙과 일치하는 수신자(특히 엔벌로프 RCPT TO 주소)입니다. 여기에 나열된 주소는 Mail 객체destination 필드에 나열된 주소와 다를 수 있습니다.

spamVerdict

메시지가 스팸인지 여부를 나타내는 객체입니다. 가능한 값 목록은 spamVerdict 객체 단원을 참조하십시오.

spfVerdict

Sender Policy Framework(SPF) 검사를 통과했는지 여부를 나타내는 객체입니다. 가능한 값 목록은 spfVerdict 객체 단원을 참조하십시오.

timestamp

작업이 트리거된 날짜와 시간을 ISO 8601 형식으로 지정하는 문자열입니다.

virusVerdict

메시지에 바이러스가 포함되어 있는지 여부를 나타내는 객체입니다. 가능한 값 목록은 virusVerdict 객체 단원을 참조하십시오.

작업 객체

action 객체에는 다음 필드가 있습니다.

필드 이름 설명
type

실행된 작업의 유형을 나타내는 문자열입니다. 가능한 값은 S3, SNS, Bounce, Lambda, Stop, WorkMail입니다.

topicArn

알림이 게시된 Amazon SNS 주제의 Amazon 리소스 이름(ARN)이 포함된 문자열입니다.

bucketName

메시지가 게시된 Amazon S3 버킷의 이름이 포함된 문자열입니다. S3 작업 유형에 대해서만 표시됩니다.

objectKey

Amazon S3 버킷의 이메일을 고유하게 식별하는 이름을 포함하는 문자열로, Mail 객체messageId와(과) 동일합니다. S3 작업 유형에 대해서만 표시됩니다.

smtpReplyCode

RFC 5321의 정의에 따르는 SMTP 응답 코드를 포함하는 문자열입니다. 반송 작업 유형에 대해서만 표시됩니다.

statusCode

RFC 3463의 정의에 따르는 향상된 SMTP 상태 코드를 포함하는 문자열입니다. 반송 작업 유형에 대해서만 표시됩니다.

message

반송 메시지에 포함할 사람이 읽을 수 있는 텍스트가 포함된 문자열입니다. 반송 작업 유형에 대해서만 표시됩니다.

sender

반송된 이메일 발신자의 이메일 주소가 포함된 문자열입니다. 반송 메시지를 보낼 때 사용한 주소입니다. 반송 작업 유형에 대해서만 표시됩니다.

functionArn

트리거된 Lambda 함수의 ARN을 포함하는 문자열입니다. Lambda 작업 유형에 대해서만 표시됩니다.

invocationType

Lambda 함수의 호출 유형을 포함하는 문자열입니다. 가능한 값은 RequestResponseEvent입니다. Lambda 작업 유형에 대해서만 표시됩니다.

organizationArn

Amazon WorkMail 조직의 ARN을 포함하는 문자열입니다. WorkMail 작업 유형에 대해서만 표시됩니다.

dkimVerdict 객체

dkimVerdict 객체에는 다음 필드가 있습니다.

필드 이름 설명
status

DKIM 판정이 포함된 문자열입니다. 가능한 값은 다음과 같습니다.

  • PASS: 메시지가 DKIM 인증을 통과했습니다.

  • FAIL: 메시지가 DKIM 인증에 실패했습니다.

  • GRAY: 메시지에 DKIM 서명이 없습니다.

  • PROCESSING_FAILED: Amazon SES가 DKIM 서명을 확인하지 못하는 문제가 있습니다. 예를 들어 DNS 쿼리가 실패하거나 DKIM 서명 헤더가 제대로 포맷되지 않았습니다.

dmarcVerdict 객체

dmarcVerdict 객체에는 다음 필드가 있습니다.

필드 이름 설명
status

DMARC 판정이 포함된 문자열입니다. 가능한 값은 다음과 같습니다.

  • PASS: 메시지가 DMARC 인증을 통과했습니다.

  • FAIL: 메시지가 DMARC 인증에 실패했습니다.

  • GRAY: SPF 또는 DKIM 중 하나 이상이 인증을 통과했지만 전송 도메인에 DMARC 정책이 없거나 p=none 정책을 사용합니다.

  • PROCESSING_FAILED: Amazon SES가 DMARC 판정을 제공하지 못하는 문제가 있습니다.

spamVerdict 객체

spamVerdict 객체에는 다음 필드가 있습니다.

필드 이름 설명
status

스팸 검사 결과가 포함된 문자열입니다. 가능한 값은 다음과 같습니다.

  • PASS: 스팸 검사에서 메시지에 스팸이 포함될 가능성이 낮은 것으로 확인되었습니다.

  • FAIL: 스팸 검사에서 메시지에 스팸이 포함될 가능성이 높은 것으로 확인되었습니다.

  • GRAY: Amazon SES가 이메일을 스캔했지만 스팸인지 여부를 확인할 수 없습니다.

  • PROCESSING_FAILED: Amazon SES가 이메일을 스캔할 수 없습니다. 예를 들어, 이메일은 유효한 MIME 메시지가 아닙니다.

spfVerdict 객체

spfVerdict 객체에는 다음 필드가 있습니다.

필드 이름 설명
status

SPF 판정이 포함된 문자열입니다. 가능한 값은 다음과 같습니다.

  • PASS: 메시지가 SPF 인증을 통과했습니다.

  • FAIL: 메시지가 SPF 인증에 실패했습니다.

  • GRAY: MAIL FROM 명령에 사용되는 도메인 아래에 SPF 정책이 없습니다.

  • PROCESSING_FAILED: Amazon SES가 SPF 서명을 확인하지 못하는 문제가 있습니다. 예를 들어 DNS 쿼리가 실패합니다.

virusVerdict 객체

virusVerdict 객체에는 다음 필드가 있습니다.

필드 이름 설명
status

바이러스 검사 결과가 포함된 문자열입니다. 가능한 값은 다음과 같습니다.

  • PASS: 메시지에 바이러스가 포함되어 있지 않습니다.

  • FAIL: 메시지에 바이러스가 포함되어 있습니다.

  • GRAY: Amazon SES가 이메일을 스캔했지만 바이러스 포함 여부를 확인할 수 없습니다.

  • PROCESSING_FAILED: Amazon SES가 이메일의 내용을 스캔할 수 없습니다. 예를 들어, 이메일은 유효한 MIME 메시지가 아닙니다.

Mail 객체

mail 객체에는 다음 필드가 있습니다.

필드 이름 설명
destination

수신 이메일의 MIME 헤더의 모든 수신자 주소(To: 및 CC: 수신자 포함)의 전체 목록입니다.

messageId

Amazon SES에서 이메일에 할당한 고유 ID가 포함된 문자열입니다. 이메일이 Amazon S3로 전송된 경우 메시지 ID는 Amazon S3 버킷에 메시지를 쓰는 데 사용된 Amazon S3 객체 키이기도 합니다.

source

이메일을 보낸 주소(특히 엔벌로프 MAIL FROM 주소)가 포함된 문자열입니다.

timestamp

ISO8601 포멧으로 이메일 수신 시간이 포함된 문자열입니다.

headers

Amazon SES 헤더 및 사용자 지정 헤더입니다. 각 헤더에는 namevalue 필드가 있습니다.

commonHeaders

모든 이메일에 공통적인 헤더입니다. 각 헤더에는 namevalue 필드가 있습니다.

headersTruncated

알림에서 헤더가 잘렸는지 여부를 나타내며 헤더의 용량이 10KB를 초과할 경우 헤더가 잘립니다. 가능한 값은 truefalse입니다.

commonHeaders 객체

commonHeaders 객체는 다음 표에 있는 필드를 가질 수 있습니다. 이 객체에 있는 필드는 수신 이메일에 있는 필드에 따라 다릅니다.

필드 이름 설명
messageId

원본 메시지의 ID입니다.

date

Amazon SES가 메시지를 수신한 날짜와 시간입니다.

to

이메일의 To 헤더입니다.

cc

이메일의 CC 헤더입니다.

bcc

이메일의 BCC 헤더입니다.

from

이메일의 From 헤더입니다.

sender

이메일의 Sender 헤더입니다.

returnPath

이메일의 Return-Path 헤더입니다.

replyTo

이메일의 Reply-To 헤더입니다.

subject

이메일의 Subject 헤더입니다.