Diese Seite ist eine maschinelle Übersetzung der englischen Seite, die maßgeblich ist. Englische Seite lesen
E-Mails versenden
Welche E-Mails der Server sendet, wie du den Versand konfigurierst und wie du mit Fehlschlägen und Abmeldungen umgehst. Die Einstellungen sind in der Konfigurationsreferenz aufgelistet. Die Abläufe für Nutzer bei E-Mail-Bestätigung und Zurücksetzen des Passworts stehen unter Registrierung und E-Mail-Bestätigung.
Was gesendet wird und wie du es konfigurierst
Abschnitt betitelt „Was gesendet wird und wie du es konfigurierst“Der Server sendet nie E-Mails innerhalb einer Anfrage. Er legt für jeden Zweck einen Job in derselben Transaktion an wie die Tatsache, die die E-Mail auslöst, und ein Job-Worker sendet sie. Ein Fehlschlag beim Senden zeigt sich nicht in der Antwort auf eine Registrierung oder ein Zurücksetzen: Dem Nutzer wird „we sent a confirmation email“ gesagt, und er fordert sie erneut an, wenn sie nicht ankommt.
| Klasse | Job-Typ | Kann der Nutzer sich abmelden? | |
|---|---|---|---|
Transaktional (transactional) |
Bestätigung der E-Mail-Adresse | identity.verification_email |
Nein |
| Transaktional | Zurücksetzen des Passworts | identity.password_reset_email |
Nein |
| Transaktional | Hinweis auf eine Passwortänderung oder Löschung | identity.password_notice_email |
Nein |
| Transaktional | Hinweis auf die Deaktivierung des Kontos, mit dem Datum seiner Löschung | identity.deactivation_email |
Nein |
| Transaktional | Einstellung des Dienstes (die Ankündigung, eine Datumsänderung, eine Absage, 7 Tage und 1 Tag vor dem Schließungsdatum, die Schließung und 7 Tage vor der Export-Frist) | identity.closure_email |
Nein |
Benachrichtigung (notification) |
Hinweis an Moderatoren (standardmäßig an, pro Art des Hinweises) | notification.moderator_email |
Ja |
Benachrichtigung (notification) |
Eine Benachrichtigung, die 15 Minuten ungelesen blieb: Erwähnungen, Follows, Boosts und die anderen Benachrichtigungen von anderen Nutzern sowie Hinweise der Moderatoren (standardmäßig aus, pro Art) | notification.email |
Ja |
Benachrichtigungs-E-Mails für Unterstützer (notification.supporter_email) laufen über dieselbe Job-Queue.
Welche Benachrichtigungen per E-Mail kommen
Abschnitt betitelt „Welche Benachrichtigungen per E-Mail kommen“Jeder Benutzer wählt pro Art von Benachrichtigung, ob sie in der App und per E-Mail ankommt, auf der Seite Benachrichtigungen der Einstellungen
(/settings/notifications im Webclient). Die Spalte E-Mail erscheint dort nur, solange der Server
E-Mails sendet. Eine Art, die in der App ausgeschaltet ist, wird gar nicht erst erzeugt und daher auch nicht per E-Mail oder Push gesendet.
| Art | E-Mail standardmäßig | Wann sie gesendet wird |
|---|---|---|
| Benachrichtigungen von anderen Benutzern (Erwähnungen, neue Follower, Folgeanfragen, angenommene Folgeanfragen, Boosts, Favoriten, Emoji-Reaktionen, Zitate, beendete Umfragen, Umzüge von Konten, denen du folgst, Sprachchats) | Aus | 15 Minuten nach der Benachrichtigung, nur wenn sie noch ungelesen ist (nicht als gelesen markiert, nicht verworfen) und noch sichtbar, und der Benutzer diese Art weiterhin per E-Mail erhält. Eine E-Mail pro Benachrichtigung |
| Veranstaltungen (Einladungen, bestätigte Termine, Änderungen von Datum oder Ort, Absagen, Erinnerungen und Beginn von Veranstaltungen auf diesem Server) | Aus | Wie oben, außer bei Erinnerungen, die sofort gesendet werden. Die E-Mail nennt Titel, Beginn und Organisatoren der Veranstaltung und nie, wo sie stattfindet |
| Hinweise der Moderatoren (eine Moderationsmaßnahme gegen das Konto, eine erledigte Meldung, ein entschiedener Einspruch, durch eine Sperrung verlorene Follows, eine entschiedene Anfrage für ein eigenes Emoji) | Aus | Wie oben |
| Hinweise an Moderatoren (neue Meldungen, auf Genehmigung wartende Registrierungen, Einsprüche, deaktivierte Webhooks, Anfragen für eigene Emojis, Umzüge eingeschränkter Konten, das Verstreichen des Schließungsdatums, neue und wiederkehrende Fehler), an die Leute, deren Rolle die Berechtigung hat | An | Sofort, ohne zu warten, bis sie gelesen wird |
| Schließung des Dienstes und die Hinweise zu Supporter-Tarifen | Immer | Sofort; sie lassen sich nicht ausschalten |
Benachrichtigungs-E-Mails gehen nur an die primäre Adresse des Benutzers, sobald sie bestätigt ist, und nie an eine Adresse, deren E-Mails gestoppt sind (siehe unten). Der Betreff der E-Mail einer Benachrichtigung von einem anderen Benutzer ist derselbe Text wie ihre Web-Push-Nachricht, und die E-Mail verlinkt auf den Beitrag, das Profil oder die Benachrichtigungen.
E-Mails zur Schließung des Dienstes gehen an jeden Benutzer, dessen primäre Adresse bestätigt ist. Eine zu verpassen, kann Datenverlust bedeuten, daher werden sie
als Transaktions-E-Mail gesendet, tragen keinen Abmeldelink und werden durch eine Beschwerde nicht gestoppt (ein Hard Bounce stoppt sie dagegen).
Die Ankündigung, eine Änderung des Datums, eine Absage und die Schließung reihen jeweils identity.closure_email_fanout in derselben
Transaktion wie ihren Datensatz ein. Der stündliche identity.queue_closure_reminders entscheidet, wann die Erinnerungen 7 Tage und
1 Tag vor dem Schließungsdatum und 7 Tage vor der Export-Frist gesendet werden. Eine Erinnerung, deren Zeitpunkt bei der Ankündigung der Schließung
schon vorbei war, wird nicht gesendet, weil die Ankündigungs-E-Mail die Daten nennt.
Der Fan-out-Job erfasst eine Zeile von service_closure_emails pro Benutzer und reiht identity.closure_email nur für die Benutzer ein, die er
erfassen konnte, sodass jeder Benutzer jede E-Mail einmal erhält, wie oft der Job auch läuft. Vor dem Senden prüft der Job, dass die E-Mail
noch gültig ist (dass sie nicht zu einer abgesagten Ankündigung oder einem inzwischen geänderten Datum gehört).
Die Einstellung mail wählt, wie E-Mails gesendet werden.
mail |
Verhalten |
|---|---|
none (Standard) |
Sendet nichts und schreibt mail not sent (mail = none) mit der Kategorie der Nachricht ins Server-Log. Mit profile = development enthält die Zeile außerdem die Adressen, den Betreff und den Text, Links eingeschlossen. Für Setups, die keine E-Mail nutzen, und für die Entwicklung |
smtp |
Sendet per SMTP-Submission. Es verlangt STARTTLS und prüft das Zertifikat, bevor es sich authentifiziert und sendet |
ses |
Sendet mit der Amazon-SES-v2-API (SendEmail mit Rohinhalt). Es authentifiziert sich über die Standard-Credential-Chain des AWS-SDK (zum Beispiel eine IAM-Rolle) und hält kein SMTP-Passwort |
plugin |
Übergibt jede Nachricht an ein Plugin, das du betreibst, für einen Mail-Dienst, der nur eine HTTP-API bietet |
Die Einstellungen von smtp sind mail_from, mail_smtp_host, mail_smtp_port (Standard 587), mail_smtp_username und mail_smtp_password. Die
Einstellungen von ses sind mail_from, mail_ses_region und mail_ses_configuration_set. Die Einstellungen von plugin sind mail_from
und plugin_mailer_address mit dem Rest von seinem Ziel.
mail_from ist eine reine Adresse wie noreply@social.example. From wird zu "<server name>" <mail_from>, und die Domain
von mail_from ist auch die Domain von Message-ID und die, auf die SPF, DKIM und DMARC wirken (siehe unten).
Reply-To ist die Instanzeinstellung contact_email, wenn sie gesetzt ist (Instanzeinstellungen).
Jede E-Mail trägt Auto-Submitted: auto-generated.
smtp und ses bauen dieselbe Nachricht. SMTPUTF8 wird nicht verwendet, daher werden Adressen in ASCII gesendet und internationalisierte Domains
in Punycode umgewandelt. An eine Adresse, deren lokaler Teil (vor dem @) nicht ASCII ist, kann nicht gesendet werden, und ihr Job schlägt fehl.
Beispiele nach Anbieter
Abschnitt betitelt „Beispiele nach Anbieter“Übergib Secrets per Umgebungsvariable oder Datei (MY_MAIL_SMTP_PASSWORD oder MY_MAIL_SMTP_PASSWORD_FILE). Schreibe sie nicht in die
Konfigurationsdatei.
Amazon SES (API)
Abschnitt betitelt „Amazon SES (API)“Wenn du auf AWS läufst, nutzt mail = ses die SES-v2-API. Die Zugangsdaten kommen aus der Standardkette des AWS SDK (die Task-Rolle von
ECS, Umgebungsvariablen, die gemeinsame Konfigurationsdatei), daher gibt es kein Secret zu konfigurieren.
- Verifiziere in SES die Domain von
mail_fromals Identität und aktiviere Easy DKIM (siehe unten). - Beantrage den Produktionszugriff, um die Sandbox zu verlassen. In der Sandbox kannst du nur an verifizierte Adressen senden.
- Erlaube
ses:SendEmailfür die Ausführungsrolle auf der Identität vonmail_from(und auf dem Configuration Set, falls du eines nutzt).
E-Mails über Amazon SES versenden führt durch die Einträge, die Sandbox und die Beantragung des Produktionszugriffs und zeigt, was das OpenTofu-Modul für AWS davon übernimmt.
MY_MAIL=sesMY_MAIL_FROM=noreply@social.exampleMY_MAIL_SES_REGION=ap-northeast-1 # the region where you verified the identity; AWS_REGION when emptyMY_MAIL_SES_CONFIGURATION_SET=my-events # optional; a configuration set with event destinationsWenn mail_ses_configuration_set gesetzt ist, nutzt jede E-Mail dieses Configuration Set. SES überschreibt Message-ID und Date der
E-Mail mit eigenen Werten.
SES lehnt einen Empfänger beim Senden nie synchron ab. Es akzeptiert einen Versand an eine Adresse auf der Suppression-Liste des Kontos und
liefert ihn dann nicht aus, und der Bounce kommt später als Benachrichtigung (SNS) an.
Um Bounces und Beschwerden aufzuzeichnen, richte die SES-Benachrichtigungen unten so ein, dass sie über SNS ankommen.
Ein Plugin (mail = plugin)
Abschnitt betitelt „Ein Plugin (mail = plugin)“Betreibe für einen Maildienst, der nur eine HTTP-API anbietet, ein Plugin der Art mailer und lass es den Dienst aufrufen.
MY_MAIL=pluginMY_MAIL_FROM=noreply@social.exampleMY_PLUGIN_MAILER_ADDRESS=unix:///run/my/mailer.sockplugin_mailer_address ist bei diesem Wert erforderlich. Eine Nachricht kann ein Secret enthalten, etwa einen Bestätigungslink, daher
lehnt die Art http:// ab, auch auf Loopback: Nutze einen Unix-Socket oder https://. Der Server startet, ohne das Plugin aufzurufen, auch wenn es
ausgefallen ist, und die E-Mail wartet in ihrem Job.
Mit plugin_mailer_protocol = json, dem Standard, braucht ein Plugin nur einen HTTP-Server und eine JSON-Bibliothek
(Ein Plugin ohne Bibliothek). Send dauert höchstens 30 Sekunden oder plugin_mailer_timeout,
unter 5 Minuten. Eine Anfrage ist höchstens 2 MiB groß und eine Antwort höchstens 64 KiB.
POST /my.plugin.mailer.v1.MailerService/SendContent-Type: application/jsonConnect-Protocol-Version: 1
{ "category": "CATEGORY_NOTIFICATION", "to": "alice@example.com", "envelopeFrom": "noreply@social.example", "fromName": "My Server", "replyTo": "admin@social.example", "subject": "You have a new follower", "text": "Bob followed you.\n", "html": "<p>Bob followed you.</p>", "headers": { "List-Unsubscribe": "<https://social.example/unsubscribe?token=abc>", "List-Unsubscribe-Post": "List-Unsubscribe=One-Click" }}HTTP/1.1 200 OKContent-Type: application/json
{"outcome":"OUTCOME_RECIPIENT_REJECTED","enhancedStatus":"5.1.1"}Der Server prüft eine Nachricht, bevor er das Plugin aufruft, sodass sich über keines dieser Felder ein Header einschleusen lässt. Die Anfrage enthält die Teile der Nachricht, und das Plugin baut, was sein Dienst braucht:
- Das Plugin fügt drei Header hinzu: eine
Message-ID, die pro Nachricht eindeutig ist, auf der Domain vonenvelopeFrom; einDate; undAuto-Submitted: auto-generated, das verhindert, dass automatische Antworten in Schleifen laufen. Ein Dienst, der selbstMessage-IDundDateschreibt, deckt diese beiden ab. FromistfromNameundenvelopeFrom.fromName,replyTo,htmlundheaderskönnen fehlen.headersenthält nur die beidenList-Unsubscribe-Header.- Die Adressen sind UTF-8. Ein Plugin, dessen Dienst ASCII braucht, wandelt die Domain in Punycode um und antwortet mit
OUTCOME_INVALIDfür einen lokalen Teil, an den es nicht senden kann. - Dieselbe Nachricht kann zweimal kommen, da ein fehlgeschlagener Job wiederholt wird. Schreibe keine Nachricht in ein Log.
outcome sagt, was mit der Nachricht geschah:
outcome |
Bedeutung | Der Server |
|---|---|---|
OUTCOME_SENT |
Der Dienst hat die Nachricht angenommen | Schließt den Job ab |
OUTCOME_INVALID |
Sie lässt sich so nicht senden | Lässt den Job sofort fehlschlagen |
OUTCOME_RECIPIENT_REJECTED |
Die Adresse existiert nicht | Lässt den Job sofort fehlschlagen und unterdrückt die Adresse |
OUTCOME_REJECTED |
Der Dienst hat sie aus einem anderen Grund endgültig abgelehnt | Lässt den Job sofort fehlschlagen |
OUTCOME_TEMPORARY |
Der Dienst hat sie vorerst abgelehnt oder nicht geantwortet | Wiederholt den Job |
| Etwas anderes oder nichts | Wiederholt den Job |
Ein HTTP-Fehler oder das {"code":"unavailable"} von Connect mit dem passenden Status ist ebenfalls ein vorübergehender Fehlschlag.
enhancedStatus ist optional: der erweiterte Statuscode einer Ablehnung, etwa 5.1.1. Der Server behält einen Code der Klasse 5 bei einer
Ablehnung und der Klasse 4 bei OUTCOME_TEMPORARY und ignoriert alles andere. Er behält keinen Text von einem Plugin, also gib dort keinen Grund an:
Ein Grund gehört in das eigene Log des Plugins.
Der Server erfährt von einem Bounce nur aus dieser Antwort. Er hat keinen Endpunkt für die späteren Bounces und Beschwerden des Dienstes eines Plugins, daher unterdrückt ein Bounce, den der Dienst nachträglich meldet, die Adresse nicht.
Teste das Plugin mit der my-Binary:
my plugin test --kind mailer unix:///run/my/mailer.sockmy plugin test --kind mailer --mail-to you@example.com --mail-from noreply@social.example unix:///run/my/mailer.sockDer erste prüft nur, dass das Plugin antwortet, und sendet nichts. Der zweite sendet eine echte Nachricht an --mail-to und schickt dem
Plugin eine Anfrage ohne Empfänger, die es ablehnen muss. Der Server kann die Nachricht nicht sehen, nachdem das Plugin sie hat, also sieh dir
die an, die ankommt: Ihre Header müssen Message-ID, Date und Auto-Submitted: auto-generated enthalten.
Siehe Ein Plugin testen.
SES-Benachrichtigungen empfangen (SNS)
Abschnitt betitelt „SES-Benachrichtigungen empfangen (SNS)“SES-Bounces und -Beschwerden gehen an ein SNS-Topic, und ein HTTPS-Abo auf diesem Topic liefert sie an
POST /mail/events/ses des Servers.
Der Endpunkt öffnet sich nur, wenn mail_ses_sns_topic_arn gesetzt ist; sonst antwortet er mit 404.
- Lege ein Standard-SNS-Topic in derselben Region wie die SES-Identität an.
- Setze das Topic-Attribut
SignatureVersionauf2(SHA256withRSA). Eine Signatur mit dem Standardwert1wird nicht akzeptiert, und der Server antwortet mit400. - Erlaube in der Zugriffsrichtlinie des Topics
ses.amazonaws.comdasSNS:Publishaus deinem eigenen Konto (die SES-Konsole fügt das hinzu, wenn sie das Topic anlegt). - Richte die SES-Benachrichtigungen auf das Topic, auf eine der beiden Arten (der Server liest sowohl
notificationTypeals aucheventTypeim Body).- Identitätsbenachrichtigungen: Nutze dieses Topic für die Feedback-Benachrichtigungen „Bounce“ und „Complaint“ der Identität
mail_from. - Ereignisziel eines Configuration Sets: Füge dieses Topic als Ziel des Configuration Sets in
mail_ses_configuration_sethinzu, für die EreignistypenBOUNCEundCOMPLAINT.
- Identitätsbenachrichtigungen: Nutze dieses Topic für die Feedback-Benachrichtigungen „Bounce“ und „Complaint“ der Identität
- Setze
MY_MAIL_SES_SNS_TOPIC_ARNauf den ARN des Topics, prüfe mitmy config checkund starte neu. - Lege ein Abo auf dem Topic mit dem Protokoll
httpsund dem Endpunkthttps://<server host>/mail/events/sesan. Aktiviere nicht die Raw Message Delivery (ein Body ohne Signatur wird abgelehnt).
aws sns create-topic --region ap-northeast-1 --name my-ses-feedbackaws sns set-topic-attributes --region ap-northeast-1 \ --topic-arn arn:aws:sns:ap-northeast-1:123456789012:my-ses-feedback \ --attribute-name SignatureVersion --attribute-value 2aws ses set-identity-notification-topic --region ap-northeast-1 --identity social.example \ --notification-type Bounce --sns-topic arn:aws:sns:ap-northeast-1:123456789012:my-ses-feedbackaws ses set-identity-notification-topic --region ap-northeast-1 --identity social.example \ --notification-type Complaint --sns-topic arn:aws:sns:ap-northeast-1:123456789012:my-ses-feedback
MY_MAIL_SES_SNS_TOPIC_ARN=arn:aws:sns:ap-northeast-1:123456789012:my-ses-feedback # restart, then create the subscription below
aws sns subscribe --region ap-northeast-1 \ --topic-arn arn:aws:sns:ap-northeast-1:123456789012:my-ses-feedback \ --protocol https --notification-endpoint https://social.example/mail/events/sesWenn der Server die Abo-Bestätigung (SubscriptionConfirmation) erhält, sendet er ein GET an ihre SubscribeURL, um das Abo
zu bestätigen, und protokolliert SNS subscription of the SES notifications confirmed.
Prüfe mit aws sns list-subscriptions-by-topic, dass das Abo nicht mehr PendingConfirmation ist.
Bevor der Endpunkt eine Nachricht verwendet, prüft er alles Folgende. Schlägt etwas fehl, antwortet er mit 400 und zeichnet nichts auf.
TopicArnentsprichtmail_ses_sns_topic_arn.SignatureVersionist2und die Signatur ist gültig.- Die Zertifikat-URL der Signatur (
SigningCertURL) isthttps, und ihr Host istsns.<region>.amazonaws.comfür die Region des Topics. DieSubscribeURLeiner Abo-Bestätigung muss denselben Host haben.
Das Zertifikat wird mit dem ausgehenden HTTP-Client abgerufen, der vor SSRF schützt, und 24 Stunden im KV-Speicher zwischengespeichert. Der
Body wird bis zu 1 MiB gelesen, und ein größerer bekommt 413.
Wenn das Zertifikat nicht abgerufen werden kann, die Abo-Bestätigung fehlschlägt oder der Datensatz nicht geschrieben werden kann, antwortet der Endpunkt
mit 503 und überlässt SNS die Wiederholung. Er antwortet auch im Wartungsmodus mit 503.
Das sind die Benachrichtigungen, die er aufzeichnet. Er gleicht die Empfängeradresse mit der primären Adresse ab (ohne Beachtung der Groß- und Kleinschreibung, und eine Punycode-Domain passt auch in ihrer Unicode-Form); passt keine, tut er nichts.
| Benachrichtigung | Aufgezeichnet als |
|---|---|
Ein Bounce, dessen bounceType Permanent ist (jeder Untertyp wie General, NoEmail, Suppressed oder OnAccountSuppressionList) |
hard_bounce |
Eine Beschwerde (außer solchen, deren complaintFeedbackType not-spam ist) |
complaint |
Ein Bounce, der Transient oder Undetermined ist, und andere Benachrichtigungen wie Zustellung oder Versand |
Nicht aufgezeichnet (antwortet mit 200) |
Die SES-feedbackId ist der eindeutige Schlüssel eines Datensatzes, sodass es unabhängig davon, wie oft SNS dieselbe Benachrichtigung sendet, einen Datensatz gibt.
Amazon SES (SMTP-Schnittstelle)
Abschnitt betitelt „Amazon SES (SMTP-Schnittstelle)“Wenn du keine IAM-Zugangsdaten vergeben kannst, etwa wenn du außerhalb von AWS läufst, nutze die SES-SMTP-Schnittstelle mit mail = smtp. Bei diesem
Setup wird nur eine Ablehnung des Empfängers beim Senden als Unterdrückung aufgezeichnet
(Unterdrückung von Adressen, die keine E-Mails empfangen können).
- Verifiziere in SES die Domain von
mail_fromals Identität und aktiviere Easy DKIM (siehe unten). - Beantrage den Produktionszugriff, um die Sandbox zu verlassen. In der Sandbox kannst du nur an verifizierte Adressen senden.
- Erstelle SMTP-Zugangsdaten unter „SMTP settings“ in SES (diese unterscheiden sich von IAM-Zugriffsschlüsseln).
MY_MAIL=smtpMY_MAIL_FROM=noreply@social.exampleMY_MAIL_SMTP_HOST=email-smtp.ap-northeast-1.amazonaws.com # the endpoint of your SES regionMY_MAIL_SMTP_PORT=587 # STARTTLSMY_MAIL_SMTP_USERNAME=<user name of the SMTP credentials>MY_MAIL_SMTP_PASSWORD_FILE=/run/secrets/mail_smtp_passwordSES überschreibt Message-ID und Date mit eigenen Werten.
Ein allgemeiner SMTP-Submission-Server
Abschnitt betitelt „Ein allgemeiner SMTP-Submission-Server“Nutze das für deinen eigenen SMTP-Server wie Postfix oder für den Submission-Server eines E-Mail-Zustellanbieters.
MY_MAIL=smtpMY_MAIL_FROM=noreply@social.exampleMY_MAIL_SMTP_HOST=smtp.provider.example # a STARTTLS server whose certificate is valid for this nameMY_MAIL_SMTP_PORT=587MY_MAIL_SMTP_USERNAME=<user name> # empty for a server without authenticationMY_MAIL_SMTP_PASSWORD_FILE=/run/secrets/mail_smtp_passwordDer Server sendet nicht an einen Server, der kein STARTTLS anbietet oder dessen Zertifikat für den Namen in
mail_smtp_host nicht geprüft werden kann. Zugangsdaten werden erst nach STARTTLS gesendet.
Prüfe nach einer Änderung der Einstellungen mit my config check und starte neu.
SPF, DKIM und DMARC
Abschnitt betitelt „SPF, DKIM und DMARC“Gmail und Yahoo verlangen SPF, DKIM, DMARC und Ein-Klick-Abmeldung von Absendern, die am Tag viele E-Mails senden. Selbst bei kleinem
Volumen wird eine E-Mail ohne sie eher als Spam eingestuft.
Setze alle in den DNS der Domain von mail_from (zum Beispiel social.example), mit den Werten, die dein Anbieter dir nennt.
- SPF: Lege einen TXT-Eintrag auf der Domain an, der den Anbieter autorisiert, über den du sendest (wenn du zum Beispiel eine eigene SES-
MAIL-FROM-Domain nutzt, das
include:, das der Anbieter vorgibt, auf dieser Domain). - DKIM: Lege den öffentlichen Schlüssel, den der Anbieter ausstellt, im DNS ab und aktiviere das Signieren auf der Sendeseite. Bei SES sind das die drei Easy-DKIM-CNAME-Einträge. Der Server selbst signiert nicht, also signiert der Anbieter.
- DMARC: ein TXT-Eintrag bei
_dmarc.social.example. Beginne mitp=none, prüfe anhand der Aggregatberichte (rua=), dass SPF und DKIM übereinstimmen (zur From-Domain passen), und verschärfe dann aufquarantineundreject.
_dmarc.social.example. TXT "v=DMARC1; p=none; rua=mailto:dmarc@social.example"Um SPF bei SES in Übereinstimmung zu bringen, setze eine eigene MAIL-FROM-Domain (die Standard-MAIL-FROM ist amazonses.com, die nicht zur From-
Domain passt). Wenn DKIM übereinstimmt, besteht DMARC.
Sendefehler ansehen
Abschnitt betitelt „Sendefehler ansehen“Sendefehler siehst du auf der Jobs-Seite (/admin/jobs/list, Berechtigung manage_jobs; siehe
die Job-Queue und fehlgeschlagene Jobs).
Filtere nach Job-Typ, um nur E-Mail-Jobs zu sehen (in der Admin-API GET /api/v1/admin/jobs?type=identity.verification_email).
Die Typen stehen in der Tabelle oben.
- Vorübergehende Fehler (Verbindungsfehler, Timeouts, 4xx-Antworten) werden wiederholt. Transaktionale E-Mails werden 6-mal versucht (ein
exponentielles Backoff ab 30 Sekunden, insgesamt etwa 15 Minuten); Benachrichtigungs-E-Mails nutzen die Standardrichtlinie (10-mal, etwa
4 Stunden). Sind die Versuche aufgebraucht, wird der Job zu einem fehlgeschlagenen Job (Dead Job). Ein falsches
mail_smtp_host, eine fehlgeschlagene Authentifizierung und ein blockiertes Netzwerk zeigen sich hier. Führe ihn nach der Behebung der Ursache mitmy job retry <id>oder auf dem Jobs-Bildschirm erneut aus. - Endgültige Ablehnungen (ein 5xx für den Empfänger oder den Inhalt) werden nicht wiederholt und schlagen sofort fehl.
- Mit
mail = sesistMessageRejectedvon SES (der Inhalt wurde abgelehnt) eine endgültige Ablehnung.TooManyRequestsException(das Limit der Senderate),SendingPausedException,MailFromDomainNotVerifiedException,AccountSuspendedExceptionund Anfragen, die SES nicht erreichen, sind vorübergehende Fehler, und eine Wiederholung gelingt, sobald du das Konto oder die Berechtigungen behebst. Im Fehlertext bleibt nur der SES-Fehlercode erhalten. - Mit
mail = pluginentscheidet dasoutcomeder Antwort. Ein Plugin, das nicht erreichbar ist oder das mit einem Fehler antwortet, ist ein vorübergehender Fehler und zählt inmy.plugin.failures. Im Fehlertext bleiben nur das Outcome und der erweiterte Statuscode erhalten, daher steht der Grund eines Fehlers im Log des Plugins. - Eine transaktionale E-Mail, die älter ist als ein Zeitlimit ab ihrer Anforderung (15 Minuten bei einem Zurücksetzen, 1 Stunde bei einer Bestätigung), wird ohne Versand abgeschlossen. So kommen alte Links nicht verspätet an; das ist kein Fehler.
- Wenn der Job läuft und es keinen Grund zum Senden gibt (die Adresse ist unterdrückt, sie wurde inzwischen bestätigt oder der Nutzer hat die Berechtigung oder die Einstellung für die Benachrichtigung verloren), schließt er ohne Versand ab.
Eine Job-Payload enthält keine E-Mail-Adresse, keinen Text und kein Token, und ein Fehlertext ebenso wenig. Es bleiben nur IDs, der Job-Typ und der SMTP-
Antwortcode.
Ein erfolgreicher Versand lässt sich in der strukturierten job-Logzeile jedes Laufs verfolgen (my.job.type).
Unterdrückung von Adressen, die keine E-Mails empfangen können
Abschnitt betitelt „Unterdrückung von Adressen, die keine E-Mails empfangen können“Wenn der SMTP-Server sagt, dass die Empfängeradresse nicht existiert (ein 5xx auf RCPT TO mit einem erweiterten Status 5.1.x), zeichnet der
Server die Adresse als Hard Bounce auf und sendet nicht mehr an sie.
Mit mail = plugin zeichnet OUTCOME_RECIPIENT_REJECTED denselben Hard Bounce auf, und sonst nichts.
Mit mail = smtp wird nur diese Ablehnung beim Senden aufgezeichnet. Asynchrone Bounces, die zurückkommen, nachdem der SMTP-Server die E-Mail
angenommen hat, und Feedback-Loops für Beschwerden werden nicht empfangen.
Mit mail = ses lehnt SES einen Empfänger nie synchron ab, daher wird beim Senden nichts aufgezeichnet; endgültige Bounces und
Beschwerden werden aus den SES-Benachrichtigungen aufgezeichnet
(SES-Benachrichtigungen empfangen (SNS)).
| Art | E-Mail, die gestoppt wird |
|---|---|
hard_bounce |
Alles außer der Bestätigungs-E-Mail. Auch die E-Mail zum Zurücksetzen des Passworts wird gestoppt |
complaint (als Spam gemeldet) |
Benachrichtigungs- und Ankündigungs-E-Mails. Transaktionale E-Mails werden weiterhin gesendet |
- Moderatoren sehen die Art und die Herkunft einer Unterdrückung auf der Verwaltungsseite des Kontos in den Admin-Bildschirmen (
email_suppressioninGET /api/v1/admin/accounts/{id}). - Es gibt zwei Wege, sie aufzuheben. Wenn der Nutzer eine Bestätigungs-E-Mail anfordert und die Adresse erneut bestätigt, wird die Hard-Bounce-
Unterdrückung aufgehoben (die Bestätigungs-E-Mail wird auch gesendet, solange die Adresse unterdrückt ist). Der Nutzer fordert sie über die
Client-API an (
POST /api/v1/accounts/email/verification, höchstens 3 pro Stunde) oder auf der Statusseite der Anmeldung. Wenn du geprüft hast, dass das Senden in Ordnung ist, zum Beispiel weil das Postfach repariert wurde, hebt ein Moderator sie mitPOST /api/v1/admin/accounts/{id}/email_suppression/liftauf (Berechtigungmanage_accounts). Das zeichnetemail_suppression_liftedim Audit-Log auf (Moderation). - Für einen Nutzer, dessen E-Mail zum Zurücksetzen des Passworts gestoppt ist, stellt ein Administrator einen Zurücksetzungs-Link aus und übergibt ihn
(
my admin account password-reset-link @alice). - In den Einstellungen sehen Nutzer, dass E-Mails ihre primäre Adresse nicht erreichen, und seit wann.
Abmelden
Abschnitt betitelt „Abmelden“Benachrichtigungs-E-Mails tragen einen Abmeldelink und die Header List-Unsubscribe und List-Unsubscribe-Post: List-Unsubscribe=One-Click (RFC 8058). Die Schaltfläche „unsubscribe“ von E-Mail-Clients nutzt sie.
- Die Abmeldeklassen entsprechen eins zu eins den Zeilen der Benachrichtigungseinstellungen, deren E-Mail der Nutzer wählen kann, etwa
mentionoderadmin_report(eine pro Art des Hinweises an Moderatoren undmoderationfür die Hinweise der Moderatoren). - Der Link ist
https://{host}/mail/unsubscribe?token=...und braucht keine Anmeldung. Ein Token wird pro E-Mail ausgestellt, nur sein Hash wird in der Datenbank gespeichert, und er läuft nach 90 Tagen ab.GETzeigt nur einen Bestätigungsbildschirm und ändert nichts (damit Scanner, die Links vorab abrufen, die E-Mail nicht stoppen). Die Schaltfläche sendet dasselbePOST.POST(ein Klick) schaltet die E-Mail dieser Zeile der Benachrichtigungseinstellungen aus und sonst nichts. Bis das Token abläuft, liefert ein erneutes Senden dasselbe Ergebnis.
- Von transaktionalen E-Mails kann man sich nicht abmelden. Bestätigung, Zurücksetzen und der Hinweis auf eine Passwortänderung würden sicherheitsrelevante Hinweise am Ankommen hindern. Diese E-Mails tragen auch keine solchen Header.
- Nutzer können dieselbe Einstellung auf der Seite Benachrichtigungen in den Einstellungen umschalten.
Die HTML-Version
Abschnitt betitelt „Die HTML-Version“Jede E-Mail ist multipart/alternative mit demselben Inhalt als text/plain und text/html (beide UTF-8). Mit mail = none
im Profil development wird nur die Textversion ins Log geschrieben.
- Es gibt ein äußeres Layout mit Absätzen, Buttons und einer Signatur (Servername, URL, Kontakt, der Grund der E-Mail
und der Abmeldelink).
<html lang dir>stammt aus der Sprache des Empfängers, und Sprachen wiearwerden von rechts nach links gesetzt. - Es lädt keine externen Schriften oder Stylesheets und nutzt die Schriften des Systems. Die Farben stammen aus dem veröffentlichten
Theme (ohne eines aus den Standard-Design-Tokens), und hell und dunkel folgen
color-schemeundprefers-color-scheme. - Es lädt keine Bilder, außer dem eigenen Logo der Instanz, falls eines gesetzt ist (Logo und Icon):
Die HTML-Version beginnt dann mit dem Logo (
https://<host>/brand/..., stattdessen das dunkle Logo, wo der E-Mail-Client einem dunklen Farbschema folgt), für jeden Empfänger dieselbe URL, sodass sie nichts darüber verrät, wer die E-Mail geöffnet hat. Clients, die keine externen Bilder laden, zeigen stattdessen den Servernamen (den Alt-Text des Bildes). Ohne Logo oder wenn die Server-URL nichthttpsist, enthält die E-Mail kein Bild. - Nur
https-URLs werden zu Links. Ist eine URLhttp, etwa in einem Entwicklungs-Setup, in demweb_originhttp://{host}ist, wird die URL als Text geschrieben statt als Button oder Abmeldelink, und die Server-URL in der Signatur entfällt. - Das Layout ist Teil des Binärprogramms, daher läuft zur Laufzeit kein JavaScript im Server.
Für LLMs und Coding-Agenten:llms.txt,llms-full.txt, llms-small.txt