E-Mail-Konfiguration¶
Hier stellen Sie ein, über welchen Mailserver KCForms Mails verschickt:
Workflow-Benachrichtigungen, Mails aus Skripten (mail.send) und
Testnachrichten. Die Seite liegt unter System-Administration →
Schnittstellen & Verteilung → E-Mail-Konfiguration.
Die Einstellungen wirken nach dem Speichern sofort, ohne Neustart. Abbrechen lädt den gespeicherten Stand neu.
Mailserver¶
| Feld | Eintrag |
|---|---|
| Protokoll | SMTP für eine gewöhnliche Verbindung, meist mit STARTTLS auf Port 587 (oder ohne Verschlüsselung auf 25). SMTPS, wenn der Server von Anfang an verschlüsselt, üblicherweise auf Port 465 |
| Hostname | Name des Mailservers, z. B. smtp.example.com |
| Port | siehe Protokoll |
| Authentifizierung am Mailserver erforderlich? | Ja, wenn der Server eine Anmeldung verlangt; dann sind Benutzername und Passwort Pflicht |
| STARTTLS aktivieren? | bei SMTP auf Port 587 einschalten; die Verbindung wird dann nach dem Aufbau verschlüsselt |
Ein gespeichertes Passwort zeigt die Maske nur als Platzhalter an, nicht im Klartext. Lassen Sie das Feld unverändert, bleibt das alte Passwort erhalten. Leeren Sie es und speichern, wird es gelöscht.
Maske und Umgebungsvariablen
Beim Start kann der Mailserver auch über spring.mail.* bzw. die
Umgebungsvariablen SPRING_MAIL_HOST, SPRING_MAIL_PORT usw. vorgegeben
sein, bei der Docker-Installation über deren .env. Diese Werte gelten nur, solange in der Maske nichts
gespeichert ist. Was Sie hier speichern, gewinnt.
Adressen¶
| Feld | Wofür |
|---|---|
| Absender | Absenderadresse, wenn ein Skript keinen eigenen Absender angibt und der angemeldete Benutzer keine Mailadresse hat |
| Empfänger | Ziel der Testnachricht |
| Weiterer Empfänger 1 / 2 | gehen bei der Testnachricht in Kopie |
Absender: derselbe Wert wie in den System-Einstellungen
Absender hier und Default-Absenderadresse für Mails unter System-Einstellungen sind dieselbe Einstellung. Ändern Sie sie an einer Stelle, steht sie an der anderen ebenso.
Empfänger und die beiden weiteren Empfänger benutzt KCForms derzeit nur für die Testnachricht. Der Hinweis in der Maske nennt auch Systembenachrichtigungen; solche verschickt KCForms heute nicht.
Empfänger-Domain-Whitelist¶
Ein Sicherheitsnetz, damit keine Mail das Haus verlässt. Tragen Sie eine
oder mehrere Domains ein, durch Komma getrennt, etwa
example.com, example.de. Dann verschickt KCForms eine Mail nur, wenn
alle Empfänger, auch in Kopie und Blindkopie, auf einer dieser Domains
liegen. Sonst wird der Versand blockiert.
Das gilt für Mails aus Skripten, für Systemnachrichten und für die Testnachricht. Leer heißt: keine Beschränkung.
Auf Test- und Schulungssystemen einschalten
Wer mit Kopien echter Daten testet, verschickt sonst leicht eine Workflow-Mail an echte Antragsteller. Mit der eigenen Firmendomain in der Whitelist kann das nicht passieren.
Testen¶
Unten stehen zwei Knöpfe. Speichern Sie vorher, beide benutzen den gespeicherten Stand.
| Knopf | Was passiert |
|---|---|
| Testnachricht senden | verschickt sofort eine Mail an Empfänger (mit den weiteren Empfängern in Kopie). Klappt das nicht, erscheint die Fehlermeldung des Mailservers direkt auf der Seite. So prüfen Sie Server, Port, Anmeldung und Verschlüsselung |
| Testnachricht in Outbox einreihen | legt dieselbe Mail in die Warteschlange. Der Hintergrund-Dienst stellt sie zu, den Verlauf sehen Sie im E-Mail-Ausgang. So prüfen Sie den Weg, den auch Workflow-Mails nehmen |
Kommt die direkte Testnachricht an, die eingereihte aber nicht, liegt das Problem in der Warteschlange und nicht am Mailserver. Der E-Mail-Ausgang zeigt dann den Grund.
Zum Versand aus Skripten siehe mail.