Zum Inhalt springen

E-Mail-Anbieter

Amazon SES

Amazon SES als E-Mail-Anbieter in Notifuse einrichten.

Notifuse kann E-Mails über AWS Simple Email Service (SES) versenden.

Konfiguration

Öffnen Sie Einstellungen → Integrationen, klicken Sie auf Integration hinzufügen und wählen Sie unter E-Mail-Versand den Eintrag Amazon SES. Das Formular öffnet sich als eigene Seite.

Formular der Amazon-SES-Integration Einstellungen von Amazon SES

Formularfelder

FeldBeschreibungBeispiel
RegionAWS-Region, in der Ihre verifizierten Identitäten liegenus-east-1
Zugriffsschlüssel-IDZugriffsschlüssel eines IAM-Benutzers, der über SES senden darfAKIAIOSFODNN7EXAMPLE
Geheimer ZugriffsschlüsselDer geheime Zugriffsschlüssel dieses IAM-BenutzerswJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
MandantenisolierungOptional. Gibt dieser Integration ein eigenes Reputationsprofil und eine eigene Sperrliste (siehe unten)Aus
KonfigurationssatzOptional, unter Erweitert. Über einen Konfigurationssatz senden, den Sie selbst verwaltenmy-config-set
SES-MandantOptional, unter Erweitert. Über einen Mandanten senden, den Sie selbst verwaltenmy-tenant

Absenderliste

Fügen Sie Absenderadressen hinzu, die in Ihren AWS-SES-Einstellungen verifiziert sind:

FeldBeschreibungBeispiel
NameAnzeigename des AbsendersSupport Team
E-MailE-Mail-Adresse des Absenderssupport@yourdomain.com

Absender müssen in der AWS-SES-Konsole verifiziert sein, bevor Sie sie verwenden können.

Verwendungsarten

Was diese Amazon-SES-Integration versendet, legen Sie im Menü ⋯ ihrer Karte unter Einstellungen → Integrationen fest (Für Marketing verwenden, Für Transaktionales verwenden) oder im Bereich E-Mail-Versand derselben Seite:

OptionBeschreibungBeispiele
Für Transaktionales verwendenVom System erzeugte E-Mails, ausgelöst durch Aktionen der BenutzerZurücksetzen von Passwörtern, Bestellbestätigungen, Kontobenachrichtigungen
Für Marketing verwendenWerbe- und Newsletter-E-Mails an AbonnentenProduktankündigungen, Newsletter, Werbekampagnen

Wählen Sie beides, um alle Arten von E-Mails über dieselbe SES-Konfiguration zu senden.

Webhooks

Notifuse abonniert automatisch die folgenden SES-Webhooks:

Webhook-TypBeschreibungZweck
ZustellungE-Mail erfolgreich zugestelltErfolgreiche Zustellungen verfolgen
RückläuferE-Mail wurde zurückgewiesenBounces überwachen
BeschwerdenEmpfänger hat sich über Missbrauch beschwertMissbrauchsmeldungen bearbeiten

Notifuse erhält diese Zustellereignisse, sobald sie eintreten.

Reputationsisolierung (SES-Mandanten)

Standardmäßig teilen sich alle Arbeitsbereiche eines AWS-Kontos eine Absenderreputation und eine Sperrliste. Eine schlecht ausgerichtete Kampagne eines Teams kann die Bounce- oder Beschwerderate des Kontos über die Schwellenwerte von AWS treiben und den Versand für alle pausieren. Ein Hard Bounce in einem Arbeitsbereich sperrt den Empfänger außerdem in allen anderen.

Mandantenisolierung gibt einer Integration einen eigenen SES-Mandanten mit eigenem Reputationsprofil, eigenen Kennzahlen für Bounces und Beschwerden und eigener Sperrliste. AWS kann dann einen einzelnen Mandanten pausieren statt des ganzen Kontos.

Hinweis

Selbst gehostet: Um einen neuen SES-Mandanten einzurichten, brauchen Sie einen Lizenzschlüssel. Ein bereits eingerichteter Mandant sendet auch ohne Lizenzschlüssel dauerhaft über seine eigene Reputation weiter, denn der Versandweg enthält keine Lizenzprüfung. Notifuse Cloud enthält die SES-Mandantenisolierung ab dem Starter-Plan (Details).

Aktivieren

Öffnen Sie die Integration (Einstellungen → Integrationen), schalten Sie im Bereich Reputation die Mandantenisolierung ein und speichern Sie. Notifuse bittet Sie um Bestätigung, weil ein Mandant eine kostenpflichtige AWS-Ressource ist, und richtet dann alles in Ihrem Konto ein:

SchrittWas Notifuse tut
Mandant erstellenName notifuse-<integration ID>, mit SuppressionScope: TENANT für Bounces und Beschwerden
Konfigurationssatz verknüpfenVerknüpft den Konfigurationssatz, über den diese Integration sendet
Identitäten verknüpfenVerknüpft jede verifizierte Identität, die einen Absender abdeckt: die genaue Adresse, ihre Domain oder eine übergeordnete Domain

Wenn Sie erneut speichern, laufen dieselben Schritte noch einmal. So wird ein später hinzugefügter Absender verknüpft, und so wird ein unvollständiger Durchlauf wiederholt.

Hinweis

Eine Sperrliste pro Mandant ist bei AWS nicht die Voreinstellung. Ein Mandant, den Sie von Hand in der SES-Konsole anlegen, übernimmt die Sperrliste des Kontos, solange Sie den Geltungsbereich der Sperrliste nicht selbst festlegen. Sie bekommen dann ohne jede Warnung eine eigene Reputation, aber keine eigene Sperrliste. Notifuse legt den Geltungsbereich bei der Erstellung fest und korrigiert ihn, wenn bereits ein Mandant mit diesem Namen existiert.

Hinweis

Die Isolierung gilt pro Integration, nicht pro Arbeitsbereich. Ein Arbeitsbereich mit getrennten SES-Integrationen für Marketing und Transaktionales erhält zwei Mandanten mit je eigener Sperrliste: Ein Bounce, den der eine erfasst, wird beim anderen von SES nicht gesperrt. Die eigene Sperrung von Notifuse pro Arbeitsbereich gilt trotzdem für beide, sodass schlimmstenfalls eine zusätzliche Nachricht an eine Adresse geht, die SES bereits als ungültig kennt.

Was Sie sehen

  • Ein Absender ohne verifizierte Identität wird nach dem Speichern mit Namen gemeldet. Beheben Sie das, denn E-Mails dieses Absenders würden mit wie ohne Mandanten fehlschlagen.
  • Eine fehlende IAM-Berechtigung wird mit der genauen Aktion und einem aws-CLI-Befehl zum Ausführen gemeldet. Notifuse stellt die Integration erst auf den Mandanten um, wenn ihr Konfigurationssatz verknüpft ist, denn SES lehnt jede Nachricht ab, die ohne ihn über einen Mandanten gesendet wird. Bei einer unvollständigen Einrichtung bleibt der Versand genau so, wie er war.
  • Die Karte der Integration zeigt den verwendeten Konfigurationssatz und ob die Reputation isolated oder shared with the rest of this AWS account ist.

Deaktivieren

Wenn Sie die Mandantenisolierung ausschalten, gilt das ab dem nächsten Versand: Nachrichten gehen wieder unter der gemeinsamen Reputation des Kontos hinaus. Der Mandant bleibt mit seiner Sperrliste und seinem Reputationsverlauf in AWS bestehen, und wenn Sie sie wieder einschalten, wird derselbe Mandant weiterverwendet.

Hinweis

Ein Mandant, für den die Isolierung ausgeschaltet wurde, wird weiter abgerechnet, bis die Integration gelöscht wird. Schalten Sie die Isolierung aus, um die Art des Versands zu ändern, und löschen Sie die Integration, um die Kosten zu beenden.

Warnung

Wenn Sie die Integration löschen, wird der Mandant gelöscht, zusammen mit seiner Sperrliste und seinem Reputationsverlauf, die sich nicht wiederherstellen lassen. Entfernen Sie nur die Webhooks, bleiben beide erhalten, weil der Versand weiterhin von ihnen abhängt.

Erweitert: eigener Mandant oder eigener Konfigurationssatz

Unter Erweitert sind beide Felder optional und schlagen die Namen vor, die es in Ihrem Konto gibt (können Ihre Zugangsdaten sie nicht auflisten, bleiben es einfache Textfelder):

FeldBeschreibung
KonfigurationssatzÜber einen Konfigurationssatz senden, den Sie selbst verwalten, statt über notifuse-<integration ID>. Notifuse hängt sein Ereignisziel daran an, erstellt oder löscht ihn aber nie.
SES-MandantÜber einen Mandanten senden, den Sie selbst verwalten. Lässt sich nicht mit dem Schalter oben kombinieren. Notifuse erstellt, ändert oder löscht ihn nicht.

Mit einem eigenen Mandanten müssen Sie die sendende Identität und den Konfigurationssatz selbst mit ihm verknüpfen, sonst lehnt SES jeden Versand ab:

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

Hinweis

Mandanten gibt es nur in der SES API v2, über die Notifuse jetzt sendet. Sie sind außerdem an eine Region gebunden: Ein Mandant liegt in derselben Region wie seine Integration.

Eingehende Antworten (Stopp bei Antwort)

Für Bei Antwort verlassen in Automatisierungen muss SES eingehende Antworten an Notifuse weiterleiten. SES behandelt den E-Mail-Empfang getrennt vom Versand. Sie richten ihn einmalig in zwei Schritten ein:

  1. Richten Sie die MX-Records Ihrer Domain auf SES aus. Legen Sie auf Ihrer Absenderdomain einen MX-Record mit Priorität 10 an, der auf den SES-Eingangsendpunkt Ihrer Region zeigt, inbound-smtp.<region>.amazonaws.com (zum Beispiel inbound-smtp.us-east-1.amazonaws.com). Ohne ihn erreichen Antworten SES nie. SES hat keine DNS-API, daher erledigen Sie das von Hand.
  2. Registrieren Sie die Eingangsroute. Öffnen Sie unter Einstellungen → Integrationen das Menü ⋯ der SES-Integration und wählen Sie Webhooks erneut registrieren (Webhooks registrieren, falls sie noch nicht registriert sind). Zusätzlich zu den Ereignis-Webhooks für Zustellungen, Bounces und Beschwerden richtet Notifuse ein SNS-Topic ein (per HTTPS bei Notifuse abonniert, mit SignatureVersion 2 signiert) sowie eine SES-Empfangsregel mit einer SNS-Aktion. Hat Ihr Konto einen aktiven Empfangsregelsatz, wird die Regel in diesen eingefügt. Sie leitet nur eine Kopie weiter und hat keine Stop-Aktion, sodass eine bestehende Einrichtung (etwa Amazon WorkMail) weiter funktioniert. Einen eigenen Regelsatz notifuse-inbound erstellt und aktiviert Notifuse nur, wenn kein Regelsatz aktiv ist.

Hinweis

Den E-Mail-Empfang von SES gibt es nur in einigen AWS-Regionen (zum Beispiel us-east-1, us-west-2, eu-west-1). Unterstützt die Region Ihrer Integration ihn nicht, meldet die Eingangsregistrierung ihn als nicht verfügbar. Siehe die AWS-Liste der Endpunkte für den E-Mail-Empfang.

Das SNS-Topic für eingehende E-Mails, die Empfangsregel und das Abonnement brauchen IAM-Berechtigungen, die über den Versand hinausgehen: sns:CreateTopic, sns:SetTopicAttributes, sns:Subscribe, ses:DescribeActiveReceiptRuleSet, ses:CreateReceiptRuleSet, ses:CreateReceiptRule, ses:SetActiveReceiptRuleSet, ses:DeleteReceiptRule und ses:ListIdentities. Die Empfangsregel erfasst nur die verifizierten Identitäten Ihres Kontos (Domains und E-Mail-Adressen). Ist keine verifiziert, wird die Eingangsregistrierung verweigert, damit die Regel nie alle E-Mails des Kontos weiterleitet.

Antworten werden dem ursprünglichen Versand über ihre Message-ID zugeordnet. SES überschreibt diesen Header beim Versand. Notifuse speichert deshalb den Wert, den SES zurückgibt, und ordnet ihn unabhängig vom Host zu, ohne eigenen Signaturschlüssel für eingehende E-Mails. Bevor Notifuse einer eingehenden SNS-Benachrichtigung vertraut, wird sie per RSA-Signatur verifiziert und gegen das eingerichtete Topic geprüft: Eine Nachricht von einem anderen SNS-Topic wird abgelehnt, selbst mit gültiger AWS-Signatur. Der Endpunkt hat ein Ratenlimit.

Warnung

Bei manueller Einrichtung muss die ARN des SNS-Topics hinterlegt sein. Eingehende Nachrichten werden gegen das eingerichtete Topic authentifiziert, daher lehnt eine Integration ohne gebundene Topic-ARN alle eingehenden E-Mails ab. Wenn Sie die Webhooks über das Menü ⋯ registrieren, wird sie automatisch hinterlegt. Verbinden Sie den SES-Eingang von Hand (eigenes SNS-Topic + Empfangsregel), tragen Sie die Topic-ARN in der Einstellung inbound_topic_arn der SES-Integration ein, sonst werden Antworten nicht angenommen.

Sind beide Schritte erledigt, verlässt ein Kontakt, der auf eine E-Mail einer Automatisierung antwortet, die Journey, sofern bei dieser Automatisierung Bei Antwort verlassen aktiviert ist. Bounces und automatische Abwesenheitsnotizen zählen nie als Antwort.

Voraussetzungen

Sie benötigen:

  1. Ein aktives AWS-Konto mit aktiviertem SES
  2. In der AWS-SES-Konsole verifizierte E-Mail-Adressen oder Domains
  3. Einen AWS-Benutzer mit Sendeberechtigungen für SES (siehe unten)
  4. Produktionszugang: Verlassen Sie die SES-Sandbox, um ohne Einschränkungen zu senden

IAM-Berechtigungen

Nur die erste Gruppe ist erforderlich. Jede weitere Gruppe schaltet eine optionale Funktion frei, und Notifuse funktioniert auch ohne sie: Eine fehlende Berechtigung wird mit der hinzuzufügenden Aktion gemeldet und führt nie zu einem stillen Fehler.

ZweckAktionen
Versand (erforderlich)ses:SendEmail
Ereignis-Webhooksses:CreateConfigurationSet, ses:DescribeConfigurationSet, ses:ListConfigurationSets, ses:DeleteConfigurationSet, ses:CreateConfigurationSetEventDestination, ses:UpdateConfigurationSetEventDestination, ses:DeleteConfigurationSetEventDestination, sns:CreateTopic, sns:Subscribe, sns:GetTopicAttributes, sns:DeleteTopic
Reputationsisolierungses:CreateTenant, ses:GetTenant, ses:PutTenantSuppressionAttributes, ses:CreateTenantResourceAssociation, ses:ListEmailIdentities
Namensauswahl und Prüfungenses:ListTenants, ses:ListTenantResources
Sauberes Entfernenses:DeleteTenant, ses:DeleteTenantResourceAssociation
Eingehende AntwortenSiehe den Hinweis zu Stopp bei Antwort oben

Warnung

Ohne die Berechtigungen für sauberes Entfernen bleibt beim Löschen einer Integration ihr Mandant in Ihrem AWS-Konto zurück und wird weiter abgerechnet, bis Sie ihn von Hand entfernen.

Testen

Klicken Sie oben im Integrationsformular auf Test-E-Mail senden oder auf der Karte der Integration auf Test senden, um Ihre Konfiguration zu prüfen.