Bereich: Mail

###########################
# mail
###########################
# mail.default-recipient=
# mail.sender=
# mail.smtp=
 
LICENSE_EXPIRATION_WARNING_DAYS=30
LICENSE_EXPIRATION_MAIL_ADDRESS=unknown

# Optional caching policy for successful name lookups from the name service.
# Can be specified as number of seconds to cache the successful lookup, -1 indicates "cache forever".
# https://docs.oracle.com/javase/7/docs/technotes/guides/net/properties.html
networkaddress.cache.ttl=

mail.smtp

Spezifiziert einen SMTP-Mailserver. Dieser wird benötigt, da der Server nach der Auslieferung oder Generierung einer Website auf Wunsch eine E-Mail versendet, die über das Resultat berichtet.

mail.smtp.port

Mithilfe dieses Parameters kann angegeben werden, über welchen Port der SMTP-Server E-Mails versenden soll. Standardmäßig wird Port 25 verwendet.

mail.default-recipient

Angabe einer Standard-E-Mail-Adresse.

mail.sender

Angabe einer E-Mail-Adresse, die als Absender für alle Mails des FirstSpirit-Servers verwendet wird. Ist hier keine E-Mail-Adresse angegeben, wird eine E-Mail-Adresse mit folgendem Schema verwendet:
cmsserver@[Hostname]
wobei der Hostname über die Methode        
InetAddress.getLocalHost().getHostName();
ermittelt wird.

mail.subject.charset

Mithilfe dieses Parameters kann das Encoding für die Betreffzeile in von FirstSpirit versendeten E-Mails eingestellt werden.       
Standardmäßig wird ISO-8859-1 verwendet.

mail.mime.charset

Mithilfe dieses Parameters kann das Encoding für den Body in von FirstSpirit versendeten E-Mails eingestellt werden.                                
Standardmäßig wird das Encoding des Betriebssystems verwendet, das auf dem FirstSpirit-Server läuft.

mail.smtp.login

Mithilfe dieses Parameters kann ein Benutzer für die Authentifizierung beim Versenden von Mails per SMTP in FirstSpirit konfiguriert werden. Der hier konfigurierte Benutzer muss auf dem SMTP-Server bekannt sein.
Zusätzlich muss ein gültiges Passwort für diesen Benutzer über den Parameter mail.smtp.password (s.u.) konfiguriert werden.

mail.smtp.password

Mithilfe dieses Parameters kann ein Passwort für den Benutzer (vgl. mail.smtp.login, s.o.) konfiguriert werden.

Sind beide Parameter (mail.smtp.login und mail.smtp.password) konfiguriert, erfolgt der Mailversand von FirstSpirit über den bereitgestellten SMTP-Server über eine authentifizierte Verbindung. Sind die beiden Parameter nicht konfiguriert, erfolgt keine Authentifizierung.   

Weitere Konfigurationsmöglichkeiten

Weitere Parameter und Konfigurationsmöglichkeiten (z. B. für das Konfigurieren einer Verschlüsselung) für den Mailversand werden über die Java-Schnittstelle „Javamail“ zur Verfügung gestellt. Diese Parameter können in der fs-server.conf mit dem Präfix javamail versehen und anschließend verwendet werden, z. B.:

# enable SASL to support CRAM-MD5 authentication
javamail.mail.smtp.sasl.enable=true

Für die Nutzung einer verschlüsselten Verbindung zum SMTP-Server wird das Standardprotokoll TLSv1.2 verwendet. Sollte ein anderes Protokoll benötigt werden, kann dies über den Parameter

javamail.mail.smtp.ssl.protocols

definiert werden.

Eine SSL-verschlüsselte Kommunikation zum SMTP-Server kann über den Parameter mail.smtp.port sichergestellt werden, z. B.:

mail.smtp.port=587
javamail.mail.smtp.starttls.enable=true
javamail.mail.smtp.starttls.required=true

Hinweis: Änderungen an der Mailkonfiguration erfordern keinen Neustart des Servers.

Referenz zur Javamail-API:                                            
https://javamail.java.net/nonav/docs/api/com/sun/mail/smtp/package-summary.html

Konfiguration der JVM-Time-to-Live (TTL) für DNS Name Lookups

networkaddress.cache.ttl

Das Caching von DNS-Einträgen kann optional über den Parameter networkaddress.cache.ttl konfiguriert werden.

# Permanent Caching - Java Default Setting
networkaddress.cache.ttl=-1  

# Caching limited to a maximum of 60 seconds
networkaddress.cache.ttl=60 

Hintergrund: Die Java Virtual Machine (JVM) speichert DNS Name Lookups für einen bestimmten Zeitraum, bekannt als Time-to-Live (TTL), im Cache. Eine lange TTL ist dann problematisch, wenn sich die DNS-Namenseinträge ändern. Das kann beispielsweise beim Fail-Over (z. B. für den Mailversand) der Fall sein, wenn sich die IP-Adresse des SMTP-Servers ändert, oder auch im Cloud-Betrieb. Durch einen geringen TTL-Wert (beispielsweise 60 Sekunden) wird bei Änderung der IP-Adresse einer Ressource sichergestellt, dass der FirstSpirit-Server die neue IP-Adresse der Ressource durch erneute Abfrage des DNS abrufen und nutzen kann.

Der Standard-TTL-Wert ist abhängig von der eingesetzten JVM. Der Standard-TTL-Wert entspricht dem Wert des gleichnamigen Parameters in der Datei java.security des JDK bzw. -1, wenn kein entsprechender Wert gesetzt wurde. Im letzteren Fall (Wert ist -1) werden die DNS-Einträge bis zum nächsten Neustart der Java VM gecacht.

Der konfigurierte Wert wird beim Starten des Servers ausgelesen und mittels Security.setProperty entsprechend übernommen.

Ist der Parameter nicht gesetzt, wird der TTL-Wert aus dem JDK beibehalten.