

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

# 주소 목록
<a name="eb-addlist"></a>

주소 목록은 메시지의 수신자 또는 발신자가 특정 목록에 속하는지에 따라 수신 메일을 처리하기 위해 트래픽 정책 및 규칙 세트에 사용할 수 있는 이메일 주소 및 도메인 목록을 만들고 관리할 수 있는 Mail Manager 기능입니다. 주소 목록은 이메일 흐름을 더 세부적으로 제어하고 복잡한 이메일 라우팅 시나리오 관리를 간소화하는 데 도움이 됩니다.

## 주소 목록이란 무엇인가요?
<a name="what-are-address-lists"></a>

주소 목록은 이메일 메시지를 필터링하고 처리하는 데 사용할 수 있는 이메일 주소 및 도메인의 컨테이너입니다. 관련 주소를 그룹화하고 라우팅 규칙 및 트래픽 정책을 함께 적용하는 편리한 방법을 제공합니다.

주소 목록의 주요 사용 사례는 다음과 같습니다.
+ 알려진 스팸 발신자 또는 도메인 차단을 위한 거부 목록
+ 신뢰할 수 있는 발신자로부터의 전송을 보장하기 위한 허용 목록
+ 존재하지 않는 수신자에게 보내는 이메일을 조기에 거부하기 위한 수신자 검증
+ 수신자 역할에 따라 다양한 규칙을 적용하기 위한 역할 기반 라우팅
+ 특정 사용자 그룹에 정책을 적용하기 위한 그룹 기반 정책

## 주소 목록 작동 방식
<a name="how-address-lists-work"></a>

SES의 주소 목록은 이메일 주소 및 도메인 컬렉션을 만들고 유지 관리할 수 있도록 하여 이메일 관리를 간소화합니다. 생성된 목록은 트래픽 정책 및 규칙을 통해 이메일 워크플로에 통합됩니다.

SES는 이메일을 처리할 때 관련 주소 목록을 확인하여 발신자 또는 수신자가 구성원인지 확인합니다. 이 구성원 자격과 구성된 정책 및 규칙에 따라 SES는 이메일 라우팅, 필터링 또는 거부와 같은 적절한 작업을 수행합니다. 이 프로세스를 통해 이메일 트래픽을 효율적이고 세밀하게 제어할 수 있습니다.

## 주소 목록 설정
<a name="setting-up-address-lists"></a>

**Topics**
+ [주소 목록 만들기 및 채우기](#creating-address-lists)
+ [주소 목록 관리](#managing-address-lists)

### 주소 목록 만들기 및 채우기
<a name="creating-address-lists"></a>

콘솔에서 주소 목록을 만드는 과정의 일부는 하나 이상의 주소로 주소 목록을 채우는 것입니다. Mail Manager API를 사용하여 빈 주소 목록을 만들고 나중에 채울 수 있습니다. 이 섹션에서는 콘솔 절차와 AWS CLI 예제를 모두 사용하여 이 작업 중 하나를 수행하는 방법을 보여 줍니다.

**주소 목록 만들기 및 채우기:**

1. [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/)에서 SES 콘솔을 엽니다.

1. Mail Manager 아래의 탐색 패널에서 **주소 목록**을 선택합니다.

1. **주소 목록 생성**을 선택하고 **주소 목록 이름** 필드에 이름을 입력합니다.

1. **수동 입력** 또는 **대량 업로드**를 선택하고 해당 단계를 따릅니다.

1. **수동 입력의 경우** - 콘솔에 이메일 주소 또는 도메인을 하나 이상 입력합니다.

   별표(`*`) 와일드카드를 사용하는 경우 다음 형식이 적용됩니다.

   1. 주소에는 하나의 `*`만 허용됩니다.
      + 이메일 주소를 입력하는 경우 `*` 기호가 @ 앞 또는 뒤에 있어야 합니다.
      + `*`가 로컬 부분에 있는 경우 로컬 부분은를 제외하고 0\$119자일 수 있습니다`*`.
      + `*` 기호가 도메인에 있는 경우, 하위 도메인 수준은 `*` 기호를 제외하고 2\$19자일 수 있습니다.

   1. 유효한 와일드카드 형식의 예:
      + *\$1.domain1.com to \$1.domain8.domain7...domain1.com*
      + *\$1@domain.com에서 1234567890123456789\$1@domain.com으로*
      + *local@\$1.domain1.com to local@\$1.domain8.domain7...domain1.com*

1. **대량 업로드의 경우** - **파일 선택**을 선택하고 컴퓨터에서 업로드할 주소가 포함된 CSV 또는 JSON 파일을 선택합니다.

   각 파일 유형에 대해 예제에 표시된 형식을 사용합니다.

   1. CSV 파일 예제(헤더 `address`는 필수):

      ```
      address
      user1@domain.com
      user2@*.domain.com
      *@domain.com
      ```

   1. JSON 파일 예제:

      ```
      {
        "items": [
          {
            "address": "user1@domain.com"
          },
          {
            "address": "user2@*.domain.com"
          },
          {
            "address": "*@domain.com"
          }
        ]
      }
      ```

1. 주소 추가를 완료했거나 대량 파일을 선택한 후에는 **주소 목록 생성**을 선택합니다.

사용 AWS CLI:

**주소 목록 만들기**

```
aws mailmanager create-address-list --address-list-name "MyDenyList"
```

**주소 목록 채우기:**
+ **단일 업로드**

  ```
  aws mailmanager register-member-to-address-list \
                  --address-list-id al-123456789abc \
                  --address "user@example.com"
  ```
+ **대량 업로드**

  대량 업로드의 경우 먼저 CSV 또는 JSON 형식을 지정하는 가져오기 작업을 만들어야 합니다.

  ```
  aws mailmanager create-address-list-import-job \
                  --address-list-id "al-123456789abc" \
                  --name "MyImportJob" \
                  --import-data-format ImportDataType=CSV
  ```

  그러면 작업 ID와 미리 서명된 URL이 반환됩니다. curl 명령을 사용하여 다음 예제와 같이 이 미리 서명된 URL을 사용하여 CSV 또는 JSON 파일을 S3 버킷에 업로드합니다.

  ```
  curl -X PUT -T "/path/to/file" "pre-signed URL" 
  ```

  업로드한 후 이전 명령에서 반환된 작업 ID를 사용하여 가져오기 작업을 시작합니다.

  ```
  aws mailmanager start-address-list-import-job --job-id "job-123456789"
  ```

### 주소 목록 관리
<a name="managing-address-lists"></a>

필요에 따라 주소 목록을 업데이트, 확인 및 삭제할 수 있습니다.

**Topics**
+ [주소 목록 업데이트](#updating-address-lists)
+ [주소 목록 세부 정보 보기](#viewing-address-lists)
+ [주소 목록 삭제](#deleting-address-lists)

#### 주소 목록 업데이트
<a name="updating-address-lists"></a>

주소를 추가 또는 제거하고 선택적으로 태그를 추가 또는 제거하여 주소 목록을 업데이트할 수 있습니다.

**주소 목록 업데이트:**

1. **주소 목록** 페이지에서 편집하려는 주소 목록의 이름을 선택합니다.

1. 주소를 추가하려면 **이메일 주소 추가**를 선택하고 [주소 목록 만들기 및 채우기](#creating-address-lists)에 설명된 대로 수동 입력 또는 대량 업로드 방법을 진행합니다.

1. 주소를 제거하려면 제거하려는 각 주소 옆의 확인란을 선택한 다음 **이메일 주소 제거**를 선택하고 삭제를 확인합니다.

1. (선택 사항) **태그 관리**를 선택하여 주소 목록에서 **태그**를 추가하거나 제거합니다.

사용 AWS CLI:

**Add**

```
aws mailmanager register-member-to-address-list \
                --address-list-id al-123456789abc \
                --address "user@example.com"
```

**Remove**

```
aws mailmanager deregister-member-from-address-list \
                --address-list-id al-123456789abc \
                --address "user@example.com"
```

#### 주소 목록 세부 정보 보기
<a name="viewing-address-lists"></a>

주소 목록 세부 정보 보기:
+ **주소 목록** 페이지에서 주소 목록의 이름을 선택하여 세부 정보를 확인합니다.

사용 AWS CLI:

```
aws mailmanager list-members-of-address-list --address-list-id al-123456789abc
```

#### 주소 목록 삭제
<a name="deleting-address-lists"></a>

주소 목록 삭제:

1. **주소 목록** 페이지에서 삭제하려는 주소 목록 옆의 라디오 버튼을 선택한 다음 **삭제**를 선택합니다.

1. *확인*과 **삭제**를 차례로 입력하여 목록 삭제를 확인합니다.

사용 AWS CLI:

```
aws mailmanager delete-address-list --address-list-id al-123456789abc
```

## 트래픽 정책 및 규칙 세트에서 주소 목록 사용
<a name="using-address-lists-in-traffic-policies-and-rule-sets"></a>

주소 목록은 트래픽 정책 문과 규칙 조건에서 사용할 수 있으며, 목록 구성원 자격에 따라 이메일을 처리함으로써 이메일 흐름을 제어할 수 있습니다. 다음 섹션에서는 각 트래픽 정책 및 규칙 세트에 사용되는 주소 목록의 예제를 제공합니다.

**Topics**
+ [트래픽 정책 예제](#traffic-policy-example)
+ [규칙 세트 예제](#rule-set-example)

### 트래픽 정책 문에서 주소 목록 사용
<a name="traffic-policy-example"></a>

수신 엔드포인트로 들어오는 이메일을 허용하거나 거부하도록 트래픽 정책 문의 조건을 빌드할 때 주소 목록을 선택할 수 있습니다.

다음 콘솔 절차와 이에 AWS CLI 상응하는 절차는 수신자가 지정된 주소 목록에 있는 경우 수신 엔드포인트로 메시지를 허용하는 정책 설명을 생성하는 예를 보여줍니다.

**트래픽 정책 문에서 주소 목록을 사용하려면:**

1. [트래픽 정책 및 정책 스테이트먼트 만들기(콘솔)](eb-filters.md#eb-filters-create-console)에 설명된 대로 새 트래픽 정책을 만들거나 기존 트래픽 정책을 편집합니다.

1. **정책 문** 컨테이너에서 문 조건이 충족될 때 작업을 수행할 수 있도록 **허용**을 선택합니다.

1. 다음과 같이 문 조건을 빌드합니다.
   + **프로토콜** 필드에서 **수신자 주소**를 선택합니다.
   + **연산자** 필드에서 **주소 목록에 포함**을 선택합니다.
   + **값** 필드에서 주소 목록의 이름을 선택합니다.

1. 이것은 하나의 예제에 불과하지만, 사용 중인 어떤 주소 목록에도 다양한 연산자를 기반으로 하는 정책 조건을 추가할 수 있습니다.

사용 AWS CLI:

```
aws mailmanager create-traffic-policy \
  --default-action ALLOW \
  --traffic-policy-name "testpolicy" \
  --policy-statements '[{
    "Action": "ALLOW",
    "Conditions": [{
      "BooleanExpression": {
        "Evaluate": {
          "IsInAddressList": {
            "Attribute": "RECIPIENT",
            "AddressLists": [
              "arn:aws:ses:eu-west-3:123456789012:mailmanager-address-list/al-123456789abc"
            ]
          }
        },
        "Operator": "IS_TRUE"
      }
  }]
}]'
```

### 규칙에서 주소 목록 사용
<a name="rule-set-example"></a>

규칙 세트 중 하나에 사용되는 규칙의 조건을 빌드하여 규칙의 작업을 트리거할 때 주소 목록을 선택할 수 있습니다.

다음 콘솔 절차와 이에 AWS CLI 상응하는 절차는 수신자가 지정된 주소 목록에 있는 경우 삭제 작업을 호출하는 규칙을 생성하는 예를 보여줍니다.

**규칙 조건에서 주소 목록 사용:**

1. [규칙 세트 및 규칙 만들기(콘솔)](eb-rules.md#eb-rules-create-console)에 설명된 대로 새 규칙을 만들거나 기존 규칙을 편집합니다.

1. **규칙 조건** 컨테이너에서 다음과 같이 규칙의 조건을 빌드합니다.
   + **속성 선택** 필드에서 **수신자 주소**를 선택합니다.
   + **연산자 선택** 필드에서 **주소 목록에 포함**을 선택합니다.
   + **값** 필드에서 주소 목록의 이름을 선택합니다.

1. **작업** 컨테이너에서 **새 작업 추가**를 선택하고 **삭제 작업**을 선택합니다.

1. 이것은 하나의 예제에 불과하지만, 사용 중인 어떤 주소 목록에도 다양한 연산자를 기반으로 한 규칙 조건을 추가하여 다양한 작업을 수행할 수 있습니다.

사용 AWS CLI:

```
aws mailmanager create-rule-set \
  --rule-set-name "testruleset2" \
  --rules '[{
    "Name": "addresslist",
    "Conditions": [{
      "BooleanExpression": {
        "Evaluate": {
          "IsInAddressList": {
            "Attribute": "RECIPIENT",
            "AddressLists": [
              "arn:aws:ses:us-east-1:123456789012:mailmanager-address-list/al-123456789abc"
            ]
          }
        },
        "Operator": "IS_TRUE"
      }
    }],
    "Actions": [{
      "Drop": {}
    }]
  }]'
```

## 모범 사례 및 고려 사항
<a name="best-practices-and-considerations"></a>
+ 목록 크기에 유의하세요. 목록이 매우 크면 성능에 영향을 미칠 수 있습니다.
+ 주소 목록은 계정별로 다르며 동일한 AWS 계정 내에서만 사용할 수 있습니다.
+ 중첩 주소 목록은 현재 지원되지 않습니다.
+ 리전당 최대 100개의 주소 목록이 지원됩니다.
+ 주소 목록당 최대 10만 개의 주소가 지원됩니다.