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

테넌트

이 장에서는 Amazon SES 테넌트 관리를 사용하여 SES 계정 내의 여러 테넌트에서 이메일 전송을 격리, 모니터링 및 관리하는 방법을 설명합니다. 이 기능은 여러 다운스트림 엔터티를 대신하여 이메일을 보내는 독립 소프트웨어 공급업체(ISVs), 엔터프라이즈 및 조직이 별도의 평판 프로파일을 유지하고 한 테넌트의 문제가 다른 테넌트에 영향을 미치지 않도록 하는 데 도움이 됩니다.

테넌트 관리란 무엇입니까?

테넌트 관리는 SES 계정 내에서 "테넌트"라는 격리된 컨테이너를 생성할 수 있는 기능입니다. 각 테넌트는 고유한 이메일 자격 증명, 구성 세트, 템플릿 및 평판 지표를 보유하여 이메일 활동이 서로 다른 고객 또는 사업부 간에 완전히 분리되도록 할 수 있습니다.

테넌트 관리는 한 고객의 잘못된 이메일 관행이 이전에 전체 SES 계정을 일시 중지하여 다른 모든 고객에게 영향을 미칠 수 있는 문제를 해결합니다. 테넌트 격리를 사용하면 중앙 집중식 감독 및 제어를 유지하면서 여러 이메일 스트림을 독립적으로 관리할 수 있습니다.

테넌트는 관련 SES 리소스를 그룹화하는 논리적 컨테이너 역할을 합니다. 특정 테넌트를 대신하여 이메일을 보내면 SES는 평판 지표를 추적하고 테넌트 수준에서 정책을 적용합니다. 이 격리는 한 테넌트의 높은 반송률 또는 수신 거부율이 다른 테넌트가 보낸 이메일의 배달 가능성에 영향을 미치지 않도록 합니다.

테넌트 관리는 다음과 같은 경우에 특히 유용합니다.

테넌트 관리 작동 방식

테넌트 평판 관리는 이메일 전송 리소스에 대한 논리적 컨테이너를 생성하여 작동합니다. 확인된 자격 증명(도메인 및 이메일 주소), 구성 세트 및 템플릿을 포함하여 각 테넌트에 특정 리소스를 할당합니다. 테넌트를 대신하여 이메일을 전송할 때 API 호출 또는 SMTP 헤더에 테넌트를 지정하면 SES는 사용 중인 리소스가 해당 테넌트와 올바르게 연결되어 있는지 확인합니다.

리소스 연결

SES 계정의 리소스는 두 가지 방법으로 테넌트와 연결할 수 있습니다.

리소스를 테넌트와 연결하면 해당 테넌트는 해당 리소스를 이메일 전송에 사용할 수 있는 권한을 얻습니다. 각 전송 요청에서 SES는 지정된 테넌트가 요청에서 자격 증명, 구성 세트 및 템플릿을 사용할 권한이 있는지 확인합니다. 리소스가 제대로 연결되지 않으면 전송 요청이 실패합니다.

평판 모니터링 및 시행

SES는 반송률, 수신 거부율(사서함 공급자 피드백 루프(FBL) 시스템의 지표 포함) 및 타사 피드백 신호를 포함하여 각 테넌트의 주요 평판 지표를 지속적으로 모니터링합니다. 이러한 지표가 정의된 임계값을 초과하면 SES는 다음과 같이 분류된 "평판 조사 결과"를 생성합니다.

이러한 결과를 기반으로 SES는 구성한 평판 정책을 통해 문제가 있는 테넌트를 자동으로 일시 중지할 수 있습니다. 세 가지 적용 수준을 사용할 수 있습니다.

테넌트의 지표가 선택한 정책에 따른 적용 임계값을 충족하는 평판 조사 결과를 트리거하면 시스템은 다른 테넌트의 전송 기능에 영향을 주지 않고 테넌트의 전송 상태를 "일시 중지"로 자동 업데이트합니다. 테넌트가 일시 중지된 동안 문제를 검토하고 전송을 수동으로 다시 활성화할 때까지 해당 테넌트를 사용하여 이메일을 보내려는 시도는 실패합니다. 또한 필요한 경우 테넌트의 전송 기능을 수동으로 일시 중지하고 전송을 재개할 준비가 되면 일시 중지를 해제할 수 있습니다.

테넌트 설정

테넌트 생성

콘솔 사용:

사용 AWS CLI:

aws sesv2 create-tenant \
    --tenant-name "MyTenant" \
    --region us-east-1

테넌트에 리소스 할당

테넌트를 생성한 후 테넌트가 이메일을 보내기 전에 확인된 자격 증명과 구성 세트를 하나 이상 할당해야 합니다.

콘솔 사용:

사용 AWS CLI:

# Assign an identity to a tenant
aws sesv2 create-tenant-resource-association \
    --tenant-name "MyTenant" \
    --resource-arn "arn:aws:ses:us-east-1:123456789012:identity/example.com" \
    --region us-east-1

# Assign a configuration set to a tenant
aws sesv2 create-tenant-resource-association \
    --tenant-name "MyTenant" \
    --resource-arn "arn:aws:ses:us-east-1:123456789012:configuration-set/MyConfigSet" \
    --region us-east-1

평판 정책 구성

평판 정책은 평판 지표를 기반으로 테넌트의 이메일 전송이 자동으로 일시 중지되는 시기를 결정합니다. 테넌트를 생성하면 SES가 표준 평판 정책을 자동으로 할당합니다. 다른 정책으로 변경하려면 다음 단계를 따르세요.

콘솔 사용:

사용 AWS CLI:

update-reputation-entity-policy \
    --reputation-entity-type "RESOURCE" \
    --reputation-entity-reference "arn:aws:ses:us-east-1:123456789012:tenant/tenantId" \
    --reputation-entity-policy "arn:aws:ses:us-east-1:aws:reputation-policy/standard"

테넌트와 이메일 전송

테넌트를 통해 이메일을 전송할 때 API 호출 또는 SMTP 헤더에 테넌트를 지정하고 사용된 모든 리소스가 해당 테넌트와 연결되어 있는지 확인해야 합니다.

테넌트와 함께 SendEmail API 사용

AWS CLI 예:

aws sesv2 send-email \
  --tenant-name "MyTenant" \
  --from-email-address "sender@example.com" \
  --destination "ToAddresses=recipient@example.com" \
  --content "Simple={Subject={Data='Test Subject',Charset=utf-8},Body={Text={Data='Test email body',Charset=utf-8}}}" \
  --configuration-set-name "MyConfigSet"

AWS SDK for Python 예제:

import boto3

client = boto3.client('sesv2')
response = client.send_email(
    FromEmailAddress='sender@example.com',
    Destination={
        'ToAddresses': ['recipient@example.com']
    },
    Content={
        'Simple': {
            'Subject': {
                'Data': 'Test email'
            },
            'Body': {
                'Text': {
                    'Data': 'This is a test email sent using a tenant.'
                }
            }
        }
    },
    ConfigurationSetName='MyConfigurationSet',
     TenantName='MyTenant'
)

테넌트와 함께 SMTP 사용

SMTP를 사용하여 테넌트를 통해 이메일을 전송하는 경우 이메일 헤더에 테넌트 정보를 포함합니다.

X-SES-TENANT: MyTenant

이 헤더는 SES가 적절한 리소스 검증 및 평판 추적을 적용할 수 있도록 이메일 전송 작업에 사용할 테넌트를 SES에 알려줍니다.

테넌트 상태 관리

테넌트 상태 및 지표 보기

콘솔 사용:

사용 AWS CLI:

# Get tenant details
aws sesv2 get-tenant --tenant-name "MyTenant"

테넌트 일시 중지 및 일시 중지 해제

필요한 경우 테넌트의 전송 기능을 수동으로 일시 중지하고 전송을 재개할 준비가 되면 일시 중지를 해제할 수 있습니다.

콘솔 사용:

사용 AWS CLI:

테넌트를 일시 중지하려면:

# Pause a tenant
aws sesv2 update-reputation-entity-customer-managed-status \
  --reputation-entity-type RESOURCE 
  --reputation-entity-reference "arn:aws:ses:us-east-1:593442965613:tenant/tenantId"
  --sending-status DISABLED

테넌트 일시 중지를 해제하려면:

# Unpause a tenant
aws sesv2 update-reputation-entity-customer-managed-status \
  --reputation-entity-type RESOURCE 
  --reputation-entity-reference "arn:aws:ses:us-east-1:593442965613:tenant/tenantId"
  --sending-status ENABLED

평판 조사 결과 작업

평판 조사 결과 보기

콘솔 사용:

사용 AWS CLI:

aws sesv2 list-recommendations \
   --filter='{ "RESOURCE_ARN":"arn:aws:ses:us-east-1:012345678901:tenant/tenantId"}'

응답에는 모든 활성 결과에 대한 세부 정보가 포함됩니다.

{
    "Recommendations": [
        {
            "ResourceArn": "arn:aws:ses:us-east-1:012345678901:tenant/{tenant-name}/{tenant-id}",
            "Type": "BOUNCE",
            "Description": "The bounce rate exceeded 15.0% based on a representative volume of 664 emails from July 11, 2025 at 14:41 (UTC) to July 11, 2025 at 16:26 (UTC).",
            "Status": "OPEN",
            "CreatedTimestamp": "2025-07-11T16:16:14.029000+00:00",
            "LastUpdatedTimestamp": "2025-07-11T16:37:14.145000+00:00",
            "Impact": "HIGH"
        }
    ]
}

평판 조사 결과 이해

평판 조사 결과는 테넌트의 이메일 전송 관행과 관련된 잠재적 문제에 대한 인사이트를 제공합니다. 각 결과에는 다음이 포함됩니다.

일반적인 결과는 다음과 같습니다.

평판 문제 해결

평판 조사 결과를 받으면 근본 원인을 조사하고 즉시 시정 조치를 취하는 것이 중요합니다.

모니터링 및 분석

CloudWatch 지표 설정

SES는 테넌트별 지표를 Amazon CloudWatch에 게시합니다. 각 테넌트에 대해 다음 지표를 사용할 수 있습니다.

EventBridge 알림 설정

기본적으로 SES는 테넌트 평판 조사 결과가 감지되거나 테넌트 상태 변경이 발생할 때 EventBridge 기본 이벤트 버스로 이벤트를 전송합니다.

기본 이벤트 버스에 규칙을 만들어 EventBridge가 하나 이상의 지정된 대상으로 보낼 특정 이벤트를 식별할 수 있습니다.

다음과 같은 세부 유형을 사용할 수 있습니다.

테넌트 전송 상태 변경의 경우:

평판 조사 결과의 경우:

평판 조사 결과에 대한 EventBridge 규칙 패턴의 예:

{
  "detail-type": "Advisor Recommendation Status Open",
  "source": "aws.ses",
  "account": "012345678901",
  "time": "2023-11-15T17:00:59Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:ses:us-east-1:012345678901:tenant/{tenant-name}/{tenant-id}"
  ],
  "detail": { 
       "version": "1.0.0",
       "data": "The bounce rate exceeded 15.0% based on a representative volume of 197 emails from July 11, 2025 at 14:43 (UTC) to July 11, 2025 at 16:13 (UTC).",
       "metadata":{"impact":"HIGH","type":"BOUNCE"}
  
    }
}

상태 변경 전송을 위한 EventBridge 규칙 패턴의 예:

{
        "detail-type": "Sending Status Disabled",
        "source": "aws.ses",
        "account": "012345678901",
        "time": "2025-07-24T12:44:28Z",
        "region": "us-east-1",
        "resources": [
            "arn:aws:ses:us-east-1:012345678901:tenant/{tenant-name}/{tenant-id}"
        ],
        "detail": {
            "version": "1.0.0",
            "data": {
                "origin": "CUSTOMER_MANAGED",
                "record": {
                    "status": "DISABLED",
                    "cause": "Status manually updated.",
                    "lastUpdatedTimestamp": [2025, 7, 24, 12, 44, 28, 995000000]
                }
            }
        }
    }

필드 설명:

이러한 이벤트를 사용하여 테넌트 상태 변경을 모니터링하고 애플리케이션에서 응답을 자동화할 수 있습니다. 예를 들어 테넌트가 비활성화될 때 알림을 트리거하거나 시간 경과에 따른 테넌트 상태 지표를 추적할 수 있습니다.

AWS 신뢰 및 안전과의 통합

AWS 신뢰 및 안전이 일반적으로 계정 수준 적용을 초래하는 문제를 감지하면 테넌트 시스템은 더 많은 대상 응답을 활성화합니다. Trust & Safety는 전체 계정을 일시 중지하는 대신 문제가 있는 테넌트만 일시 중지하는 동시에 규정 준수 테넌트가 계속 전송하도록 허용할 수 있습니다.

이 테넌트 수준 적용은 평판 문제의 영향을 줄이고 다른 이메일 스트림의 비즈니스 연속성을 유지하는 데 도움이 됩니다.

SES가 테넌트 평판에 영향을 미치는 심각도가 높은 문제로 인해 전송을 비활성화하고 계정을 검토 중으로 설정하면 알림을 받게 됩니다. Trust & Safety와 협력하여 문제를 해결하고 영향을 받는 테넌트에 대한 전송을 복원할 수 있도록 AWS 지원 센터에서 사례가 열립니다.

모범 사례

Amazon SES에서 테넌트 평판을 효과적으로 관리하려면 다음 모범 사례를 따르세요.

제한 사항

테넌트 관리를 사용할 때는 다음 제한 사항에 유의하세요.

요금

이메일 수에 따라 매월 테넌트당 추가 요금이 부과됩니다. 자세한 요금 정보는 SES 요금 페이지를 참조하세요.

테넌트 지표와 함께 CloudWatch를 사용하는 경우 각 테넌트에 대한 표준 CloudWatch 지표는 기본 모니터링의 일부로 추가 비용 없이 제공됩니다. 사용자 지정 대시보드, 경보 또는 세부 모니터링과 같은 추가 CloudWatch 기능에는 표준 CloudWatch 요금이 발생할 수 있습니다.