기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon SES 이메일 수신에 대한 알림 내용 이메일 수신에 대한 모든 알림은 Amazon Simple Notification Service(Amazon SNS) 주제에 JavaScript Object Notation(JSON) 형식으로 게시됩니다. 알림 예는 [알림 예제](receiving-email-notifications-examples.md) 단원을 참조하세요. **Contents** + [최상위 JSON 객체](#receiving-email-notifications-contents-top-level-json-object) + [수신 객체](#receiving-email-notifications-contents-receipt-object) + [작업 객체](#receiving-email-notifications-contents-action-object) + [dkimVerdict 객체](#receiving-email-notifications-contents-dkimverdict-object) + [dmarcVerdict 객체](#receiving-email-notifications-contents-dmarcverdict-object) + [spamVerdict 객체](#receiving-email-notifications-contents-spamverdict-object) + [spfVerdict 객체](#receiving-email-notifications-contents-spfverdict-object) + [virusVerdict 객체](#receiving-email-notifications-contents-virusverdict-object) + [Mail 객체](#receiving-email-notifications-contents-mail-object) + [commonHeaders 객체](#receiving-email-notifications-contents-mail-object-commonHeaders) ## 최상위 JSON 객체 최상위 JSON 객체는 다음 필드로 구성됩니다. | 필드 이름 | 설명 | | --- | --- | | notificationType | 알림 유형입니다. 이 유형의 알림의 경우 값은 항상 `Received`입니다. | | [`receipt`](#receiving-email-notifications-contents-receipt-object) | 이메일 전송 관련 정보가 포함된 객체 | | [`mail`](#receiving-email-notifications-contents-mail-object) | 알림과 연결된 이메일 관련 정보를 포함하는 객체입니다. | | content | 일반적으로 다목적 인터넷 전자 우편(MIME) 형식으로 작성된 수정되지 않은 원본 이메일이 포함된 문자열입니다. MIME 형식에 대한 자세한 내용은 [RFC 2045](https://tools.ietf.org/html/rfc2045)를 참조하세요. 이 필드는 SNS 작업에 의해 알림이 트리거된 경우에만 표시됩니다. 다른 모든 작업에 의해 트리거된 알림에는 이 필드가 포함되지 않습니다. | ## 수신 객체 `receipt` 객체에는 다음 필드가 있습니다. | 필드 이름 | 설명 | | --- | --- | | [`action`](#receiving-email-notifications-contents-action-object) | 실행된 작업에 대한 정보를 캡슐화하는 객체입니다. 가능한 값 목록은 [작업 객체](#receiving-email-notifications-contents-action-object) 단원을 참조하세요. | | [`dkimVerdict`](#receiving-email-notifications-contents-dkimverdict-object) | DomainKeys Identified Mail(DKIM) 검사를 통과했는지 여부를 나타내는 객체입니다. 가능한 값 목록은 [dkimVerdict 객체](#receiving-email-notifications-contents-dkimverdict-object) 단원을 참조하세요. | | dmarcPolicy | 발신 도메인에 대한 Domain-based Message Authentication, Reporting & Conformance(DMARC) 설정을 나타냅니다. 이 필드는 메시지가 DMARC 인증에 실패한 경우에만 나타납니다.
이 필드에 가능한 값은 다음과 같습니다.+ `none`: 발신 도메인의 소유자가 DMARC 인증에 실패한 메시지에 대해 특정 작업을 수행하도록 요청합니다.
+ `quarantine`: 발신 도메인의 소유자가 DMARC 인증에 실패한 메시지를 수신자가 의심스러운 것으로 처리하도록 요청합니다.
+ `reject`: 발신 도메인의 소유자가 DMARC 인증에 실패한 메시지를 거부하도록 요청합니다. | | [`dmarcVerdict`](#receiving-email-notifications-contents-dmarcverdict-object) | Domain-based Message Authentication, Reporting & Conformance(DMARC) 검사를 통과했는지 여부를 나타내는 객체입니다. 가능한 값 목록은 [dmarcVerdict 객체](#receiving-email-notifications-contents-dmarcverdict-object) 단원을 참조하세요. | | processingTimeMillis | Amazon SES가 메시지를 수신한 시간부터 작업을 트리거한 시간까지의 기간(밀리초)을 지정하는 문자열입니다. | | recipients | 활성 [수신 규칙](receiving-email-receipt-rules-console-walkthrough.md)과 일치하는 수신자(특히 엔벌로프 RCPT TO 주소)입니다. 여기에 나열된 주소는 [Mail 객체](#receiving-email-notifications-contents-mail-object)의 `destination` 필드에 나열된 주소와 다를 수 있습니다. | | [`spamVerdict`](#receiving-email-notifications-contents-spamverdict-object) | 메시지가 스팸인지 여부를 나타내는 객체입니다. 가능한 값 목록은 [spamVerdict 객체](#receiving-email-notifications-contents-spamverdict-object) 단원을 참조하세요. | | [`spfVerdict`](#receiving-email-notifications-contents-spfverdict-object) | Sender Policy Framework(SPF) 검사를 통과했는지 여부를 나타내는 객체입니다. 가능한 값 목록은 [spfVerdict 객체](#receiving-email-notifications-contents-spfverdict-object) 단원을 참조하세요. | | timestamp | 작업이 트리거된 날짜와 시간을 [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) 형식으로 지정하는 문자열입니다. | | [virusVerdict](#receiving-email-notifications-contents-virusverdict-object) | 메시지에 바이러스가 포함되어 있는지 여부를 나타내는 객체입니다. 가능한 값 목록은 [virusVerdict 객체](#receiving-email-notifications-contents-virusverdict-object) 단원을 참조하세요. | ### 작업 객체 `action` 객체에는 다음 필드가 있습니다. | 필드 이름 | 설명 | | --- | --- | | type | 실행된 작업의 유형을 나타내는 문자열입니다. 가능한 값은 `S3`, `SNS`, `Bounce`, `Lambda`, `Stop`, `WorkMail`입니다. | | topicArn | 알림이 게시된 Amazon SNS 주제의 Amazon 리소스 이름(ARN)이 포함된 문자열입니다. | | bucketName | 메시지가 게시된 Amazon S3 버킷의 이름이 포함된 문자열입니다. S3 작업 유형에 대해서만 표시됩니다. | | objectKey | Amazon S3 버킷의 이메일을 고유하게 식별하는 이름을 포함하는 문자열로, [Mail 객체](#receiving-email-notifications-contents-mail-object)의 `messageId`와(과) 동일합니다. S3 작업 유형에 대해서만 표시됩니다. | | smtpReplyCode | [RFC 5321](https://tools.ietf.org/html/rfc5321)의 정의에 따르는 SMTP 응답 코드를 포함하는 문자열입니다. 반송 작업 유형에 대해서만 표시됩니다. | | statusCode | [RFC 3463](https://tools.ietf.org/html/rfc3463)의 정의에 따르는 향상된 SMTP 상태 코드를 포함하는 문자열입니다. 반송 작업 유형에 대해서만 표시됩니다. | | message | 반송 메시지에 포함할 사람이 읽을 수 있는 텍스트가 포함된 문자열입니다. 반송 작업 유형에 대해서만 표시됩니다. | | sender | 반송된 이메일 발신자의 이메일 주소가 포함된 문자열입니다. 반송 메시지를 보낼 때 사용한 주소입니다. 반송 작업 유형에 대해서만 표시됩니다. | | functionArn | 트리거된 Lambda 함수의 ARN을 포함하는 문자열입니다. Lambda 작업 유형에 대해서만 표시됩니다. | | invocationType | Lambda 함수의 호출 유형을 포함하는 문자열입니다. 가능한 값은 `RequestResponse` 및 `Event`입니다. Lambda 작업 유형에 대해서만 표시됩니다. | | organizationArn | Amazon WorkMail 조직의 ARN을 포함하는 문자열입니다. WorkMail 작업 유형에 대해서만 표시됩니다. | ### dkimVerdict 객체 `dkimVerdict` 객체에는 다음 필드가 있습니다. | 필드 이름 | 설명 | | --- | --- | | status | DKIM 판정이 포함된 문자열입니다. 가능한 값은 다음과 같습니다.+ `PASS`: 메시지가 DKIM 인증을 통과했습니다.
+ `FAIL`: 메시지가 DKIM 인증에 실패했습니다.
+ `GRAY`: 메시지에 DKIM 서명이 없거나 발신 도메인과 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`: SPF 결과는`none`, `softfail`, 또는 `neutral`입니다.
+ `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 헤더 및 사용자 지정 헤더입니다. 각 헤더에는 `name` 및 `value` 필드가 있습니다. | | [`commonHeaders`](#receiving-email-notifications-contents-mail-object-commonHeaders) | 모든 이메일에 공통적인 헤더입니다. 각 헤더에는 `name` 및 `value` 필드가 있습니다. | | headersTruncated | 알림에서 헤더가 잘렸는지 여부를 나타내며 헤더의 용량이 10KB를 초과할 경우 헤더가 잘립니다. 가능한 값은 `true` 및 `false`입니다. | ### 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 헤더입니다. |