Integrate Amazon SES Notifications

개요

파일 전송 작업의 상태 변화를 이메일로 전달받으려면 Amazon SES 알림을 연동할 수 있습니다.

연동을 완료하면 전송이 시작(Started), 완료(Completed), 실패(Failed) 되는 등 지정한 이벤트가 발생할 때마다 지정한 수신 이메일로 알림 메일이 자동으로 전송됩니다.

전체 과정은 ① AWS 자격 증명 발급 → ② 발신 이메일 인증 → ③ 제품에서 알림 설정 순으로 진행됩니다.

준비 사항

시작하기 전에 다음 사항을 확인하세요.

AWS 자격 증명(Access Key) 발급

Amazon SES를 통해 이메일을 발송하려면 SES 발송 권한이 있는 AWS 자격 증명(Access Key / Secret Access Key)이 필요합니다.

IAM에서 사용자와 액세스 키를 생성합니다.

Step 1. IAM 사용자 준비 및 권한 부여

AWS Console에서 IAM → Users로 이동하여 새로운 사용자를 생성하거나 기존 사용자를 선택합니다.

Amazon SES 발송 권한(ses:SendEmail, ses:SendRawEmail)이 포함된 정책 또는 AmazonSESFullAccess 정책을 연결합니다.

운영 환경에서는 최소 권한 원칙에 따라 필요한 권한만 부여하는 것을 권장합니다.

Step 2. 액세스 키 생성

사용자의 Security credentials 탭에서 Create access key를 선택합니다.

사용 사례는 Application running outside AWS를 선택한 후 액세스 키를 생성합니다.

Step 3. Access Key 및 Secret Access Key 복사

생성된 Access Key ID와 Secret Access Key를 복사합니다.

Secret Access Key는 생성 시 한 번만 확인할 수 있으므로 안전한 위치에 보관합니다.

이 정보는 비밀번호와 동일한 수준의 보안이 필요하며 외부에 노출되어서는 안 됩니다.

유출된 경우 IAM에서 해당 키를 비활성화하거나 삭제한 후 새로 발급합니다.

확인 사항

• ✔ Amazon SES 발송 권한이 부여되었습니다.
• ✔ Access Key ID와 Secret Access Key를 복사했습니다.

발신 이메일 인증 및 발송 조건 확인

Amazon SES에서는 인증된 이메일 또는 도메인만 발신자로 사용할 수 있습니다.

Step 1. AWS Region 선택

Amazon SES Console 우측 상단에서 사용할 Region을 선택합니다.

예:

발신자 인증과 메일 발송은 모두 동일한 Region에서 수행되어야 합니다.

Step 2. 발신 이메일 인증

Amazon SES Console에서 Identities → Create identity를 선택합니다.

발신에 사용할 이메일 또는 도메인을 등록한 후 인증을 완료합니다.

• 이메일 인증은 수신된 확인 메일의 링크를 클릭하여 완료합니다.
• 도메인 인증은 안내된 DNS 레코드를 등록하여 완료합니다.

Step 3. Sandbox 상태 확인

새로운 Amazon SES 계정은 기본적으로 Sandbox 상태입니다.

Sandbox에서는 다음 제한이 적용됩니다.

• 인증된 수신자에게만 메일 발송 가능
• 하루 최대 200통
• 초당 최대 1통 발송

운영 환경에서 일반 사용자에게 메일을 보내려면 Request production access를 신청하여 Sandbox를 해제해야 합니다.

확인 사항

• ✔ 사용할 Region을 확인했습니다.
• ✔ 발신 이메일(또는 도메인)이 인증되었습니다.
• ✔ Sandbox 여부 및 발송 조건을 확인했습니다.

Amazon SES 알림 설정

발급받은 AWS 자격 증명과 인증된 이메일 정보를 제품의 알림 설정에 입력합니다.

Notifications 설정 창을 열면 아래와 같은 화면이 표시됩니다.

Step 1. Access Key 입력

Access Key 항목에 생성한 Access Key ID를 입력합니다.

Step 2. Secret Key 입력

Secret Key 항목에 생성한 Secret Access Key를 입력합니다.

Step 3. Region 입력

Region 항목에 선택한 Region을 입력합니다.

예:

발신자를 인증한 Region과 동일해야 합니다.

Step 4. From Email 입력

From Email 항목에 인증된 발신 이메일 주소를 입력합니다.

Step 5. To Email 입력

To Email 항목에 알림을 받을 수신 이메일 주소를 입력합니다.

Amazon SES 계정이 Sandbox 상태인 경우 이 이메일도 인증되어 있어야 합니다.

Step 6. 알림 이벤트 선택

Events 항목에서 알림을 받을 이벤트를 선택합니다.

여러 개를 선택할 수 있으며 선택한 이벤트가 발생할 때만 이메일이 발송됩니다.

Step 7. 설정 저장

입력을 완료한 후 Add를 클릭하여 연동을 저장합니다.

확인 사항

• ✔ Access Key와 Secret Key가 입력되었습니다.
• ✔ Region과 발신/수신 이메일이 입력되었습니다.
• ✔ 알림받을 이벤트가 선택되었습니다.

연동 확인

설정이 정상적으로 동작하는지 확인합니다.

Step 1. 테스트 이벤트 발생

실제 전송 작업을 실행하거나 선택한 이벤트 중 하나를 발생시킵니다.

Step 2. 수신 메일함 확인

지정한 이메일 주소로 알림 메일이 도착했는지 확인합니다.

확인 사항

• ✔ 수신 이메일로 알림 메일이 도착했습니다.
• ✔ 발생한 이벤트가 정확하게 전달되었습니다.

설정 완료

설정을 저장하면 연동이 적용됩니다.

이후 선택한 이벤트가 발생할 때마다 지정한 수신 이메일로 알림 메일이 자동으로 전송됩니다.

문제 해결 (Troubleshooting)

메일이 도착하지 않는 경우 아래 항목을 확인하세요.