Création de jeux de configuration dans SES

Vous pouvez utiliser la console SES, l'action CreateConfigurationSet dans l'API Amazon SES v2 ou la commande aws sesv2 create-configuration-set dans l'interface de ligne de commande Amazon SES v2 pour créer un jeu de configurations. Cette section explique comment créer des jeux de configuration à l'aide de la console SES et de l'interface de ligne de commande Amazon SES v2.

Créer un jeu de configurations (console)

Procédez de la manière suivante pour créer un jeu de configurations à l'aide de la console SES :

1. Connectez-vous à la console Amazon SES AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/ses/.

2. Dans le panneau de navigation, sous Configuration, choisissez Configuration sets (Jeux de configurations).

3. Choisissez Create set (Créer un jeu).

4. Entrez les détails suivants dans la section General details (Informations générales) :

   • Configuration set name (Nom du jeu de configurations) – Le nom pour le jeu de configurations. Le nom peut contenir jusqu'à 64 caractères alphanumériques : les lettres, les chiffres, les tirets (-) et les traits de soulignement (_) uniquement.

   • Sending IP pool (Envoi d'adresses IP) – Lorsque vous envoyez des e-mails à l'aide de ce jeu de configuration, les messages sont envoyés à partir des adresses IP dédiées du groupe affecté. Sélectionnez un groupe IP dans la liste.

     Note

     La valeur par défaut (ses-default-dedicated-pool) contient les adresses IP dédiées qui n'ont été attribuées à aucun autre pool. Pour en savoir plus sur les groupes d'adresses IP, consultez Attribuer des groupes d'adresses.

   • Options de suivi : cochez la case Utilisation d'un domaine de redirection personnalisé pour utiliser un domaine de redirection personnalisé pour gérer le suivi des ouvertures et des clics pour ce jeu de configurations, au lieu d'utiliser l'un des domaines SES.

     • Custom redirect domain – (Domaine de redirection personnalisé) — Avec un domaine de redirection personnalisé, vous pouvez entrer un sous-domaine personnalisé dans la zone (facultatif) ou sélectionner un domaine vérifié dans la liste.

     Note

     Les domaines de redirection personnalisés peuvent être spécifiés comme suit :

     • Les domaines de redirection doivent être configurés avant de choisir cette option. Pour plus d'instructions sur la sélection d'un domaine personnalisé pour gérer le suivi d'ouvertures et de clics, consultez Configuration de domaines personnalisés pour gérer le suivi des ouvertures et des clics.

     • Si vous souhaitez ensuite choisir d'utiliser un domaine de redirection personnalisé, vous devez l'indiquer lors de la création de votre jeu de configuration, ou ultérieurement en modifiant vos options de suivi pour le jeu de configuration.

   • Advanced delivery options (Options de livraison avancées) – Choisissez la flèche à gauche pour développer la section des options de livraison avancées.

     • Protocole TLS (Transport Layer Security) : pour demander à SES d'établir une connexion sécurisée avec le serveur de messagerie de réception et d'envoyer des e-mails à l'aide du protocole TLS, sélectionnez l'option Obligatoire.

       Note

       SES prend en charge TLS 1.2 et recommande TLS 1.3. Pour en savoir plus, veuillez consulter la section Sécurité de l'infrastructure dans SES.

5. Entrez les détails suivants dans la section Reputation options (Options de réputation) :

   • Mesures de réputation : utilisées pour suivre les indicateurs de rebond et de plainte CloudWatch pour les e-mails envoyés à l'aide de cet ensemble de configuration. (Des frais supplémentaires s'appliquent, voir Prix par métrique pour CloudWatch.)

     • Enabled (Activé) — Cochez cette case pour activer les métriques de réputation pour le jeu de configurations.

6. La section Suppression list options (Options de liste de suppression) fournit un ensemble de décisions permettant de définir une suppression personnalisée en commençant par l'option permettant d'utiliser ce jeu de configurations pour supplanter la suppression au niveau de votre compte. La carte logique de suppression au niveau du jeu de configurations vous aidera à comprendre les effets des combinaisons de remplacement. Ces sélections à plusieurs niveaux de remplacement peuvent être combinées pour implémenter trois niveaux de suppression différents :

   1. Use account-level suppression (Utiliser la suppression au niveau du compte) : ne remplace pas la suppression au niveau de votre compte et n'implémente aucune suppression au niveau du jeu de configurations. En fait, tout e-mail envoyé à l'aide de ce jeu de configurations utilisera simplement la suppression au niveau de votre compte. Pour cela :

      1. Dans Suppression list settings (Paramètres de la liste de suppression), décochez la case Override account level settings (Remplacer les paramètres au niveau du compte).

   2. Do not use any suppression (N'utiliser aucune suppression) : remplace la suppression au niveau de votre compte sans activer la suppression au niveau du jeu de configurations. Cela signifie que tout e-mail envoyé à l'aide de ce jeu de configurations n'utilisera aucune suppression au niveau de votre compte ; en d'autres termes, toute suppression est annulée. Pour cela :

      1. Dans Suppression list settings (Paramètres de la liste de suppression), cochez la case Override account level settings (Remplacer les paramètres au niveau du compte).

      2. Dans Suppression list (Liste de suppression), décochez la case Enabled (Activé).

   3. Use configuration set-level suppression (Utiliser la suppression au niveau du jeu de configurations) : remplace la suppression au niveau de votre compte par des paramètres de liste de suppression personnalisés définis dans ce jeu de configurations. Cela signifie que tout e-mail envoyé à l'aide de ce jeu de configurations utilisera uniquement ses propres paramètres de suppression et ignorera tous les paramètres de suppression au niveau du compte. Pour cela :

      1. Dans Suppression list settings (Paramètres de la liste de suppression), cochez la case Override account level settings (Remplacer les paramètres au niveau du compte).

      2. Dans Suppression list (Liste de suppression), cochez la case Enabled (Activé).

      3. Dans Specify the reason(s)... (Spécifiez la ou les raisons...), sélectionnez l'un des motifs de suppression à utiliser pour ce jeu de configurations.

7. La section Virtual Deliverability Manager options (Options Virtual Deliverability Manager) vous permet de définir des paramètres personnalisés concernant l'utilisation du suivi de l'engagement et de la livraison partagée optimisée par ce jeu de configurations en remplaçant leur définition dans vos paramètres de compte Virtual Deliverability Manager :

   1. Pour désactiver à la fois le suivi de l'engagement et la livraison partagée optimisée pour ce jeu de configurations :

      1. Cochez la case Override account level settings (Remplacer les paramètres au niveau du compte).

      2. Assurez-vous que la case Enabled (Activé) n'est pas cochée à la fois pour Engagement tracking (Suivi de l'engagement) et Optimized shared delivery (Livraison partagée optimisée), puis choisissez Save changes (Enregistrer les modifications).

   2. Pour activer ou désactiver le suivi de l'engagement et/ou la livraison partagée optimisée pour ce jeu de configurations, procédez comme suit :

      1. Cochez la case Override account level settings (Remplacer les paramètres au niveau du compte).

      2. Cochez ou décochez Enabled (Activé) pour Engagement tracking (Suivi de l'engagement) et/ou Optimized shared delivery (Livraison partagée optimisée), puis choisissez Save changes (Enregistrer les modifications).

   3. Pour revenir à vos paramètres de compte Virtual Deliverability Manager pour le suivi de l'engagement et la livraison partagée optimisée pour ce jeu de configurations :

      1. Décochez la case Override account level settings (Remplacer les paramètres au niveau du compte), puis choisissez Save changes (Enregistrer les modifications).

8. Vous pouvez ajouter une ou plusieurs balise (s) dans la section Tags (Balises). Répétez les étapes suivantes pour chaque balise que vous souhaitez ajouter à votre jeu de configurations.

   1. Sélectionnez Add new tag (Ajouter une nouvelle balise).

   2. Saisissez la clé de balise.

   3. Entrez la Valeur de balise (facultatif).

   Pour supprimer une balise que vous avez saisie, choisissez Remove (Supprimez) pour cette balise. Vous pouvez entrer jusqu'à 50 balises.

9. Choisissez Create set (Créer un jeu) pour créer votre jeu de configurations.

Maintenant que vous avez créé votre jeu de configurations, vous avez la possibilité de définir des destinations d'événements pour votre jeu de configurations, ce qui permet la publication d'événements déclenchée sur les types d'événements que vous spécifiez pour la destination de l'événement. Un jeu de configurations peut comporter plusieurs destinations d'événements avec plusieurs types d'événements définis. veuillez consulter Création de destinations d'événement Amazon SES.

Créer un jeu de configurations (AWS CLI)

Vous pouvez créer un jeu de configuration à l'aide d'un fichier JSON en entrée dans dans la commande aws sesv2 create-configuration-set dans AWS CLI.

1. Créer un fichier JSON d'entrée CLI

   Utilisez votre outil d'édition de fichier favori pour créer un fichier JSON avec les clés suivantes, ainsi que des valeurs valides pour votre environnement, ou utilisez la commande aws sesv2 create-configuration-set de l'API SES v2 avec l'option --generate-cli-skeleton sans valeur spécifiée pour imprimer un échantillon de la structure JSON sur la sortie standard.

   Cet exemple utilise un fichier nommécreate-configuration-set.json :

   {
       "ConfigurationSetName": "sample-configuration-set",
       "TrackingOptions": {
           "CustomRedirectDomain": "some.domain.com"
       },
       "DeliveryOptions": {
           "TlsPolicy": "REQUIRE",
           "SendingPoolName": "sending pool"
       },
       "ReputationOptions": {
           "ReputationMetricsEnabled": true,
           "LastFreshStart": timestamp
       },
       "SendingOptions": {
           "SendingEnabled": true
       },
       "Tags": [
           {
               "Key": "tag key",
               "Value": "tag value"
           }
       ],
       "SuppressionOptions": {
           "SuppressedReasons": ["BOUNCE","COMPLAINT"]
       }
   }

   Note

   • Vous devez inclure l'option file:// au début du chemin du fichier JSON.

   • Le chemin d'accès du fichier JSON doit suivre la convention appropriée pour le système d'exploitation de base sur lequel vous exécutez la commande. En effet, Windows utilise la barre oblique inverse ( \) pour faire référence au chemin du répertoire, et Linux utilise la barre oblique directe (/).

2. Exécutez la commande suivante en utilisant le fichier que vous avez créé en entrée.

   aws sesv2 create-configuration-set --cli-input-json file://create-configuration-set.json

Note

Pour consulter la AWS CLI référence de cette commande, consultez create-configuration-set.