E-Mail-Anbieter einrichten (SMTP, AWS SES, Emailit)

Bereich: Einrichtung externer Dienste · Status: aktiv Verfügbar für: Betreiber

In einem Satz

Cofys verschickt alle E-Mails über einen von drei Anbietern; diese Anleitung zeigt, welche Zugangsdaten jeweils nötig sind.

Wofür brauche ich das?

• Buchungsbestätigungen, Erinnerungen und Massen-E-Mails sollen zuverlässig ankommen und nicht im Spam landen.

Wo finde ich es?

Konfiguration der Instanz: Instance::mailMode (Anbieter), Instance::mailSender (Absender), Zugangsdaten in AccessKeys.

So funktioniert es

SMTP (eigener Mailserver oder Mail-Hoster)

1. Zugangsdaten beim Mail-Hoster erfragen.
2. In AccessKeys::smtp eintragen, mailMode = SMTP.

Emailit

1. Im Kundenbereich von Emailit Credentials → Add credential wählen, Typ api.
2. Den API-Schlüssel kopieren – er wird nur einmal angezeigt.
3. In AccessKeys::emailit['access_key'] eintragen, mailMode = emailit.

AWS SES (Amazon Simple Email Service, Region Frankfurt)

1. Unter SES → Identities eine Identity vom Typ Domain anlegen, Use a custom MAIL FROM domain aktivieren (z. B. ses.example.org), Easy DKIM mit RSA 2048.
2. Die DNS-Einträge bei der eigenen Domain hinterlegen:
   • DKIM → Publish DNS records: alle CNAME-Einträge.
   • Custom MAIL FROM domain → Publish DNS records: MX- und TXT-Eintrag.
   • DMARC anpassen: _dmarc TXT v=DMARC1; p=none; adkim=r; aspf=r
   • Zusätzlich: default._bimi TXT v=BIMI1
3. Unter IAM → Users einen Benutzer anlegen und eine Policy nur zum Senden zuweisen:

   {
     "Version": "2012-10-17",
     "Statement": [{
       "Sid": "VisualEditor0",
       "Effect": "Allow",
       "Action": ["ses:SendEmail", "ses:SendRawEmail", "ses:SendBulkEmail"],
       "Resource": "*"
     }]
   }

4. Unter Security credentials → Access keys einen Schlüssel erzeugen (Use case: Third-party service).
5. access_key und secret_key in AccessKeys::aws eintragen, mailMode = AWS.

Einstellungen und Optionen

Anbieter	Parameter	Inhalt
SMTP	host	Adresse des Mailservers
	port	465 (SSL/SMTPS) oder 587 (STARTTLS)
	encryption	tls = STARTTLS, ssl = SMTPS, leer = keine
	username, password	SMTP-Zugang
Emailit	access_key	API-Schlüssel
	max_rate	Mails pro Sekunde (Drosselung)
AWS SES	access_key, secret_key	IAM-Zugangsschlüssel
	max_rate	Mails pro Sekunde, Standard 14; leer = ohne Drosselung
alle	Instance::mailSender	Absenderadresse (muss zur verifizierten Domain passen)

Was passiert automatisch?

Massen- und Cron-Mails laufen über die Warteschlange und werden gedrosselt versendet (siehe E-Mail-Versand).

Grenzen und Besonderheiten

• AWS SES ist fest auf die Region eu-central-1 (Frankfurt) eingestellt.
• Bei Emailit hieß der Parameter früher api_key; aktuell heißt er access_key.
• Im Entwicklungsbetrieb fängt Mailpit alle Mails ab.

Hängt zusammen mit

• E-Mail-Versand, Automatische E-Mails