Aller au contenu

Fournisseurs d'email

Amazon SES

Configurer Amazon SES comme fournisseur d'emails dans Notifuse.

Notifuse peut envoyer des emails via AWS Simple Email Service (SES).

Configuration

Allez dans Paramètres → Intégrations, cliquez sur Ajouter une intégration, puis choisissez Amazon SES sous Envoi d’emails. Le formulaire s’ouvre en pleine page.

Formulaire de l'intégration Amazon SES Paramètres Amazon SES

Champs du formulaire

ChampDescriptionExemple
RégionRégion AWS où se trouvent vos identités vérifiéesus-east-1
ID de clé d’accèsClé d’accès d’un utilisateur IAM autorisé à envoyer avec SESAKIAIOSFODNN7EXAMPLE
Clé d’accès secrèteClé d’accès secrète de cet utilisateur IAMwJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Isolation par tenantFacultatif. Donne à cette intégration son propre profil de réputation et sa propre liste de suppression (voir plus bas)Désactivé
Configuration setFacultatif, dans Avancé. Envoie via un configuration set que vous gérezmy-config-set
Tenant SESFacultatif, dans Avancé. Envoie via un tenant que vous gérezmy-tenant

Liste des expéditeurs

Ajoutez des adresses d’expéditeur vérifiées dans vos paramètres AWS SES :

ChampDescriptionExemple
NomNom affiché de l’expéditeurSupport Team
EmailAdresse email de l’expéditeursupport@yourdomain.com

Les expéditeurs doivent être vérifiés dans la console AWS SES avant de pouvoir être utilisés.

Types d’usage

Choisissez ce qu’envoie cette intégration Amazon SES depuis le menu ⋯ de sa carte dans Paramètres → Intégrations (Utiliser pour le marketing, Utiliser pour le transactionnel), ou dans le panneau Envoi d’emails de cette page :

OptionDescriptionExemples
Utiliser pour le transactionnelEmails générés par le système à la suite d’une action de l’utilisateurRéinitialisations de mot de passe, confirmations de commande, notifications de compte
Utiliser pour le marketingEmails promotionnels et newsletters envoyés aux abonnésAnnonces de produits, newsletters, campagnes promotionnelles

Choisissez les deux pour envoyer tous les types d’emails avec la même configuration SES.

Webhooks

Notifuse s’abonne automatiquement aux webhooks SES suivants :

Type de webhookDescriptionRôle
LivraisonEmail bien remisSuivre les livraisons réussies
RebondEmail rejetéSurveiller les rebonds
PlaintesLe destinataire a signalé un abusTraiter les signalements d’abus

Notifuse reçoit ces événements de livraison au moment où ils se produisent.

Isolation de la réputation (tenants SES)

Par défaut, tous les espaces de travail d’un compte AWS partagent une même réputation d’envoi et une seule liste de suppression. La campagne mal ciblée d’une équipe peut faire passer le taux de rebonds ou de plaintes du compte au-dessus des seuils d’AWS et suspendre les envois de tout le monde. Un rebond définitif dans un espace de travail place aussi ce destinataire dans la liste de suppression de tous les autres.

L’Isolation par tenant donne à une intégration son propre tenant SES, avec son profil de réputation, ses métriques de rebonds et de plaintes et sa liste de suppression. AWS peut alors suspendre un seul tenant au lieu du compte entier.

Note

En auto-hébergement, créer un nouveau tenant SES demande une clé de licence. Un tenant déjà créé continue d’envoyer avec sa propre réputation indéfiniment, sans clé : le chemin d’envoi ne vérifie pas la licence. Notifuse Cloud inclut l’isolation par tenant SES à partir de l’offre Starter (détails).

L’activer

Ouvrez l’intégration (Paramètres → Intégrations), activez l’Isolation par tenant dans le panneau Réputation, puis enregistrez. Notifuse vous demande de confirmer, car un tenant est une ressource AWS facturée, puis crée tout le nécessaire dans votre compte :

ÉtapeCe que fait Notifuse
Créer le tenantNommé notifuse-<integration ID>, avec SuppressionScope: TENANT pour les rebonds et les plaintes
Associer le configuration setRattache le configuration set par lequel cette intégration envoie
Associer les identitésRattache chaque identité vérifiée qui couvre un expéditeur : l’adresse exacte, son domaine ou un domaine parent

Enregistrer à nouveau relance les mêmes étapes. C’est ainsi qu’un expéditeur ajouté plus tard est associé, et qu’une exécution partielle est reprise.

Note

La suppression au niveau du tenant n’est pas le réglage par défaut d’AWS. Un tenant créé à la main dans la console SES hérite de la liste de suppression du compte si vous ne réglez pas vous-même la portée de suppression. Vous obtenez alors l’isolation de la réputation mais, sans aucun avertissement, pas celle de la suppression. Notifuse règle la portée à la création, et la corrige si un tenant du même nom existe déjà.

Note

L’isolation s’applique à l’intégration, pas à l’espace de travail. Un espace de travail qui utilise deux intégrations SES distinctes, l’une pour le marketing et l’autre pour le transactionnel, obtient deux tenants, chacun avec sa liste de suppression : une adresse en rebond sur l’une n’est pas bloquée par SES sur l’autre. La liste de suppression que Notifuse tient pour chaque espace de travail s’applique toujours aux deux, donc au pire un message de plus part vers une adresse que SES sait déjà mauvaise.

Ce que vous verrez

  • Un expéditeur sans identité vérifiée est signalé par son nom après l’enregistrement. Ses envois échoueraient avec ou sans tenant, corrigez-le donc.
  • Une permission IAM manquante est signalée avec l’action exacte et une commande aws CLI à lancer. Notifuse ne fait passer l’intégration sur le tenant qu’une fois son configuration set associé, car SES rejette tous les messages envoyés via un tenant qui n’en a pas. Une configuration partielle laisse l’envoi exactement comme il était.
  • La carte de l’intégration affiche le configuration set utilisé et indique si la réputation est isolated ou shared with the rest of this AWS account.

La désactiver

Désactiver l’Isolation par tenant prend effet au prochain envoi : les messages repartent sous la réputation partagée du compte. Le tenant reste dans AWS avec sa liste de suppression et son historique de réputation, et la réactivation reprend le même tenant.

Note

Un tenant dont l’isolation a été désactivée reste facturé jusqu’à la suppression de l’intégration. Désactivez-la pour changer votre façon d’envoyer ; supprimez l’intégration pour arrêter la facturation.

Attention

Supprimer l’intégration supprime le tenant, avec sa liste de suppression et son historique de réputation, qui ne peuvent pas être recréés. Retirer seulement les webhooks laisse les deux en place, car l’envoi en dépend toujours.

Avancé : utiliser votre propre tenant ou configuration set

Dans Avancé, les deux champs sont facultatifs et suggèrent les noms qui existent dans votre compte (ils deviennent de simples champs texte si vos identifiants ne permettent pas de les lister) :

ChampDescription
Configuration setEnvoie via un configuration set que vous gérez, au lieu de celui nommé notifuse-<integration ID>. Notifuse y rattache sa destination d’événements, mais ne le crée ni ne le supprime jamais.
Tenant SESEnvoie via un tenant que vous gérez vous-même. Incompatible avec l’interrupteur ci-dessus. Notifuse ne le crée, ne le modifie et ne le supprime pas.

Avec votre propre tenant, vous devez lui associer vous-même l’identité d’envoi et le configuration set, sinon SES rejette chaque envoi :

aws sesv2 create-tenant-resource-association \
  --tenant-name my-tenant \
  --resource-arn arn:aws:ses:<region>:<account>:configuration-set/<name>

Note

Les tenants n’existent que dans l’API SES v2, celle que Notifuse utilise désormais pour envoyer. Ils sont aussi propres à une région : un tenant se trouve dans la même région que son intégration.

Réponses entrantes (arrêt à la réponse)

Pour la Sortie à la réponse dans les automations, SES doit transmettre les réponses entrantes à Notifuse. SES traite le courrier reçu à part de l’envoi : vous le configurez donc une fois, en deux temps :

  1. Pointez les enregistrements MX de votre domaine vers SES. Ajoutez sur votre domaine d’envoi un enregistrement MX qui pointe vers le point d’entrée SES de réception de votre région, inbound-smtp.<region>.amazonaws.com (par exemple inbound-smtp.us-east-1.amazonaws.com), avec la priorité 10. Sans lui, les réponses n’arrivent jamais jusqu’à SES. SES n’a pas d’API DNS, vous le faites donc à la main.
  2. Enregistrez la route entrante. Dans Paramètres → Intégrations, ouvrez le menu ⋯ de l’intégration SES et choisissez Réenregistrer les webhooks (Enregistrer les webhooks s’ils ne sont pas encore enregistrés). En plus des webhooks d’événements de livraison, de rebond et de plainte, Notifuse crée un topic SNS (abonné en HTTPS à Notifuse, signé avec SignatureVersion 2) et une règle de réception SES avec une action SNS. Si votre compte a un ensemble de règles de réception actif, la règle est ajoutée dans celui-ci. Elle ne fait que transmettre une copie et n’a pas d’action stop, donc une configuration existante (comme Amazon WorkMail) continue de fonctionner. Notifuse crée et active un ensemble de règles dédié notifuse-inbound seulement si aucun ensemble de règles n’est actif.

Note

La réception d’emails SES n’existe que dans certaines régions AWS (par exemple us-east-1, us-west-2, eu-west-1). Si la région de votre intégration ne la prend pas en charge, l’enregistrement entrant est indiqué comme indisponible. Consultez la liste AWS des Email Receiving endpoints.

Le topic SNS entrant, la règle de réception et l’abonnement demandent des permissions IAM en plus de celles d’envoi : sns:CreateTopic, sns:SetTopicAttributes, sns:Subscribe, ses:DescribeActiveReceiptRuleSet, ses:CreateReceiptRuleSet, ses:CreateReceiptRule, ses:SetActiveReceiptRuleSet, ses:DeleteReceiptRule et ses:ListIdentities. La règle de réception ne couvre que les identités vérifiées de votre compte (domaines et adresses email). Si aucune n’est vérifiée, l’enregistrement entrant est refusé, pour que la règle ne transmette jamais tout le courrier du compte.

Les réponses sont rattachées à l’envoi d’origine par leur Message-ID. SES réécrit cet en-tête à l’envoi : Notifuse enregistre donc la valeur que SES renvoie et la fait correspondre quel que soit l’hôte, sans clé de signature entrante distincte. Avant d’être acceptée, chaque notification SNS entrante voit sa signature RSA vérifiée et doit être liée au topic créé : un message venant de tout autre topic SNS est rejeté, même avec une signature AWS valide. Le point d’entrée a une limite de débit.

Attention

Les configurations manuelles doivent renseigner l’ARN du topic SNS. Les messages entrants sont authentifiés par rapport au topic créé, donc une intégration sans ARN de topic lié rejette tout le courrier entrant. Si vous enregistrez les webhooks depuis le menu ⋯, Notifuse le renseigne pour vous. Si vous branchez la réception SES à la main (votre propre topic SNS + règle de réception), renseignez l’ARN du topic dans le paramètre inbound_topic_arn de l’intégration SES, sinon les réponses ne seront pas acceptées.

Une fois les deux étapes en place, un contact qui répond à un email d’automation quitte le parcours si cette automation a la Sortie à la réponse activée. Les rebonds et les réponses automatiques d’absence ne comptent jamais comme une réponse.

Prérequis

Il vous faut :

  1. Un compte AWS actif avec SES activé
  2. Des adresses email ou des domaines vérifiés dans la console AWS SES
  3. Un utilisateur AWS avec les permissions d’envoi SES (voir plus bas)
  4. L’accès production : sortez du sandbox SES pour envoyer sans restrictions

Permissions IAM

Seul le premier groupe est obligatoire. Chacun des autres active une fonction facultative, et Notifuse fonctionne sans lui : une permission manquante est signalée avec l’action à ajouter, jamais par un échec silencieux.

UsageActions
Envoi (obligatoire)ses:SendEmail
Webhooks d’événementsses:CreateConfigurationSet, ses:DescribeConfigurationSet, ses:ListConfigurationSets, ses:DeleteConfigurationSet, ses:CreateConfigurationSetEventDestination, ses:UpdateConfigurationSetEventDestination, ses:DeleteConfigurationSetEventDestination, sns:CreateTopic, sns:Subscribe, sns:GetTopicAttributes, sns:DeleteTopic
Isolation de la réputationses:CreateTenant, ses:GetTenant, ses:PutTenantSuppressionAttributes, ses:CreateTenantResourceAssociation, ses:ListEmailIdentities
Sélecteurs de noms et vérificationsses:ListTenants, ses:ListTenantResources
Suppression propreses:DeleteTenant, ses:DeleteTenantResourceAssociation
Réponses entrantesVoir la note sur l’arrêt à la réponse plus haut

Attention

Sans les permissions de suppression propre, supprimer une intégration laisse son tenant dans votre compte AWS, où il reste facturé jusqu’à ce que vous le supprimiez à la main.

Test

Cliquez sur Envoyer un e-mail de test en haut du formulaire de l’intégration, ou sur Envoyer un test sur sa carte, pour vérifier votre configuration.