Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Listes d'adresses
Les listes d'adresses sont une fonctionnalité du gestionnaire de courrier qui vous permet de créer et de gérer des listes d'adresses e-mail et de domaines que vous pouvez utiliser dans les politiques de trafic et les ensembles de règles pour traiter le courrier entrant selon que le destinataire ou l'expéditeur d'un message appartient ou non à une liste spécifique. Les listes d'adresses permettent un contrôle plus précis des flux de courrier électronique et contribuent à simplifier la gestion des scénarios complexes de routage des e-mails.
## Que sont les listes d'adresses ?
Les listes d'adresses sont des conteneurs d'adresses e-mail et de domaines que vous pouvez utiliser pour filtrer et traiter les e-mails. Ils constituent un moyen pratique de regrouper les adresses associées et d'appliquer collectivement les règles de routage et les politiques de trafic.
Les principaux cas d'utilisation des listes d'adresses sont les suivants :
+ Listes de refus pour bloquer des expéditeurs ou des domaines de spam connus
+ Autoriser les listes pour garantir la livraison par des expéditeurs fiables
+ Validation des destinataires pour rejeter de manière anticipée les e-mails envoyés à des destinataires inexistants
+ Routage basé sur les rôles pour appliquer différentes règles en fonction des rôles des destinataires
+ Politiques basées sur les groupes pour appliquer les politiques à des groupes d'utilisateurs spécifiques
## Comment fonctionnent les listes d'adresses
Les listes d'adresses de SES rationalisent la gestion des e-mails en vous permettant de créer et de gérer des ensembles d'adresses e-mail et de domaines. Une fois créées, ces listes sont intégrées à vos flux de travail de messagerie par le biais de politiques et de règles de trafic.
Lorsque SES traite un e-mail, il vérifie la liste d'adresses correspondante pour déterminer si l'expéditeur ou le destinataire est membre. Sur la base de cette adhésion et de vos politiques et règles configurées, SES prend ensuite les mesures appropriées, telles que le routage, le filtrage ou le rejet de l'e-mail. Ce processus permet un contrôle efficace et granulaire de votre trafic e-mail.
## Configuration de listes d'adresses
**Topics**
+ [
### Création et remplissage d'une liste d'adresses
](#creating-address-lists)
+ [
### Gestion des listes d'adresses
](#managing-address-lists)
### Création et remplissage d'une liste d'adresses
La création d'une liste d'adresses dans la console consiste notamment à la renseigner avec une ou plusieurs adresses. À l'aide du gestionnaire de courrier APIs, vous pouvez créer des listes d'adresses vides et les remplir ultérieurement. Cette section vous montrera comment procéder à l'une ou l'autre à l'aide de procédures de console et AWS CLI d'exemples.
**Pour créer et remplir une liste d'adresses :**
1. Ouvrez la console SES à l'adresse [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).
1. Dans le volet de navigation, sous Mail Manager, sélectionnez **Listes d'adresses**.
1. Choisissez **Créer une liste d'adresses** et entrez un nom dans le champ **Nom de la liste d'adresses**.
1. Sélectionnez la **saisie manuelle** ou le **téléchargement groupé** et suivez les étapes correspondantes :
1. **Pour la saisie manuelle** : entrez une ou plusieurs adresses e-mail ou domaines dans la console.
Si vous utilisez le caractère générique astérisque (`*`), les formats suivants s'appliquent :
1. Un seul `*` est autorisé dans l'adresse :
+ Ce `*` doit être avant ou après @ lorsque l'entrée est une adresse e-mail.
+ Lorsqu'il `*` se trouve dans la partie locale, la partie locale peut comporter de zéro à 19 caractères, à l'exception du`*`.
+ Lorsqu'il `*` se trouve dans le domaine, le niveau du sous-domaine peut être compris entre 2 et 9, à l'exception du`*`.
1. Exemples de formats génériques valides :
+ *\$1.domain1.com vers \$1.domain8.domain7... domain1.com*
+ *\$1 @domain .com au 1234567890123456789\$1 @domain .com*
+ *local@\$1.domain1.com vers local@\$1.domain8.domain7... domain1.com*
1. **Pour le téléchargement groupé** : sélectionnez **Choisir un fichier** et choisissez un fichier CSV ou JSON sur votre ordinateur contenant les adresses à télécharger.
Utilisez le format indiqué dans l'exemple pour chaque type de fichier :
1. Exemple de fichier CSV (Notez que l'en-tête,`address`, est obligatoire. ) :
```
address
user1@domain.com
user2@*.domain.com
*@domain.com
```
1. Exemple de fichier JSON :
```
{
"items": [
{
"address": "user1@domain.com"
},
{
"address": "user2@*.domain.com"
},
{
"address": "*@domain.com"
}
]
}
```
1. Une fois que vous avez fini d'ajouter des adresses ou que vous avez sélectionné un fichier groupé, choisissez **Créer une liste d'adresses**.
En utilisant AWS CLI :
**Création de la liste d'adresses**
```
aws mailmanager create-address-list --address-list-name "MyDenyList"
```
**Renseignez la liste d'adresses :**
+ **Téléchargement unique**
```
aws mailmanager register-member-to-address-list \
--address-list-id al-123456789abc \
--address "user@example.com"
```
+ **Téléchargement groupé**
Pour les téléchargements groupés, vous devez d'abord créer une tâche d'importation en spécifiant un format CSV ou JSON :
```
aws mailmanager create-address-list-import-job \
--address-list-id "al-123456789abc" \
--name "MyImportJob" \
--import-data-format ImportDataType=CSV
```
Cela renvoie un identifiant de tâche et une URL pré-signée. Utilisez cette URL pré-signée pour télécharger votre fichier CSV ou JSON dans un compartiment S3, comme indiqué dans l'exemple suivant à l'aide de la commande curl :
```
curl -X PUT -T "/path/to/file" "pre-signed URL"
```
Après le téléchargement, lancez la tâche d'importation en utilisant l'ID de tâche renvoyé dans la commande précédente :
```
aws mailmanager start-address-list-import-job --job-id "job-123456789"
```
### Gestion des listes d'adresses
Vous pouvez mettre à jour, consulter et supprimer des listes d'adresses selon vos besoins.
**Topics**
+ [
#### Mettre à jour une liste d'adresses
](#updating-address-lists)
+ [
#### Afficher les détails de la liste d'adresses
](#viewing-address-lists)
+ [
#### Supprimer une liste d'adresses
](#deleting-address-lists)
#### Mettre à jour une liste d'adresses
Vous pouvez mettre à jour une liste d'adresses en ajoutant ou en supprimant des adresses, et éventuellement en ajoutant ou en supprimant des balises.
**Pour mettre à jour une liste d'adresses :**
1. Sur la page **Listes d'adresses**, sélectionnez le nom de la liste d'adresses que vous souhaitez modifier.
1. Pour ajouter des adresses, choisissez **Ajouter une adresse e-mail** et procédez à la saisie manuelle ou à la méthode de téléchargement groupé, comme expliqué dans[Création et remplissage d'une liste d'adresses](#creating-address-lists).
1. Pour supprimer des adresses, cochez la case à côté de chaque adresse que vous souhaitez supprimer, puis cliquez sur Supprimer l'**adresse e-mail** et confirmez la suppression.
1. (Facultatif) Ajoutez ou supprimez des **balises** à votre liste d'adresses en choisissant **Gérer les balises**.
En utilisant AWS CLI :
**Addition**
```
aws mailmanager register-member-to-address-list \
--address-list-id al-123456789abc \
--address "user@example.com"
```
**Supprimez**
```
aws mailmanager deregister-member-from-address-list \
--address-list-id al-123456789abc \
--address "user@example.com"
```
#### Afficher les détails de la liste d'adresses
Pour consulter les détails de la liste d'adresses :
+ Sur la page **Listes d'adresses**, sélectionnez le nom d'une liste d'adresses pour en afficher les détails.
En utilisant AWS CLI :
```
aws mailmanager list-members-of-address-list --address-list-id al-123456789abc
```
#### Supprimer une liste d'adresses
Pour supprimer une liste d'adresses :
1. Sur la page **Listes d'adresses**, sélectionnez le bouton radio à côté de la liste d'adresses que vous souhaitez supprimer, puis cliquez **sur Supprimer**.
1. Confirmez la suppression de la liste en tapant « *confirmer* » puis « **Supprimer** ».
En utilisant AWS CLI :
```
aws mailmanager delete-address-list --address-list-id al-123456789abc
```
## Utilisation de listes d'adresses dans les politiques de trafic et les ensembles de règles
Les listes d'adresses peuvent être utilisées dans les déclarations de politique de trafic et les conditions de règles pour traiter les e-mails en fonction de l'appartenance aux listes, ce qui permet de contrôler le flux d'e-mails. Les sections suivantes fournissent un exemple de listes d'adresses utilisées dans le cadre d'une politique de trafic et d'un ensemble de règles.
**Topics**
+ [Exemple de politique de trafic](#traffic-policy-example)
+ [Exemple d'ensemble de règles](#rule-set-example)
### Utilisation d'une liste d'adresses dans une déclaration de politique de trafic
Les listes d'adresses peuvent être sélectionnées lorsque vous créez les conditions d'une déclaration de politique de trafic pour autoriser ou refuser l'entrée d'e-mails sur votre point de terminaison d'entrée.
La procédure de console suivante et son AWS CLI équivalent montrent un exemple de création d'une déclaration de politique autorisant l'entrée de messages dans votre point de terminaison d'entrée si le destinataire figure dans la liste d'adresses spécifiée.
**Pour utiliser une liste d'adresses dans une déclaration de politique de trafic :**
1. Créez une nouvelle politique de trafic ou modifiez une politique existante comme expliqué dans [Création de politiques de trafic et de déclarations de politique (console)](eb-filters.md#eb-filters-create-console)
1. Dans le conteneur de la **déclaration de politique**, choisissez **Autoriser** pour que l'action soit entreprise lorsque les conditions de la déclaration sont remplies.
1. Construisez la condition de la déclaration comme suit :
+ Sélectionnez l'**adresse du destinataire** dans le champ **Protocole**.
+ Sélectionnez Se **trouve dans la liste d'adresses** pour le champ **Opérateur**.
+ Sélectionnez le nom de votre liste d'adresses dans le champ **Valeur**.
1. Bien qu'il ne s'agisse que d'un exemple, vous pouvez ajouter d'autres conditions de politique qui peuvent être basées sur divers opérateurs avec n'importe laquelle de vos listes d'adresses.
En utilisant 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"
}
}]
}]'
```
### Utilisation d'une liste d'adresses dans une règle
Les listes d'adresses peuvent être sélectionnées lorsque vous créez la condition d'une règle utilisée dans l'un de vos ensembles de règles pour déclencher l'action de la règle.
La procédure de console suivante et son AWS CLI équivalent montrent un exemple de création d'une règle qui invoque l'action de suppression si le destinataire figure dans la liste d'adresses spécifiée.
**Pour utiliser une liste d'adresses dans une condition de règle :**
1. Créez une nouvelle règle ou modifiez une règle existante comme expliqué dans [Création d'ensembles de règles et de règles (console)](eb-rules.md#eb-rules-create-console)
1. Dans le conteneur **Conditions de règle**, créez la condition de la règle comme suit.
+ Sélectionnez **Adresse du destinataire** dans le champ **Sélectionner une propriété**.
+ Sélectionnez Se **trouve dans la liste d'adresses** pour le champ **Sélectionner un opérateur**.
+ Sélectionnez le nom de votre liste d'adresses dans le champ **Valeur**.
1. Dans le conteneur **Actions**, choisissez **Ajouter une nouvelle action** et sélectionnez **Supprimer l'action**.
1. Bien qu'il ne s'agisse que d'un exemple, vous pouvez ajouter d'autres conditions de règle qui peuvent être basées sur différents opérateurs avec n'importe laquelle de vos listes d'adresses pour une variété d'actions à entreprendre.
En utilisant 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": {}
}]
}]'
```
## Bonnes pratiques et considérations
+ Faites attention à la taille des listes : les listes très volumineuses peuvent avoir un impact sur les performances.
+ Les listes d'adresses sont spécifiques au compte et ne peuvent être utilisées que dans le même AWS compte.
+ Les listes d'adresses imbriquées ne sont actuellement pas prises en charge.
+ Un maximum de 100 listes d'adresses par région est pris en charge.
+ Un maximum de 100 000 adresses par liste d'adresses est pris en charge.