

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# アドレスリスト
<a name="eb-addlist"></a>

アドレスリストは、メッセージの受信者または送信者が特定のリストに属しているかどうかに基づいて受信メールを処理するために、トラフィックポリシーとルールセットで使用できる E メールアドレスとドメインのリストを作成および管理できる、Mail Manager の機能です。アドレスリストは、E メールフローをよりきめ細かく制御し、複雑な E メールルーティングシナリオの管理を簡素化するために役立ちます。

## アドレスリストとは
<a name="what-are-address-lists"></a>

アドレスリストは、E メールメッセージのフィルタリングと処理に使用できる E メールアドレスとドメインのコンテナです。関連するアドレスをグループ化し、ルーティングルールとトラフィックポリシーをまとめて適用できる便利な機能を備えています。

アドレスリストの主なユースケースは次のとおりです。
+ 既知のスパム送信者またはドメインをブロックするための拒否リスト
+ 信頼できる送信者からの配信を確実にするための許可リスト
+ 存在しない受信者への E メールを早期に拒否する受信者の検証
+ 受信者ロールに基づいて異なるルールを適用するためのロールベースのルーティング
+ 特定のユーザーグループ用のポリシーを適用するためのグループベースのポリシー

## アドレスリストの仕組み
<a name="how-address-lists-work"></a>

SES のアドレスリストは、E メールアドレスとドメインのコレクションを作成および維持できるようにすることで、E メール管理を効率化します。このリストを作成すると、リストはトラフィックポリシーとルールを通じて E メールワークフローに統合されます。

SES は E メールを処理するときに、該当するアドレスリストを確認して、送信者または受信者がメンバーであるかどうかを判断します。このメンバーシップおよび設定されたポリシーとルールに基づいて、SES は E メールのルーティング、フィルタリング、拒否などの適切なアクションを実行します。このプロセスにより、E メールトラフィックを効率的に、きめ細かく制御できます。

## アドレスリストの設定
<a name="setting-up-address-lists"></a>

**Topics**
+ [アドレスリストの作成と入力](#creating-address-lists)
+ [アドレスリストの管理](#managing-address-lists)

### アドレスリストの作成と入力
<a name="creating-address-lists"></a>

コンソールでアドレスリストを作成する作業の一環として、1 つ以上のアドレスを入力します。Mail Manager API を使用して空のアドレスリストを作成し、入力は後で行うことができます。このセクションでは、コンソールの手順と AWS CLI の例の両方を使用した実行方法を示します。

**アドレスリストを作成して入力するには:**

1. SES コンソール ([https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/)) を開きます。

1. 左側のナビゲーションパネルで、[Mail Manager] の下にある **[アドレスリスト]** を選択します。

1. **[アドレスリストを作成]** を選択し、**[アドレスリスト名]** フィールドに名前を入力します。

1. **[手動入力]** または **[一括アップロード]** を選択し、それぞれのステップに従います。

1. **手動入力の場合** – コンソールに 1 つ以上の E メールアドレスまたはドメインを入力します。

   アスタリスク (`*`) ワイルドカードを使用する場合、次の形式が適用されます。

   1. アドレスで使用できる `*` は 1 つのみです。
      + エントリが E メールアドレスの場合、`*` は @ の前または後である必要があります。
      + `*` がローカルパートにある場合、ローカルパートは を除く 0～19 文字にすることができます`*`。
      + `*` がドメインにある場合、サブドメインレベルは `*` を除いて 2～9 にすることができます。

   1. 有効なワイルドカード形式の例:
      + *\$1.domain1.com～\$1.domain8.domain7...domain1.com*
      + *\$1@domain.com から 1234567890123456789\$1@domain.com*
      + *local@\$1.domain1.com～local@\$1.domain8.domain7...domain1.com*

   ワイルドカードは、サブアドレス拡張子 (およびアドレス指定) に関係なく、E メールアドレスを照合するために使用できます。例えば、 `user*@example.com`をアドレスリストに追加すると、、、 など`user`、ローカルパートが で始まる任意のアドレスと一致し`user@example.com``user+tag@example.com``username@example.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 コマンドを使用して CSV または JSON ファイルを S3 バケットにアップロードするには、この署名付き URL を使用します。

  ```
  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. アドレスを追加するには、**[E メールアドレスの追加]** を選択し、「[アドレスリストの作成と入力](#creating-address-lists)」で説明されているように、手動入力または一括アップロードのいずれかの方法で作業を進めます。

1. アドレスを削除するには、削除する各アドレスの横にあるチェックボックスをオンにし、**[E メールアドレスの削除]** を選択して削除を確認します。

1. (オプション) **[タグの管理]** を選択して、アドレスリストで **[タグ]** を追加または削除します。

の使用 AWS CLI:

**追加**

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

**削除**

```
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. 「*confirm*」と入力してリストの削除を確認し、**[削除]** を選択します。

の使用 AWS CLI:

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

## トラフィックポリシーとルールセットでのアドレスリストの使用
<a name="using-address-lists-in-traffic-policies-and-rule-sets"></a>

アドレスリストは、トラフィックポリシーステートメントとルール条件で使用して、E メールフローを制御するリストメンバーシップに基づいて E メールを処理できます。以下のセクションでは、各トラフィックポリシーとルールセットで使用中のアドレスリストの例を示します。

**Topics**
+ [トラフィックポリシーの例](#traffic-policy-example)
+ [ルールセットの例](#rule-set-example)

### トラフィックポリシーステートメントでのアドレスリストの使用
<a name="traffic-policy-example"></a>

アドレスリストは、イングレスエンドポイントへの E メールの受信を許可または拒否するようにトラフィックポリシーステートメントの条件を作成するときに選択できます。

次のコンソール手順と AWS CLI 同等の手順は、受信者が指定されたアドレスリストにある場合に、イングレスエンドポイントへのメッセージを許可するポリシーステートメントを作成する例を示しています。

**トラフィックポリシーステートメントでアドレスリストを使用するには:**

1. 「[トラフィックポリシーとポリシーステートメントの作成 (コンソール)](eb-filters.md#eb-filters-create-console)」で説明されているように、新しいトラフィックポリシーを作成するか、既存のトラフィックポリシーを編集します。

1. **[ポリシーステートメント]** コンテナで、ステートメントの条件が満たされたときに実行するアクションに対して **[許可]** を選択します。

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. これは 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 個のアドレスリストがサポートされています。
+ アドレスリストあたり最大 100,000 個のアドレスがサポートされています。