Mailzustellung #

Diese Seite ist für Systemadministratoren, die Exponential-Websites an einen Maildienst anbinden, und für Support-Mitarbeitende, die die Meldung beantworten, dass die Mail zum Passwort nie angekommen ist. Sie beantwortet: welche Transporte Exponential hat, welche Einstellungen sie auswählen und konfigurieren, was die Mail-Einrichtung des Hosters bereitstellen muss und wie Sie eine Testkopie davon abhalten, echte Mail zu versenden.

Die Einstellungen stehen in settings/site.ini [MailSettings]; die Schritt-für-Schritt-Anleitung ist 10.4 Mail: der Datei-Transport und echter Versand. Einwilligung, Abmeldung und Bounces stehen auf Einwilligung und Bounces bei Mails.

Inhalt #

1. Was Mail versendet
2. Die drei Transporte
3. Einstellungen pro Kunde
4. Was der Hoster bereitstellen muss
5. Test- und Staging-Websites
6. Wenn Mail nicht ankommt
7. Checkliste

Was Mail versendet #

Exponential versendet Mail bei Passwortänderungen und -zurücksetzungen, Registrierungen, Formularen mit einem E-Mail-Empfänger, Benachrichtigungen und Newslettern. Jede Mail passiert die Mail-Sperre in eZMailTransport::send(), welcher Transport auch genutzt wird; die Sperre prüft optionale Mail gegen die Einstellungen des Empfängers (E-Mail-Einstellungen). Benachrichtigungen werden vom Cronjob-Teil frequent versendet; Mail, die von ihnen abhängt, geht also nur raus, wenn Cron läuft (Cronjobs).

Die drei Transporte #

[MailSettings] Transport wählt einen; TransportAlias[] ordnet die Namen Klassen zu:

Einstellungen pro Kunde #

Schreiben Sie diese in die settings/override/site.ini.append.php jeder Installation. Ein SMTP-Beispiel aus dem Installationsbuch:

[MailSettings]
Transport=SMTP
TransportServer=smtp.example.com
TransportPort=587
TransportConnectionType=tls
TransportUser=<smtp user>
TransportPassword=<smtp password>
SenderHost=www.example.com
AdminEmail=[email protected]
EmailSender=[email protected]

Warnung TransportPassword ist ein Zugangsdatum in settings/override/. Halten Sie dieses Verzeichnis aus der Versionsverwaltung und aus allem heraus, was ein Kunde herunterlädt, und geben Sie jeder Kunden-Website eine eigene SMTP-Anmeldung, damit ein durchgesickertes Passwort nicht im Namen aller Kunden Mail versendet.

Was der Hoster bereitstellen muss #

Aus 10.4: Mail, die echte Postfächer erreichen soll, braucht eine Absenderadresse einer Domain, die Sie kontrollieren, mit SPF-Einträgen (und vorzugsweise DKIM und DMARC), die den sendenden Server erlauben, für jede Adressfamilie, von der der Server sendet: Wenn der Server über IPv6 sendet und der SPF-Eintrag nur IPv4-Adressen nennt, lehnen große Anbieter die Mail ab.

Für einen Hoster heißt das, pro Domain des Kunden:

• eine Absenderadresse (EmailSender) in einer Domain, die der Kunde kontrolliert, nicht localhost oder der eigene Name des Hosters;
• SPF, das das Relay oder den Server nennt, der sendet, über IPv4 und IPv6, wenn beides genutzt wird;
• DKIM-Signatur am Relay; die Checkliste der E-Mail-Einstellungen verlangt außerdem, dass Ihr Mailserver List-Unsubscribe und List-Unsubscribe-Post mit DKIM signiert;
• ein Bounce-Postfach, wenn der Kunde Newsletter versendet (Einwilligung und Bounces bei Mails).

Ein verwaltetes Relay mit vorbereiteten Einträgen anzubieten, ist ein natürlicher Teil eines Tarifs für Exponential-Hosting; ob es enthalten oder eine Option ist, entscheiden Sie.

Test- und Staging-Websites #

Eine Kopie einer Live-Website hat echte Adressen. Bevor sie läuft:

# settings/override/site.ini.append.php of the copy (or an EXP_ENV variant)
[MailSettings]
Transport=file

Jede Mail wird dann als <time>-<random>.mail nach var/log/mail/ geschrieben:

ls -lt var/log/mail/ | head

Alternativ stellt DebugSending=enabled mit DebugReceiverEmail=<test address> jede Mail an ein Testpostfach zu. Eine Variantendatei pro Maschine hält das aus den Live-Einstellungen heraus (Einstellungen je Umgebung). Lassen Sie auf einer Kopie auch die Crontab weg, sonst gehen Benachrichtigungen an echte Menschen (Wiederherstellung und Wiederherstellungstests).

Warnung Transport kann in mehreren Dateien gesetzt sein (der globalen Überschreibung, einem Siteaccess, einer Erweiterung), und eine Kopie behält sie alle. Prüfen Sie, welche Datei gewinnt, bevor Sie einer Testkopie vertrauen: ./console exp:ini where site.ini/MailSettings/Transport listet jede Datei auf, die ihn setzt, in Ladereihenfolge, und den wirksamen Wert (exp:ini).

Wenn Mail nicht ankommt #

Senden Sie einen Test, indem Sie das Passwort eines Testbenutzers ändern oder ein Formular mit einem E-Mail-Empfänger nutzen, und lesen Sie das Log des Mailservers. Setup > Systeminformationen hat eine Karte E-Mail mit dem wirksamen Transport.

Checkliste #

• To do: AdminEmail und EmailSender sind echte Adressen in der Domain des Kunden.
• To do: SMTP-Zugangsdaten gibt es pro Kunde, und sie liegen nur in settings/override/.
• To do: SPF deckt jede Adressfamilie ab, die der sendende Server nutzt; DKIM signiert; DMARC ist veröffentlicht.
• To do: Test- und Staging-Kopien nutzen den Datei-Transport oder DebugSending und führen keine Crontab aus.
• To do: frequent läuft, sodass Benachrichtigungen rausgehen.

Verwandte Seiten #

• Einwilligung und Bounces bei Mails
• Cronjobs
• Checkliste für den Start einer Kunden-Website
• Compliance und DSGVO
• E-Mail-Einstellungen: einrichten und betreiben
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.