Mail Server konfigurieren

Nach der initialen Installation eines WEEASY Appliance ist das Versenden von Mails durch WEEASY deaktiviert. Es ist jedoch dringend empfohlen einen entsprechenden Mail Server zu konfigurieren, so dass WEEASY z.B. zum Zurücksetzen des Passworts Mails versenden kann. Die dazu notwendigen Schritte sind auf dieser Seite beschrieben.

Voraussetzungen

Verbindungsdaten zum Mail Server, der verwendet werden soll
ROOT Rechte auf dem WEEASY Appliance

Konfigurationsparameter

Zur Mail-Konfiguration unterstützt WEEASY die folgenden Parameter.

Beispiele für die korrekte Konfiguration finden Sie in den unten stehenden Beispielen.

Name	Defaultwert / Beispiel	Beschreibung
`mailDisableSending`	`true`	Parameter deaktiviert das Senden von Mails. Der Parameter ist nach der Erstinstallation von WEEASY auf false gesetzt, da zu diesem Zeitpunkt noch keine Mail-Konfiguration vorgenommen wurde
`mailFrom`	`mail@weeasy.de`	Absender-E-Mail-Addresse. Diese entspricht zumeinst dem User, mit dem auch die Anmeldung am SMTP-Server erfolgt
`mailFromPersonal`	`WEEASY`	Klartext Beschreibung des Absenders
`mailSmtpAuth`	`true`	Parameter gibt an, ob am verwendeten SMTP-Server eine Anmeldung erforderlich ist. true bedeutet, dass eine Anmeldung notwendig ist. In diesem Fall müssen die Parameter mailSmtpUser und mailSmtpPassword gesetzt sein.
`mailSmtpUser`	`mail@weeasy.de`	Benutzer für die Anmeldung am SMTP-Server, sofern dieser eine Anmeldung erfordert. Ist keine Anmeldung erforderlich so kann der Parameter leer bleiben. Der Parameter ist in der Datenbank in verschlüsselter Form gespeichert und wird bei einem eventuellen Select auch so angezeigt. Er kann aber via SQL im Klartext gesetzt werden. Änderungen werden dann verschlüsselt übernommen.
`mailSmtpPassword`	`xyz`	Passwort zur Anmeldung am SMTP-Server, sofern dieser eine Anmeldung erfordert. Ist keine Anmeldung erforderlich so kann der Parameter leer bleiben. Der Parameter ist in der Datenbank in verschlüsselter Form gespeichert und wird bei einem eventuellen Select auch so angezeigt. Er kann aber via SQL im Klartext gesetzt werden. Änderungen werden dann verschlüsselt übernommen.
`mailSmtpHost`		IP-Addresse oder Hostname des SMTP-Servers über den Mails verwendet werden sollen.
`mailSmtpPort`		Port für die Kommunikation mit dem SMTP-Server
`mailSmtpSendpartial`	`false`	Parameter gibt an, dass Mails auch nur teilweise gesendet werden können. Dieser Parameter sollte nur nach Rücksprache mit dem WEEASY Support angepasst werden. Standardmässig ist er daher auf false gesetzt.
`mailSmtpSslEnable`	`false`	Parameter gibt an, ob die Kommunikation mit dem SMTP-Server per SSL erfolgt. Bei Kommunikation per SSL muss der Parameter auf true gesetzt werden.
`mailSmtpStarttlsEnable`	`false`	Parameter gibt an, ob die Kommunikation mit dem SMTP-Server per STARTTLS erfolgt. Bei Kommunikation per SSL muss der Parameter auf true gesetzt werden.
`mailSessionJNDI`		Konfigurationsparameter zum Versenden von Mails via JNDI. Dieser Parameter sollte nur nach Rücksprache mit dem WEEASY Support angepasst werden. Standardmässig ist er daher nicht gesetzt.
`mailStoreProtocol`	`pop3`	Parameter konfiguriert das Protokoll für die Abfrage von Mails.
`mailTransportProtocol`	`smtp`	Parameter konfiguriert das Protokoll für das Versenden von Mails
`mailDebug`	`false`	Parameter schaltet das erweiterte Logging für Mails ein. Dies führt zu ausfühlichen Loginformationen beim Versenden von Mails. Daher sollte der Parameter nur bei Problemen auf true gesetzt werden

Durchführen der Konfiguration

In der aktuellen Version von WEEASY muss der Mail Server direkt über die Datenbank konfiguriert werden. Dazu müssen per SQL die folgenden Anpassungen vorgenommen werden. Die Änderungen werden innnerhalb von 5 Minuten ohne Neustart aktiv. Das Versenden von Mails durch WEEASY kann z.B. über den Loginscreen getestet werden, in dem dort die Passwort-Mail Funktion aufgerufen wird.

Konfigurationsbeispiele für die häufigsten Szenarien finden Sie hier:

Allgemeines Konfigurationsskript

Generisches Skript zur Mail-Konfiguration

# An lokaler MySQL Datenbank als User 'root' anmelden
mysql -u root weeasy_db


-- Mail-Versand aktivieren
UPDATE JEAF_PROPERTY SET VALUE='false' WHERE NAME='mailDisableSending';


-- Absender Information festlegen
UPDATE JEAF_PROPERTY SET VALUE='Absender der Mail z.B. weeasy@company.de' WHERE NAME='mailFrom';
UPDATE JEAF_PROPERTY SET VALUE='WEEASY Administrator' WHERE NAME='mailFromPersonal';


-- Zugangsdaten zu Mail-Server konfigurieren
UPDATE JEAF_PROPERTY SET VALUE='true' WHERE NAME='mailSmtpAuth';
UPDATE JEAF_PROPERTY SET VALUE='<User zum Versenden von Mails>' WHERE NAME='mailSmtpUser';
UPDATE JEAF_PROPERTY SET VALUE='<Passwort zum Versenden von Mails>' WHERE NAME='mailSmtpPassword';


-- Verbindung zu Mail-Server konfigurieren
UPDATE JEAF_PROPERTY SET VALUE='<URL des Mail Servers>' WHERE NAME='mailSmtpHost';
UPDATE JEAF_PROPERTY SET VALUE='<Port des Mail Servers>' WHERE NAME='mailSmtpPort';

-- Für den Fall, dass die Kommunikation mit dem Mail Server verschlüsselt erfolgt, so muss entweder TLS und SSL aktiviert werden.
-- Bei unverschlüsselter Kommunikation sind beide Werte auf false zu setzen
UPDATE JEAF_PROPERTY SET VALUE='false' WHERE NAME='mailSmtpStarttlsEnable';
UPDATE JEAF_PROPERTY SET VALUE='false' WHERE NAME='mailSmtpSslEnable';


-- Die folgenden Werte müssen unverändert übernommen werden und sollte nur nach Rücksprache mit dem Support verändert werden
UPDATE JEAF_PROPERTY SET VALUE='false' WHERE NAME='mailSmtpSendpartial';
UPDATE JEAF_PROPERTY SET VALUE='' WHERE NAME='mailSessionJNDI';
UPDATE JEAF_PROPERTY SET VALUE='pop3' WHERE NAME='mailStoreProtocol';
UPDATE JEAF_PROPERTY SET VALUE='smtp' WHERE NAME='mailTransportProtocol';


-- Erweitertes Logging kann für Fehleranalyse eingeschaltet werden. Ist Standardmässig jedoch deaktiviert.
UPDATE JEAF_PROPERTY SET VALUE='false' WHERE NAME='mailDebug';

Konfigurationsbeispiele

Interner SMTP-Server ohne Authentisierung (z.B. interner Microsoft Exchange Server)

Interner Mail Server soll für das Versenden von Mails verwendet werden
Die Kommunikation mit dem Mail Server ist unverschlüsselt
Der Mail Server erlaubt das anonyme Versenden von Mails
Mail Server ist z.B. Microsoft Exchange oder Lotus Domino

Beispiel-Skript für Zugriff auf SMTP-Server ohne Authentisierung (z.B. Interner Exchange Server)

-- An lokaler MySQL Datenbank als User 'root' anmelden
mysql -u root weeasy_db


-- Mail-Versand aktivieren
UPDATE JEAF_PROPERTY SET VALUE='false' WHERE NAME='mailDisableSending';


-- Absender Information festlegen
UPDATE JEAF_PROPERTY SET VALUE='<Absender der Mail z.B. weeasy@company.de>' WHERE NAME='mailFrom';
UPDATE JEAF_PROPERTY SET VALUE='WEEASY Administrator' WHERE NAME='mailFromPersonal';


-- Zugangsdaten zu Mail-Server konfigurieren
UPDATE JEAF_PROPERTY SET VALUE='false' WHERE NAME='mailSmtpAuth';
-- Login und Passwort sind nicht gesetzt da keine 
UPDATE JEAF_PROPERTY SET VALUE='' WHERE NAME='mailSmtpUser';
UPDATE JEAF_PROPERTY SET VALUE='' WHERE NAME='mailSmtpPassword';


-- Verbindung zu Mail-Server konfigurieren
UPDATE JEAF_PROPERTY SET VALUE='<URL des Mail Server>' WHERE NAME='mailSmtpHost';
UPDATE JEAF_PROPERTY SET VALUE='25' WHERE NAME='mailSmtpPort';
UPDATE JEAF_PROPERTY SET VALUE='false' WHERE NAME='mailSmtpStarttlsEnable';
UPDATE JEAF_PROPERTY SET VALUE='false' WHERE NAME='mailSmtpSslEnable';


-- Die folgenden Werte müssen unverändert übernommen werden und sollte nur nach Rücksprache mit dem Support verändert werden
UPDATE JEAF_PROPERTY SET VALUE='false' WHERE NAME='mailSmtpSendpartial';
UPDATE JEAF_PROPERTY SET VALUE='' WHERE NAME='mailSessionJNDI';
UPDATE JEAF_PROPERTY SET VALUE='pop3' WHERE NAME='mailStoreProtocol';
UPDATE JEAF_PROPERTY SET VALUE='smtp' WHERE NAME='mailTransportProtocol';


-- Erweitertes Logging kann für Fehleranalyse eingeschaltet werden. Ist Standardmässig jedoch deaktiviert.
UPDATE JEAF_PROPERTY SET VALUE='false' WHERE NAME='mailDebug';

Externe Mail-Server bei Internetprovider (z.B. 1&1)

Externe Mail Server bei Internet Provider soll für das Versenden von Mails verwendet werden
Die Kommunikation mit dem Mail Server ist per SSL verschlüsselt
Der Mail Server erfordert Username und Passwort

Beispiel-Skript für Mail-Server bei Internetprovider (z.B. 1&1)

# An lokaler MySQL Datenbank als User 'root' anmelden
mysql -u root weeasy_db


-- Mail-Versand aktivieren
UPDATE JEAF_PROPERTY SET VALUE='false' WHERE NAME='mailDisableSending';


-- Absender Information festlegen
UPDATE JEAF_PROPERTY SET VALUE='<Absender der Mail z.B. weeasy@company.de>' WHERE NAME='mailFrom';
UPDATE JEAF_PROPERTY SET VALUE='WEEASY Administrator' WHERE NAME='mailFromPersonal';


-- Zugangsdaten zu Mail-Server konfigurieren
UPDATE JEAF_PROPERTY SET VALUE='true' WHERE NAME='mailSmtpAuth';
UPDATE JEAF_PROPERTY SET VALUE='<User zum Versenden von Mails>' WHERE NAME='mailSmtpUser';
UPDATE JEAF_PROPERTY SET VALUE='<Passwort zum Versenden von Mails>' WHERE NAME='mailSmtpPassword';


-- Verbindung zu Mail-Server konfigurieren
UPDATE JEAF_PROPERTY SET VALUE='smtp.1und1.de' WHERE NAME='mailSmtpHost';
UPDATE JEAF_PROPERTY SET VALUE='465' WHERE NAME='mailSmtpPort';

-- Für den Fall, dass die Kommunikation mit dem Mail Server verschlüsselt erfolgt, so muss entweder TLS und SSL aktiviert werden.
-- Bei unverschlüsselter Kommunikation sind beide Werte auf false zu setzen
UPDATE JEAF_PROPERTY SET VALUE='false' WHERE NAME='mailSmtpStarttlsEnable';
UPDATE JEAF_PROPERTY SET VALUE='true' WHERE NAME='mailSmtpSslEnable';


-- Die folgenden Werte müssen unverändert übernommen werden und sollte nur nach Rücksprache mit dem Support verändert werden
UPDATE JEAF_PROPERTY SET VALUE='false' WHERE NAME='mailSmtpSendpartial';
UPDATE JEAF_PROPERTY SET VALUE='' WHERE NAME='mailSessionJNDI';
UPDATE JEAF_PROPERTY SET VALUE='pop3' WHERE NAME='mailStoreProtocol';
UPDATE JEAF_PROPERTY SET VALUE='smtp' WHERE NAME='mailTransportProtocol';


-- Erweitertes Logging kann für Fehleranalyse eingeschaltet werden. Ist Standardmässig jedoch deaktiviert.
UPDATE JEAF_PROPERTY SET VALUE='false' WHERE NAME='mailDebug';

Mail-Versand via Office 365

Office 365 soll als Mail Server für das Versenden von Mails verwendet werden
Die Kommunikation mit dem Mail Server ist per TLS verschlüsselt
Der Mail Server erfordert Username und Passwort
Office 365 Benutzer benötigt eine Lizenz zum Versenden von Mails z.B. "Exchange Online Kiosk"

Beispiel-Skript für Mail-Versand via Office 365

# An lokaler MySQL Datenbank als User 'root' anmelden
mysql -u root weeasy_db


-- Mail-Versand aktivieren
UPDATE JEAF_PROPERTY SET VALUE='false' WHERE NAME='mailDisableSending';


-- Absender Information festlegen
-- Achtung: 'mailFrom' und der Loginname bei Offcie 365 müssen identisch sein.
UPDATE JEAF_PROPERTY SET VALUE='<Office 365 Login z.B. weeasy@company.de>' WHERE NAME='mailFrom';
UPDATE JEAF_PROPERTY SET VALUE='WEEASY Administrator' WHERE NAME='mailFromPersonal';


-- Zugangsdaten zu Mail-Server konfigurieren
UPDATE JEAF_PROPERTY SET VALUE='true' WHERE NAME='mailSmtpAuth';
UPDATE JEAF_PROPERTY SET VALUE='<Office 365 Login z.B. weeasy@company.de>' WHERE NAME='mailSmtpUser';
UPDATE JEAF_PROPERTY SET VALUE='<Passwort zum Versenden von Mails>' WHERE NAME='mailSmtpPassword';


-- Verbindung zu Mail-Server konfigurieren
UPDATE JEAF_PROPERTY SET VALUE='smtp.office365.com' WHERE NAME='mailSmtpHost';
UPDATE JEAF_PROPERTY SET VALUE='587' WHERE NAME='mailSmtpPort';

-- Für den Fall, dass die Kommunikation mit dem Mail Server verschlüsselt erfolgt, so muss entweder TLS und SSL aktiviert werden.
-- Bei unverschlüsselter Kommunikation sind beide Werte auf false zu setzen
UPDATE JEAF_PROPERTY SET VALUE='true' WHERE NAME='mailSmtpStarttlsEnable';
UPDATE JEAF_PROPERTY SET VALUE='false' WHERE NAME='mailSmtpSslEnable';


-- Die folgenden Werte müssen unverändert übernommen werden und sollte nur nach Rücksprache mit dem Support verändert werden
UPDATE JEAF_PROPERTY SET VALUE='false' WHERE NAME='mailSmtpSendpartial';
UPDATE JEAF_PROPERTY SET VALUE='' WHERE NAME='mailSessionJNDI';
UPDATE JEAF_PROPERTY SET VALUE='pop3' WHERE NAME='mailStoreProtocol';
UPDATE JEAF_PROPERTY SET VALUE='smtp' WHERE NAME='mailTransportProtocol';


-- Erweitertes Logging kann für Fehleranalyse eingeschaltet werden. Ist Standardmässig jedoch deaktiviert.
UPDATE JEAF_PROPERTY SET VALUE='false' WHERE NAME='mailDebug';