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

# Amazon SES에서 테넌트 수준 금지 목록 사용
<a name="sending-email-suppression-list-tenant-level"></a>

Amazon Simple Email Service(SES) 다중 테넌시를 사용하여 여러 테넌트를 대신하여 이메일을 전송하는 경우 각 테넌트에 자체 금지 목록을 제공할 수 있습니다. 테넌트 수준 금지는 반송 메일과 수신 거부를 격리하여 이메일을 보낸 테넌트에만 영향을 줍니다. 이 기능이 없으면 모든 테넌트가 계정 수준 금지 목록을 공유합니다. 수신자가 한 테넌트의 이메일을 반송하거나 수신 거부하면 해당 주소는 계정의 모든 테넌트에 대해 숨겨집니다. 테넌트 수준 금지는 각 테넌트에 대해 별도의 금지 주소 목록을 유지하여 이러한 교차 테넌트 오염을 방지합니다.

## 테넌트 수준 금지 작동 방식
<a name="sending-email-suppression-list-tenant-level-how-it-works"></a>

두 가지 설정은 각 테넌트에 대한 억제 동작을 제어합니다. 즉, *억제 범위*와 *억제된 이유*입니다. API 작업을 사용하거나 `PutTenantSuppressionAttributes` API 작업으로 테넌트를 생성할 `SuppressionAttributes` 때를 지정하여 두 설정을 함께 구성합니다`CreateTenant`.

**억제 범위는** SES가 테넌트에 사용하는 억제 목록을 결정합니다.
+ `TENANT` - 테넌트의 자체 금지 목록을 사용합니다.
+ `ACCOUNT` - 계정 수준 금지 목록을 사용합니다. 이는 기존 테넌트와 새 테넌트 모두에 대한 기본값입니다.

**억제된 이유**에 따라 SES가 금지 목록에 주소를 추가하는 이벤트가 결정됩니다.
+ `BOUNCE` - 하드 바운스를 생성하는 주소를 추가합니다.
+ `COMPLAINT` - 수신 거부를 생성하는 주소를 추가합니다.
+ `BOUNCE` 및 `COMPLAINT` - 두 이벤트 중 하나를 생성하는 주소를 추가합니다.
+ 비어 있음 - 금지 목록을 확인하거나 기록하지 마세요.

**참고**  
`SuppressionScope` 및를 `SuppressedReasons` 함께 제공하거나 둘 다 null로 설정해야 합니다. 둘 다 null로 설정하면 테넌트의 금지 설정이 지워지고 테넌트가 기본 `ACCOUNT` 범위 동작으로 돌아갑니다.

### 구성별 억제 동작
<a name="sending-email-suppression-list-tenant-level-behavior-by-config"></a>

다음 표에서는 억제 범위와 억제된 이유의 각 조합에 대한 전송 시간 및 기록 동작을 설명합니다.


| Scope | 이유 | 전송 시간 동작 | 레코딩 동작 | 
| --- | --- | --- | --- | 
| TENANT | BOUNCE, COMPLAINT | 테넌트 목록에 반송 메일 및 수신 거부가 있는지 확인합니다. | 테넌트 목록에 둘 다 기록 | 
| TENANT | BOUNCE | 테넌트 목록에 반송 메일만 있는지 확인합니다. | 테넌트 목록에만 반송 메일을 기록합니다. | 
| TENANT | COMPLAINT | 테넌트 목록에 수신 거부만 있는지 확인합니다. | 테넌트 목록에만 수신 거부 기록 | 
| TENANT | 비어 있음 | 억제 검사 없음 | 녹음 없음 | 
| ACCOUNT | BOUNCE, COMPLAINT | 계정 목록에 반송 메일 및 수신 거부가 있는지 확인합니다. | 계정 목록에 둘 다 기록 | 
| ACCOUNT | BOUNCE | 계정 목록에 반송 메일만 있는지 확인합니다. | 계정 목록에만 반송 메일을 기록합니다. | 
| ACCOUNT | COMPLAINT | 계정 목록에 수신 거부만 있는지 확인합니다. | 계정 목록에만 수신 거부 기록 | 
| ACCOUNT | 비어 있음 | 억제 검사 없음 | 녹음 없음 | 

## 억제 우선 순위 및 전송 시간 동작
<a name="sending-email-suppression-list-tenant-level-precedence"></a>

SES는 억제 설정을 가장 높은 순서에서 가장 낮은 순서로 확인합니다.

1. **구성 세트** - 구성 세트가 억제 설정을 지정하는 경우 SES는 이러한 설정을 사용합니다.

1. **테넌트** - 구성 세트 재정의가 없는 경우 SES는 테넌트의 억제 설정을 사용합니다.

1. **계정** - 구성 세트나 테넌트가 설정을 지정하지 않으면 SES는 계정 수준 기본값을 사용합니다.

**중요**  
금지 범위에 따라 전송 시 SES가 확인하는 금지 목록이 결정됩니다. 범위가 `TENANT`인 경우 SES는 테넌트의 금지 목록만 확인하고 계정 수준 금지 목록을 건너뜁니다. 계정 수준 금지 목록에 있지만 테넌트의 금지 목록에는 없는 주소는 표시되지 않습니다. 범위가 `ACCOUNT`인 경우 SES는 계정 수준 금지 목록만 확인합니다. 또한 범위는 반송 메일 및 수신 거부가 기록되는 위치를 제어합니다.

### 구성 세트 재정의
<a name="sending-email-suppression-list-tenant-level-config-set-overrides"></a>

이제 구성 세트`SuppressionOptions`의에 `SuppressionScope` 필드가 포함됩니다. 구성 세트를 사용하여 범위만, 이유만 또는 둘 다 독립적으로 재정의할 수 있습니다. 이를 통해 특정 전송 워크플로의 억제 동작을 세밀하게 제어할 수 있습니다. 테넌트의 기본 설정은 변경할 필요가 없습니다.

## 자동 금지 기록
<a name="sending-email-suppression-list-tenant-level-auto-recording"></a>

억제 범위가 인 경우 `TENANT`SES는 다음과 같이 억제 항목을 자동으로 기록합니다.
+ **하드 바운스 **- SES는 테넌트의 금지 목록과 전역 금지 목록에 주소를 추가합니다. SES는 계정 수준 금지 목록에 주소를 추가*하지* 않습니다.
+ **수신 거부** - SES는 테넌트의 금지 목록에만 주소를 추가합니다.
+ **스팸 아님 피드백 -** 수신자가 이전에 보고된 메시지를 스팸 아님으로 표시하면 SES는 테넌트의 금지 목록에서 `COMPLAINT`이유 항목을 자동으로 제거합니다.

## 테넌트 억제 반송 메일 식별
<a name="sending-email-suppression-list-tenant-level-identifying-bounces"></a>

주소가 테넌트의 금지 목록에 있기 때문에 SES가 메시지를 금지하는 경우 다음 지표를 사용하여 이벤트를 식별할 수 있습니다.
+ **반송 메일 알림** - 반송 메일 유형은 하위 유형이 `Permanent`입니다`OnTenantSuppressionList`.
+ **가상 배달 가능성 관리자(VDM)** - 반송 이유는 입니다`ON_TENANT_SUPPRESSION_LIST`.
+ **진단 코드** - `"Amazon SES did not send the message to this address because it is on the suppression list for your tenant."`
+ **이벤트 태그** - SES는 반송 메일 및 수신 거부 알림에 `ses:tenant-name` 태그를 추가하여 이벤트가 속한 테넌트를 식별할 수 있습니다.

## 테넌트 금지 목록 항목 관리
<a name="sending-email-suppression-list-tenant-level-managing-entries"></a>

계정 수준 항목에 사용하는 것과 동일한 API 작업을 사용하여 테넌트 금지 목록 항목을 관리합니다. 테넌트의 금지 목록을 대상으로 지정하려면 요청에 `TenantName` 파라미터를 포함합니다.
+ `PutSuppressedDestination` - 테넌트의 금지 목록에 주소를 추가합니다.
+ `GetSuppressedDestination` - 테넌트의 숨겨진 주소에 대한 세부 정보를 검색합니다.
+ `DeleteSuppressedDestination` - 테넌트의 금지 목록에서 주소를 제거합니다.
+ `ListSuppressedDestinations` - 테넌트에 대해 억제된 모든 주소를 나열합니다.

`TenantName` 파라미터를 생략하면 이러한 작업은 계정 수준 금지 목록을 대상으로 합니다. 이렇게 하면 기존 통합과의 이전 버전과의 호환성이 유지됩니다.

## 고려 사항 및 제한 사항
<a name="sending-email-suppression-list-tenant-level-considerations"></a>

테넌트 수준 금지 목록을 사용할 때는 다음 사항에 유의하세요.
+ **다중 테넌시 필요** -이 기능을 사용하려면 하나 이상의 테넌트로 구성된 SES 다중 테넌시가 있어야 합니다.
+ **테넌트당 하나의 목록** - 각 테넌트에는 정확히 하나의 금지 목록이 있습니다. 테넌트와 금지 목록 간에는 1:1 매핑이 있습니다.
+ **리전별** - 테넌트 금지 목록은 구성한 AWS 리전 에 따라 다릅니다.
+ **주소 지속** - 숨겨진 주소는 명시적으로 제거하거나 SES가 자동으로 제거할 때까지 테넌트 목록에 남아 있습니다(예: 수신자가 `COMPLAINT`-이유 항목에 대해 스팸이 아닌 이벤트를 보고하는 경우).
+ **대/소문자를 구분하는 스토리지 -** 금지 목록의 이메일 주소는 대/소문자를 보존하여 저장됩니다. 억제 목록 관리를 위한 API 호출에는 정확한 대/소문자 일치가 필요합니다.
+ **전송 할당량 영향 **- 테넌트 금지 목록에 의해 억제된 메시지는 일일 전송 할당량에 포함됩니다.
+ **Gmail 수신 거부 데이터** - Gmail은 수신 거부 데이터를 SES로 보내지 않습니다. Gmail에서 호스팅하는 주소는 수신 거부 금지 목록에 자동으로 추가되지 않습니다.
+ **샌드박스 제한** - 계정에 프로덕션 액세스 권한이 있을 `PutSuppressedDestination` 때까지를 호출할 수 없습니다.
+ **설정 지우기** - 테넌트의 억제 설정을 지우려면 범위와 이유 모두에 대해 null 값을 `PutTenantSuppressionAttributes` 사용하여를 호출합니다.
+ **테넌트 삭제 **- 테넌트를 삭제하면 SES는 해당 테넌트에 대한 모든 금지 목록 항목도 삭제합니다.

## 관련 리소스
<a name="sending-email-suppression-list-tenant-level-related-resources"></a>

다음 리소스는 SES의 금지 목록에 대해 자세히 알아보는 데 도움이 될 수 있습니다.
+ [Amazon SES 계정 수준 금지 목록 사용](sending-email-suppression-list.md)
+ [Amazon SES 전역 금지 목록](sending-email-global-suppression-list.md)