Amazon Simple Email Service
개발자 안내서

사용자 지정 확인 이메일 템플릿 사용

이메일 주소 확인을 시도하면 Amazon SES가 다음 이미지에 표시된 예와 비슷한 해당 주소로 이메일을 전송합니다.

많은 Amazon SES 고객은 자체 고객을 대신하여 Amazon SES를 통해 이메일을 보내는 애플리케이션(예: 이메일 마케팅 제품군 또는 티켓 시스템)을 빌드합니다. 이러한 애플리케이션의 최종 사용자의 경우 이메일 확인 프로세스가 혼동스러울 수 있습니다. 확인 이메일은 애플리케이션의 브랜드가 아니라 Amazon SES 브랜드를 사용하는데 그 최종 사용자가 Amazon SES 직접 사용을 등록한 적이 없습니다.

Amazon SES 사용 사례에서 고객이 이메일 주소를 Amazon SES에 사용할 수 있는지 확인해야 하는 경우 사용자 지정 확인 이메일을 생성할 수 있습니다. 이 사용자 지정 이메일은 고객의 혼란을 줄이고 고객이 등록 프로세스를 완료하는 비율을 높이는 데 도움이 될 수 있습니다.

사용자 지정 확인 이메일 템플릿 생성

사용자 지정 확인 이메일을 생성하려면 CreateCustomVerificationEmailTemplate API 작업을 사용합니다. 이 작업은 다음 입력을 사용합니다.

속성 설명
TemplateName 템플릿의 이름입니다. 지정하는 이름은 고유해야 합니다.
FromEmailAddress 확인 이메일이 전송된 이메일 주소입니다. 지정하는 주소 또는 도메인은 Amazon SES 계정에 사용할 수 있는지 확인해야 합니다.

참고

FromEmailAddress 속성은 표시 이름("대화명"이라고도 함)을 지원하지 않습니다.

TemplateSubject 확인 이메일의 제목 줄입니다.
TemplateContent 이메일의 본문입니다. 이메일 본문에는 특정 제한 사항이 있는 HTML이 포함될 수 있습니다. 자세한 내용은 사용자 지정 확인 이메일 FAQ 단원을 참조하십시오.
SuccessRedirectionURL 이메일 주소가 성공적으로 확인된 경우 사용자에게 전송되는 URL입니다.
FailureRedirectionURL 이메일 주소가 성공적으로 확인되지 않은 경우 사용자에게 전송되는 URL입니다.

AWS SDK 또는 AWS CLI를 사용하여 CreateCustomVerificationEmailTemplate 작업으로 사용자 지정 확인 이메일 템플릿을 생성할 수 있습니다. AWS SDK에 대해 자세히 알아보려면 Amazon Web Services 도구를 참조하십시오. AWS CLI에 대한 자세한 내용은 AWS 명령줄 인터페이스를 참조하십시오.

다음 단원에는 AWS CLI를 사용하여 사용자 지정 확인 이메일을 생성하는 절차가 포함되어 있습니다. 이 절차에서는 AWS CLI를 설치하고 구성한 것으로 가정합니다. AWS CLI 설치 및 구성에 대한 자세한 내용은 AWS Command Line Interface 사용 설명서를 참조하십시오.

참고

To complete the procedure in this section, you must use version 1.14.6 or later of the AWS CLI. For best results, upgrade to the latest version of the AWS CLI. For more information about updating the AWS CLI, see Installing the AWS Command Line Interface in the AWS Command Line Interface 사용 설명서.

  1. 텍스트 편집기에서 새로운 파일을 생성합니다. 다음 콘텐츠를 편집기에 붙여 넣습니다.

    { "TemplateName": "SampleTemplate", "FromEmailAddress": "sender@example.com", "TemplateSubject": "Please confirm your email address", "TemplateContent": "<html> <head></head> <body style="font-family:sans-serif;"> <h1 style="text-align:center">Ready to start sending email with ProductName?</h1> <p>We here at Example Corp are happy to have you on board! There's just one last step to complete before you can start sending email. Just click the following link to verify your email address. Once we confirm that you're really you, we'll give you some additional information to help you get started with ProductName.</p> </body> </html>", "SuccessRedirectionURL": "https://www.example.com/verifysuccess", "FailureRedirectionURL": "https://www.example.com/verifyfailure" }

    중요

    앞의 예를 이해하기 쉽도록 TemplateContent 속성에는 줄 바꿈이 포함되어 있습니다. 앞의 예를 텍스트 파일에 붙여 넣으면 진행하기 전에 줄 바꿈을 제거합니다.

    TemplateName, FromEmailAddress, TemplateSubject, TemplateContent, SuccessRedirectionURLFailureRedirectionURL 값을 사용자의 값으로 바꿉니다. 파일을 customverificationemail.json로 저장합니다.

  2. 명령줄에 다음 명령을 입력하여 사용자 지정 확인 이메일 템플릿을 생성합니다. aws ses create-custom-verification-email-template --cli-input-json file://customverificationemail.json

  3. 경우에 따라 다음 명령을 입력하여 템플릿이 생성되었는지 확인할 수 있습니다. aws ses list-custom-verification-email-templates

사용자 지정 확인 이메일 템플릿 편집

UpdateCustomVerificationEmailTemplate API 작업을 사용하여 사용자 지정 확인 이메일 템플릿을 편집할 수 있습니다. 이 작업은 CreateCustomVerificationEmailTemplate 작업과 같은 입력(즉 TemplateName, FromEmailAddress, TemplateSubject, TemplateContent, SuccessRedirectionURLFailureRedirectionURL 속성)을 허용합니다. 하지만 UpdateCustomVerificationEmailTemplate 작업의 경우 이 속성 중 아무것도 필요하지 않습니다. 기존 사용자 지정 확인 이메일 템플릿의 이름과 같은 TemplateName의 값을 전달하면 지정하는 속성이 원래 템플릿에 있던 속성을 덮어씁니다.

사용자 지정 템플릿을 사용하여 확인 이메일 전송

최소 하나의 사용자 지정 확인 이메일 템플릿을 생성한 후 SendCustomVerificationEmail API 작업을 호출하여 고객에게 전송할 수 있습니다. AWS SDK 또는 AWS CLI를 사용하여 SendCustomVerificationEmail 작업을 호출할 수 있습니다. SendCustomVerificationEmail 작업은 다음 입력을 사용합니다.

속성 설명
EmailAddress 확인 중인 이메일 주소입니다.
TemplateName 확인 중인 이메일 주소에 전송된 사용자 지정 확인 이메일 템플릿의 이름입니다.
ConfigurationSetName (선택) 확인 이메일을 보낼 때 사용하도록 설정된 구성의 이름입니다.

예를 들어 고객이 애플리케이션의 양식을 사용하여 서비스에 등록한다고 가정해 보겠습니다. 고객이 양식을 작성하여 제출하면 애플리케이션이 SendCustomVerificationEmail 작업을 호출하여 고객의 이메일 주소와 사용하려는 템플릿의 이름을 전달합니다.

고객은 사용자가 생성한 사용자 지정 이메일 템플릿을 사용하는 이메일을 수신합니다. Amazon SES는 자동으로 수신자에 고유 링크와 간략한 면책 조항을 추가합니다. 다음 이미지에는 사용자 지정 확인 이메일 템플릿 생성에서 생성된 템플릿을 사용하는 샘플 확인 이메일이 표시되어 있습니다.

사용자 지정 확인 이메일 FAQ

이 단원에는 사용자 지정 확인 이메일 템플릿 기능에 대한 FAQ 답변이 포함되어 있습니다.

Q1. 사용자 지정 확인 이메일 템플릿은 몇 개나 생성할 수 있나요?

Amazon SES 계정당 최대 50개의 사용자 지정 확인 이메일 템플릿을 생성할 수 있습니다.

Q2. 사용자 지정 확인 이메일은 수신자에게 어떻게 보이나요?

사용자 지정 확인 이메일에는 템플릿을 생성할 때 지정한 콘텐츠가 포함되어 있고 그 다음 수신자가 이메일 주소를 확인하기 위해 클릭해야 하는 링크가 있습니다.

Q3. 사용자 지정 확인 이메일을 미리 볼 수 있나요?

사용자 지정 확인 이메일을 미리 보려면 SendCustomVerificationEmail 작업을 사용하여 사용자가 소유하는 주소에 확인 이메일을 보냅니다. 확인 링크를 클릭하지 않으면 Amazon SES는 새 자격 증명을 생성하지 않습니다. 확인 링크를 클릭하면 선택적으로 DeleteIdentity 작업을 사용하여 새로 생성된 자격 증명을 삭제할 수 있습니다.

Q4. 사용자 지정 확인 이메일 템플릿에 이미지가 포함될 수 있나요?

Base64 인코딩을 사용하여 템플릿의 HTML에 이미지를 포함할 수 있습니다. 이런 방식으로 이미지를 포함하면 Amazon SES는 자동으로 첨부 문서로 변환합니다. 다음 명령 중 하나를 실행하여 명령줄에서 이미지를 인코딩할 수 있습니다.

  • Linux, macOS, or Unix: base64 -i imagefile.png | tr -d '\n' > output.txt

  • Windows: certutil -encode imagefile.png output.tmp && findstr /v /c:- output.tmp > output.txt && del output.tmp

imagefile.png를 인코딩할 파일의 이름으로 바꿉니다. 위 두 명령 모두 Base64 인코딩 이미지가 output.txt에 저장됩니다.

참고

Windows 명령줄을 사용하여 이미지를 인코딩한 경우 진행하기 전에 텍스트 편집기에 output.txt를 열고 파일에서 줄 바꿈을 제거해야 합니다.

템플릿의 HTML에 <img src="data:image/png;base64,base64EncodedImage"/>를 포함하여 Base64 인코딩 이미지를 포함할 수 있습니다.

위 예에서 png를 인코딩 이미지의 파일 유형(예: jpg 또는 gif)으로 바꾸고 base64EncodedImage를 Base64 인코딩 이미지(앞의 명령 중 하나 중 output.txt의 콘텐츠)로 바꿉니다.

Q5. 사용자 지정 확인 이메일 템플릿에 포함할 수 있는 콘텐츠에 제한이 있습니까?

사용자 지정 확인 이메일 템플릿은 크기가 10MB를 초과할 수 없습니다. 또한 침해를 방지할 수 있도록 HTML이 포함되는 사용자 지정 확인 이메일 템플릿은 다음 표에 나열된 태그와 속성만 사용할 수 있습니다.

HTML 태그 허용되는 속성
abbr class, id, style, title
acronym class, id, style, title
address class, id, style, title
area class, id, style, title
b class, id, style, title
bdo class, id, style, title
big class, id, style, title
blockquote cite, class, id, style, title
body class, id, style, title
br class, id, style, title
button class, id, style, title
caption class, id, style, title
center class, id, style, title
cite class, id, style, title
code class, id, style, title
col class, id, span, style, title, width
colgroup class, id, span, style, title, width
dd class, id, style, title
del class, id, style, title
dfn class, id, style, title
dir class, id, style, title
div class, id, style, title
dl class, id, style, title
dt class, id, style, title
em class, id, style, title
fieldset class, id, style, title
font class, id, style, title
form class, id, style, title
h1 class, id, style, title
h2 class, id, style, title
h3 class, id, style, title
h4 class, id, style, title
h5 class, id, style, title
h6 class, id, style, title
head class, id, style, title
hr class, id, style, title
html class, id, style, title
i class, id, style, title
img align, alt, class, height, id, src, style, title, width
input class, id, style, title
ins class, id, style, title
kbd class, id, style, title
label class, id, style, title
legend class, id, style, title
li class, id, style, title
map class, id, style, title
menu class, id, style, title
ol class, id, start, style, title, type
optgroup class, id, style, title
option class, id, style, title
p class, id, style, title
pre class, id, style, title
q cite, class, id, style, title
s class, id, style, title
samp class, id, style, title
select class, id, style, title
small class, id, style, title
span class, id, style, title
strike class, id, style, title
strong class, id, style, title
sub class, id, style, title
sup class, id, style, title
table class, id, style, summary, title, width
tbody class, id, style, title
td abbr, axis, class, colspan, id, rowspan, style, title, width
textarea class, id, style, title
tfoot class, id, style, title
th abbr, axis, class, colspan, id, rowspan, scope, style, title, width
thead class, id, style, title
tr class, id, style, title
tt class, id, style, title
u class, id, style, title
ul class, id, style, title, type
var class, id, style, title

Q6. 계정에 확인된 이메일 주소가 몇 개 존재할 수 있나요?

Amazon SES 계정은 각 AWS 리전에서 최대 10,000개의 확인된 자격 증명이 포함될 수 있습니다. Amazon SES는 자격 증명에 확인된 도메인과 이메일 주소가 모두 포함됩니다. 자체 이메일을 전송하는 확인된 도메인 또는 이메일 주소가 있는 경우 해당 자격 증명은 10,000개의 자격 증명 한도에 포함됩니다.

Q7. Amazon SES 콘솔을 사용하여 사용자 지정 확인 이메일 템플릿을 생성할 수 있나요?

현재는 Amazon SES API를 사용해야만 사용자 지정 확인 이메일을 생성, 편집 및 삭제할 수 있습니다.

Q8. 고객이 사용자 지정 확인 이메일을 수신할 때 일어나는 열기 및 클릭 이벤트를 추적할 수 있나요?

사용자 지정 확인 이메일에는 열기 또는 클릭 추적이 포함될 수 없습니다.

Q9. 사용자 지정 확인 이메일에 사용자 지정 헤더가 포함될 수 있나요?

사용자 지정 확인 이메일에는 사용자 지정 헤더가 포함될 수 없습니다.

Q10. 사용자 지정 확인 이메일 하단에 표시되는 텍스트를 제거할 수 있나요?

다음 텍스트는 모든 사용자 지정 확인 이메일의 끝 부분에 자동으로 추가되고 제거할 수 없습니다.

이 이메일 주소의 확인을 요청하지 않은 경우 이 메시지를 무시하십시오. 우려 사항이 있는 경우 이 메시지를 질문 또는 의견과 함께 다음 이메일 주소로 전달하십시오.

이 텍스트의 이메일 주소 링크는 Amazon SES 팀이 활발히 모니터링하는 받은 편지함인 ses-review@amazon.com을 나타냅니다.

Q11. 사용자 지정 확인 이메일은 DKIM으로 서명하나요?

확인 이메일에 DKIM으로 서명하려면 확인 이메일 템플릿을 생성할 때 FromEmailAddress 속성에서 지정하는 이메일 주소가 DKIM 서명을 생성하도록 구성되어야 합니다. 도메인 및 이메일 주소에 대한 DKIM 설정에 대한 자세한 내용은 Amazon SES에서 DKIM을 사용하여 이메일 인증을 참조하십시오.

Q12. 사용자 지정 확인 이메일 템플릿 API 작업이 SDK 또는 CLI에 나타나지 않는 이유는 무엇입니까?

SDK 또는 AWS CLI에서 사용자 지정 확인 이메일 템플릿 작업을 사용할 수 없는 경우 오래된 버전의 SDK 또는 CLI를 사용하고 있는 것일 수 있습니다. 사용자 지정 확인 이메일 템플릿 작업은 다음 SDK 및 CLI에서 사용할 수 있습니다.

  • AWS Command Line Interface 버전 1.14.6 이상

  • .NET용 AWS SDK 버전 3.3.205.0 이상

  • C++용 AWS SDK 버전 1.3.20170531.19 이상

  • Go용 AWS SDK 버전 1.12.43 이상

  • AWS SDK for Java 버전 1.11.245 이상

  • AWS SDK for JavaScript 버전 2.166.0 이상

  • PHP용 AWS SDK 버전 3.45.2 이상

  • AWS SDK for Python (Boto) 버전 1.5.1 이상

  • Ruby용 AWS SDK에서는 aws-sdk-ses Gem 버전 1.5.0 이상