Amazon SES를 사용하여 단일 이메일 주소로 여러 AWS 계정 등록 - AWS 권장 가이드
요약사전 조건 및 제한 사항아키텍처도구에픽문제 해결관련 리소스추가 정보

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon SES를 사용하여 단일 이메일 주소로 여러 AWS 계정 등록

작성자: 조 워즈니악(AWS) 및 슈방기 비슈와카르마(AWS)

코드 리포지토리: GitHub aws-account-factory-email

환경: PoC 또는 파일럿

기술: 인프라, 관리 및 거버넌스, 메시징 및 통신

AWS 서비스: AWS Lambda, Amazon SES, Amazon DynamoDB

요약

이 패턴은 실제 이메일 주소를 AWS 계정과 연결된 이메일 주소에서 분리하는 방법을 설명합니다. AWS 계정은 계정 생성 시 고유한 이메일 주소를 제공해야 합니다. 일부 조직에서는 AWS 계정을 관리하는 팀이 메시징 팀과 함께 많은 고유한 이메일 주소를 관리해야 합니다. 이는 여러 AWS 계정을 관리하는 대규모 조직에서는 어려울 수 있습니다.

이 패턴은 AWS 계정 소유자가 하나의 이메일 주소를 여러 AWS 계정과 연결할 수 있는 고유한 이메일 주소 벤딩 솔루션을 제공합니다. 그러면 AWS 계정 소유자의 실제 이메일 주소가 테이블의 생성된 이메일 주소와 연결됩니다. 이 솔루션은 고유한 이메일 계정에 대해 수신되는 모든 이메일을 처리하고, 각 계정의 소유자를 조회한 다음, 수신된 모든 메시지를 소유자에게 전달합니다. 

사전 조건 및 제한 사항

사전 조건 

  • AWS 계정에 대한 관리 액세스가 필요합니다.

  • 개발 환경에 대한 액세스가 필요합니다. 필요한 도구와 액세스 키를 직접 설정하지 않아도 되도록 AWS Cloud9를 사용하는 것이 좋습니다.

  • (선택 사항) AWS Cloud Development Kit(AWS CDK) 워크플로우와 Python 프로그래밍 언어에 익숙하면 문제를 해결하거나 수정하는 데 도움이 됩니다.

제한 사항

  • 벤딩되는 전체 이메일 주소 길이는 64자입니다. 자세한 내용은 AWS CreateAccountOrganizations API 레퍼런스를 참조하십시오.

제품 버전

  • Node.js 버전 12.7.0 이상

  • Python 3.9 이상

  • Python 패키지 pip 및 virtualenv

  • AWS CDK 버전 2.23.0 이상

  • Docker 20.10.x 이상

아키텍처

대상 기술 스택

  • AWS CloudFormation 스택

  • AWS Lambda 함수

  • Amazon Simple Email Service(Amazon SES) 규칙 및 규칙 세트

  • AWS Identity and Access Management(IAM) 역할 및 정책

  • Amazon Simple Storage Service(S3) 버킷 및 버킷 정책

  • AWS Key Management Service(AWS KMS) 키 및 키 정책

  • Amazon Simple Notification Service(SNS) 주제 및 주제 정책

  • Amazon DynamoDB 테이블

대상 아키텍처 

단일 이메일 주소로 여러 AWS 계정을 등록하기 위한 대상 아키텍처

이 다이어그램은 두 가지 흐름을 보여줍니다.

  • 이메일 주소 벤딩 흐름: 다이어그램에서 이메일 주소 벤딩 흐름(하단 섹션)은 일반적으로 계정 벤딩 솔루션 또는 외부 자동화로 시작되거나 수동으로 호출됩니다. 요청 시 필요한 메타데이터가 포함된 페이로드와 함께 Lambda 함수가 호출됩니다. 함수는 이 정보를 사용하여 고유한 계정 이름과 이메일 주소를 생성하고 DynamoDB 데이터베이스에 저장한 다음 호출자에게 값을 반환합니다. 그런 다음 이 값을 사용하여 새 AWS 계정을 만들 수 있습니다(일반적으로 AWS Organizations 사용).

  • 이메일 전달 흐름: 이 흐름은 이전 다이어그램의 위쪽 섹션에 설명되어 있습니다. 이메일 주소 벤딩 흐름에서 생성된 계정 이메일을 사용하여 AWS 계정을 생성하면 AWS는 계정 등록 확인, 정기 알림 등 다양한 이메일을 해당 이메일 주소로 보냅니다. 이 패턴의 단계에 따라 전체 도메인에 대한 이메일을 수신하도록 Amazon SES로 AWS 계정을 구성합니다. 이 솔루션은 Lambda가 모든 수신 이메일을 처리하고, TO 주소가 DynamoDB 테이블에 있는지 확인한 다음, 대신 메시지를 계정 소유자의 이메일 주소로 전달하도록 하는 전달 규칙을 구성합니다. 이 프로세스를 사용하면 계정 소유자가 여러 계정을 하나의 이메일 주소와 연결할 수 있습니다.

자동화 및 규모 조정

이 패턴은 AWS CDK를 사용하여 배포를 완전히 자동화합니다. 이 솔루션은 사용자 요구를 충족하기 위해 자동으로 확장하거나 그러도록 구성될 수 있는 AWS 관리형 서비스를 사용합니다. Lambda 함수는 확장 요구 사항을 충족하기 위해 추가 구성이 필요할 수 있습니다. 자세한 내용은 Lambda 설명서의 Lambda 함수 크기 조정을 참조하세요.

도구

서비스

  • AWS Cloud9는 소프트웨어를 코딩, 구축, 실행, 테스트 및 디버깅하는 데 도움이 되는 통합 개발 환경(IDE)입니다. 또한, 소프트웨어를 AWS 클라우드로 릴리스하는 데도 도움이 됩니다.

  • AWS는 AWS CloudFormation 리소스를 설정하고, 빠르고 일관되게 프로비저닝하고, AWS 계정 및 지역 전반의 수명 주기 전반에 걸쳐 리소스를 관리할 수 있도록 지원합니다.

  • AWS Command Line Interface(AWS CLI)는 명령줄 쉘에서 명령을 사용하여 AWS 서비스와 상호 작용할 수 있는 오픈 소스 도구입니다.

  • Amazon DynamoDB는 빠르고 예측 가능하고 확장 가능한 성능을 제공하는 완전 관리형 NoSQL 데이터베이스 서비스입니다.

  • AWS Identity and Access Management(IAM)를 사용하면 AWS 리소스를 사용하도록 인증받고 권한이 부여된 사용자를 통제함으로써 AWS 리소스에 대한 액세스를 안전하게 관리할 수 있습니다.

  • AWS Key Management Service(AWS KMS)를 사용하면 암호화 키를 생성하고 제어하여 데이터를 보호할 수 있습니다.

  • AWS Lambda는 서버를 프로비저닝하거나 관리할 필요 없이 코드를 실행하는 데 도움이 되는 컴퓨팅 서비스입니다. 필요할 때만 코드를 실행하며 자동으로 확장이 가능하므로 사용한 컴퓨팅 시간만큼만 비용을 지불합니다.

  • Amazon Simple Email Service(Amazon SES)를 사용하면 자신의 이메일 주소와 도메인을 사용하여 이메일을 보내고 받을 수 있습니다.

  • Amazon Simple Notification Service(Amazon SNS)를 사용하면 웹 서버 및 이메일 주소를 포함하여 게시자와 클라이언트 간의 메시지 교환을 조정하고 관리할 수 있습니다.

  • Amazon Simple Storage Service(S3)는 원하는 양의 데이터를 저장, 보호 및 검색하는 데 도움이 되는 클라우드 기반 객체 스토리지 서비스입니다.

배포에 필요한 도구

  • AWS 계정에 대한 AWS CLI 및 IAM 액세스 권한이 있는 개발 환경입니다. 자세한 내용은 관련 리소스 섹션의 링크를 참조하세요. 설정 프로세스를 간소화하려면 AWS Cloud9를 사용하는 것이 좋습니다. 

  • AWS Cloud9를 사용하는 경우 다음이 자동으로 구성됩니다.  AWS Cloud9를 사용하지 않기로 선택한 경우 다음을 설치해야 합니다.

    • AWS CDK에 대한 액세스 보안 인증을 구성하기 위한 AWS CLI입니다. 자세한 내용은 AWS CLI 설명서를 참조하세요.

    • Python 버전 3.9 이상

    • Python 패키지 pip 및 virtualenv

    • Node.js 버전 12.7.0 이상

    • AWS CDK 버전 2.23.0 이상

    • Docker 버전 20.10.x 이상

code

이 패턴의 코드는 GitHub AWS 어카운트 팩토리 이메일 리포지토리에서 제공됩니다.

에픽

작업설명필요한 기술

AWS 계정을 확인 또는 생성합니다.

이메일 솔루션을 배포하려면 전체 관리 액세스 권한이 있는 기존 또는 새 AWS 계정을 확인합니다.  

AWS 관리자, 클라우드 관리자

배포 환경을 설정합니다.

다음 단계에 따라 사용하기 쉬운 배포 환경을 구성하고 종속성을 설정합니다.

  1. AWS Cloud9 인스턴스를 전용 배포 환경으로 배포합니다. 지침은 AWS Cloud9 시작하기를 참조하세요.

  2. 다음 명령을 GitHub 사용하여 AWS 계정 팩토리 이메일 리포지토리 코드 베이스를 AWS Cloud9 인스턴스에 복제합니다.

    git clone https://github.com/aws-samples/aws-account-factory-email

  3. requirements.txt 파일(리포지토리의 루트 내)에서 aws-cdk-lib==(으)로 시작하는 줄을 사용자 환경에서 실행 중인 AWS CDK 버전과 일치하도록 업데이트합니다. 버전을 확인하려면 cdk --version 명령을 사용합니다.

AWS DevOps, 앱 개발자
작업설명필요한 기술

도메인을 식별 및 할당합니다.

이메일 전달 기능을 사용하려면 전용 도메인이 필요합니다. Amazon SES로 확인할 수 있는 도메인 또는 하위 도메인을 식별하고 할당합니다. 이 도메인은 이메일 전달 솔루션이 배포된 AWS 계정 내에서 수신 이메일을 수신할 수 있어야 합니다.

도메인 요구 사항:

  • 도메인은 표준 도메인 또는 하위 도메인이어야 합니다.

  • 도메인은 조직 외부에서 이메일을 수신하는 데 사용되므로 외부에서 DNS로 확인할 수 있어야 합니다.

클라우드 관리자, 네트워크 관리자, DNS 관리자

도메인을 확인합니다.

식별된 도메인을 사용하여 수신 이메일을 수락할 수 있는지 확인합니다.

Amazon SES 설명서의 Amazon SES 이메일 수신을 위한 도메인 확인 지침을 완료합니다. 이를 위해서는 도메인의 DNS 레코드를 담당하는 사람 또는 팀과의 협력이 필요합니다.

앱 개발자, AWS DevOps

MX 레코드를 설정합니다.

AWS 계정 및 리전의 Amazon SES 엔드포인트를 가리키는 MX 레코드로 도메인을 설정합니다. 자세한 내용은 Amazon SES 설명서에서 Amazon SES 이메일 수신을 위한 MX 레코드 게시하기를 참조하세요.

클라우드 관리자, 네트워크 관리자, DNS 관리자
작업설명필요한 기술

cdk.json의 기본값을 수정합니다.

솔루션이 배포된 후 제대로 작동하도록 cdk.json 파일(리포지토리의 루트 내)에서 일부 기본값을 편집합니다.

  1. 이전에 확인한 도메인 이름과 일치하도록 SES_DOMAIN_NAME 값을 수정합니다.

  2. SES_DOMAIN_NAME에 있는 도메인과 동일한 도메인을 포함하도록 ADDRESS_FROM 값을 수정합니다. 주소의 로컬 부분은 클라우드 팀에서 결정해야 합니다. 이 주소는 솔루션을 통해 전달되는 모든 이메일에 대한 FROM 주소가 됩니다.

  3. 일치하지 않는 모든 수신 메시지가 전달되는 이메일 주소와 일치하도록 ADDRESS_ADMIN 값을 수정합니다. 이 값은 유효한 운영 중인 이메일 주소여야 합니다.

앱 개발자, AWS DevOps

이메일 벤딩 및 전달 솔루션을 배포합니다.

  1. Python 가상 환경 생성:

    python -m venv .venv

  2. Python 가상 환경 활성화:

    source .venv/bin/activate

    또는 Windows 플랫폼에서는 다음을 사용:

    % .venv\Scripts\activate.bat

  3. 모든 Python 요구 사항을 오류 없이 설치:

    pip install -r requirements.txt

  4. CloudFormation 템플릿 합성:

    cdk synth

    오류가 없고 전체 CloudFormation 템플릿에 예상 출력이 포함되어 있는지 확인합니다.

  5. (선택 사항) AWS CDK 코드를 현재 AWS 계정 또는 리전에 처음으로 배포하는 경우 환경을 부트스트랩합니다. 자세한 내용은 AWS CDK 설명서의 부트스트래핑을 참조하세요.

    cdk bootstrap aws://AWS-ACCOUNT-NUMBER/REGION

    AWS-ACCOUNT-NUMBER 및 REGION을(를) 실제 값으로 바꿉니다.

  6. 솔루션 배포:

    cdk bootstrap
cdk deploy

    명령은 오류 없이 완료되어야 합니다.

앱 개발자, AWS DevOps

솔루션이 배포되었는지 확인합니다.

테스트를 시작하기 전에 솔루션이 성공적으로 배포되었는지 확인:

  1. AWS CloudFormation 콘솔을 열고 이름이 들어 있는 CloudFormation 스택을 찾습니다AwsMailFwdStack.

  2. 이 AwsMailFwdStack 스택에 다음과 같은 리소스가 있는지 확인합니다.

    • Lambda 함수

    • Amazon SES 규칙 및 규칙 세트

    • IAM 역할 및 정책

    • Amazon S3 버킷 및 버킷 정책

    • AWS KMS 키 및 키 정책

    • Amazon SNS 주제 및 주제 정책

    • DynamoDB 테이블

앱 개발자, AWS DevOps
작업설명필요한 기술

API가 작동 중인지 확인합니다.

이 단계에서는 솔루션의 API에 테스트 데이터를 제출하고 솔루션이 예상 출력을 생성하는지, 백엔드 작업이 예상대로 수행되었는지 확인합니다.

테스트 입력을 사용하여 Vend Email Lambda 함수를 수동으로 실행합니다. (예를 보려면 sample_vend_request.json 파일을 참조하세요.) OwnerAddress의 경우 유효한 이메일 주소를 사용합니다. API는 예상대로 값이 포함된 계정 이름과 계정 이메일을 반환해야 합니다.

앱 개발자, AWS DevOps

이메일이 전달되고 있는지 확인합니다.

이 단계에서는 시스템을 통해 테스트 이메일을 보내고 이메일이 예상 수신자에게 전달되는지 확인합니다.

  1. 마지막 단계에서 계정 이메일을 가져옵니다.

  2. 테스트 제목과 본문 텍스트를 포함하여 이 주소로 이메일을 보냅니다.

  3. 계정 소유자의 이메일 주소로 이메일을 수신했는지 확인합니다.

  4. 수신한 이메일에 cdk.json의 ADDRESS_FROM 설정과 일치하는 FROM 주소가 있는지 확인합니다.

  5. 수신한 이메일의 제목과 본문이 원래 보낸 메시지와 동일한지 확인합니다.

앱 개발자, AWS DevOps

문제 해결

문제Solution

시스템이 예상대로 이메일을 전달하지 않습니다.

설정이 올바른지 확인합니다.

  1. 도메인에 대한 Amazon SES 확인 프로세스를 완료했어야 합니다.

  2. MX 레코드가 AWS 계정 및 리전의 Amazon SES 엔드포인트를 가리키도록 도메인을 올바르게 설정해야 합니다. 자세한 내용은 Amazon SES 설명서에서 Amazon SES 이메일 수신을 위한 MX 레코드 게시하기를 참조하세요.

도메인 설정을 확인한 후 다음 단계를 따르세요.

  1. 솔루션을 배포한 계정 및 지역의 AWS CloudWatch 콘솔을 열고 탐색 창에서 CloudWatch 로그 그룹으로 이동합니다.

  2. 로그 그룹 목록에서 SesMailForwardLogGroup을(를) 검색합니다.

  3. 이 그룹의 로그를 조사하여 이메일 벤딩 및 전달 프로세스 중에 오류가 발생하는지 확인합니다.

AWS CDK 스택을 배포하려고 하면 다음 같은 오류가 표시됩니다.

“템플릿 형식 오류: 인식할 수 없는 리소스 유형”

대부분의 경우 이 오류 메시지는 대상 리전에 사용 가능한 AWS 서비스가 모두 제공되지 않음을 의미합니다. AWS Cloud9를 사용하여 솔루션을 배포하는 경우, AWS Cloud9 인스턴스가 실행되는 리전과 다른 리전을 대상으로 할 수 있습니다.

참고: 기본적으로 AWS CDK는 AWS CLI에서 구성한 리전 및 계정에 배포됩니다.

가능한 해결책:

  1. 리전별 AWS 서비스를 검토하여 이 솔루션에 필요한 모든 서비스(이 패턴 앞부분의 대상 기술 스택 섹션 참조)가 대상 AWS 리전에 있는지 조사합니다.

  2. AWS Cloud9를 사용하고 AWS Cloud9 인스턴스가 실행되는 리전과 다른 리전을 대상으로 하는 경우 솔루션을 배포하기 전에 AWS_DEFAULT_REGION 환경 변수를 설정하거나 AWS CLI로 리전을 설정해야 합니다. 자세한 내용은 AWS CLI 설명서의 AWS CLI를 구성하기 위한 환경 변수를 참조하세요. 또는 환경에 대한 AWS CDK 설명서의 지침에 따라 하드 코딩된 계정 ID 및 리전을 포함하도록 리포지토리 루트의 app.py 파일을 수정할 수 있습니다.

솔루션을 배포할 때 다음과 같은 오류 메시지가 나타납니다.

“배포 실패: 오류: AwsMailFwdStack: SSM 파라미터 /cdk-bootstrap/hnb659fds/버전을 찾을 수 없습니다. 환경이 부트스트랩되었습니까? 'cdk bootstrap'을 실행하세요.”

대상 AWS 계정 및 리전에 AWS CDK 리소스를 배포한 적이 없는 경우 먼저 오류가 나타내는 대로 cdk bootstrap 명령을 실행해야 합니다. 부트스트래핑 명령을 실행한 후에도 이 오류가 계속 표시된다면, AWS Cloud9 인스턴스가 실행되는 리전과 다른 리전에 솔루션을 배포하려고 하는 것일 수 있습니다.

이 문제를 해결하려면 솔루션을 배포하기 전에 AWS CLI로 AWS_DEFAULT_REGION 환경 변수를 설정하거나 리전을 설정합니다. 또는 환경에 대한 AWS CDK 설명서의 지침에 따라 하드 코딩된 계정 ID 및 리전을 포함하도록 리포지토리 루트의 app.py 파일을 수정할 수 있습니다.

관련 리소스

추가 정보

비용

이 솔루션을 배포할 때 AWS 계정 소유자에게 다음 서비스 사용과 관련된 비용이 발생할 수 있습니다.  잠재적 비용을 인지하려면 이러한 서비스의 청구 방식을 이해하는 것이 중요합니다. 가격 정보는 다음 페이지를 참조하세요.