MailMonkey: Installation

MailMonkey wird auf einem Server installiert (on-premise). Alle Benutzer greifen auf diesem per Weboberfläche zu.

Für die Installation des MailMonkeys benötigen Sie:

• Einen Windows-basierten Rechner, welcher als Server dient (ab Windows 7, Windows Server 2008 R2)
• Ein installiertes .NET-Framework 4.7.2
• Einen Windows-AD-User, unter welchem der appGenerics MailMonkey betrieben werden soll
• Einen aktivierten und erreichbaren Vertec XmlServer. Mehr dazu finden Sie unter https://www.vertec.com/de/support/kb/technik-und-datenmodell/vertecservice/xml/

1. Applikation kopieren

Erstellen Sie einen Installationsordner und kopieren Sie die Installationsdateien in diesen.

2. Applikation konfigurieren

Die Konfigurationsoberfläche des MailMonkeys ist webbasiert und benötigt einen freien TCP/IP Port. Im Auslieferungszustand ist Port 9001 per http vorkonfiguriert.

Falls Sie diesen ändern möchten, ist die Datei appGenerics.MailMonkey.MailMonkeyWindowsService.exe.config anzupassen:

<appSettings>
<add key="WebUIUrl" value="https://localhost:9001" />
<add key="VertecXmlServer" value="https://yourUrlToYourXmlServer/xml" />
<add key="VertecXmlAuthServer" value="https://yourUrlToYourXmlServer/auth/xml" />
<add key="AcceptSelfSignedSslCertificates" value="true" />
</appSettings>

WebUIUrl: hinterlegen Sie hier bitte die URL(s), unter welcher die Bedienoberfläche des MailMonkey erreichbar sein soll. Sie können hier http oder https nutzen. Wir empfehlen die Nutzung von https, da sonst alle Eingaben unverschlüsselt übermittelt werden. Weitere Infos zur Nutzung von SSL folgen weiter unten. Falls Ihre Installation im Netzwerk erreichbar sein soll, müssen Sie hier mindestens 2 URLs eintragen, z.B.: "https://localhost:9001, https://mailmonkey.meinedomain.de" (Kommasepariert).

VertecXmlServer: hier hinterlegen Sie die URL, unter welcher Ihr Vertec XML Server erreichbar ist.

VertecXmlAuthServer: hier hinterlegen Sie die URL, unter welcher Ihr Vertec XML Auth Server erreichbar ist.

3. Port-Freigabe für Nicht-Administratorkonten erlauben

Öffnen Sie eine Eingabeaufforderung mit Administratorrechten. Führen Sie folgenden Befehl aus, um den VertecMailConnector zu erlauben, den gewählten Port zu öffnen:

netsh http add urlacl url="https://localhost:9001/" user=jeder

Hinweise:

• Verwenden Sie hier die gleiche URL wie unter Punkt 1 (WebUIUrl)
• Sollten Sie mehrere URLs konfiguriert haben, dann müssen Sie den Befehl für jede URL absetzen
• Auf englischen Windows-Installationen müssen Sie "user=everyone" nutzen, da die Systemkonten anders benannt sind

4. Windows-Dienst installieren

Öffnen Sie eine Eingabeaufforderung mit Administratorrechten. Wechseln Sie in das Installationsverzeichnis.

Führen Sie folgenden Befehl aus:

appGenerics.MailMonkey.MailMonkeyWindowsService.exe -install

Führen Sie folgenden Befehl aus:

services.msc

Suchen Sie den installierten Windows-Dienst mit dem Namen "appGenerics VertecMailMonkey". Klicken Sie mit der rechten Maustaste und wählen Sie anschließend "Eigenschaften".

Hinterlegen Sie die korrekten Anmeldedaten Ihres vorbereiteten Windows-Users im Reiter "Anmelden".

Wir empfehlen den Starttyp "Automatisch (Verzögerter Start)".

5. Generierung eines SSL-Zertifikats

Es steht Ihnen frei ein selbst signiertes Zertifikat oder von einer CA signiertes Zertifikat zu verwenden.

• So generieren Sie sich ein eigenes selbst signiertes Zertifikat:
• Installieren Sie OpenSSL (Für Windows: https://sourceforge.net/projects/openssl/)
• Führen Sie folgenden Befehl aus, um ein neues selbst signiertes Zertifikat zu erstellen:
  

  openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365

  Die Dateinahmen key.pem und cert.pem können Sie selbst frei wählen. Der Paramter days steuert, wie viele Tage Ihr Zertifikat gültig ist

• Führen Sie folgenden Befehl aus, um Ihr Zertifikat als pfx-Datei zu exportieren:
  

  openssl pkcs12 -export -out cert.pfx -inkey key.pem -in cert.pem

So fügen Sie ein bestehendes Zertifikat hinzu:

• Öffnen Sie als Windows-Administrator die Management Console (mmc.exe) und fügen Sie das Snap-In "Zertifikate (lokaler Computer)" hinzu
• Navigieren Sie zu "Eigene Zertifikate / Zertifikate"
• Wählen Sie hier "Alle Aufgaben" --> "Importieren"
• Mit einem Doppelklick auf ihr importiertes Zertifikat können Sie dessen Thumbprint einsehen

6. SSL-Zertifikat für MailMonkey konfigurieren

Öffnen Sie eine Eingabeaufforderungen als Administrator und führen Sie folgenden Befehl aus:

netsh http add sslcert ipport=0.0.0.0:9001 certhash=thumbprint appid={FD02966D-E5AF-40FE-9AC0-56679267A130}

Der Port muss dem Port entsprechen, den Sie unter Punkt 2 konfiguriert haben. Den Thumbprint können Sie aus Ihrem SSL-Zertifikat entnehmen (Siehe Punkt 5)

7. MailMonkey starten

Klicken Sie mit der rechten Maustaste auf den Windows-Dienst "appGenerics VertecMailMonkey" und wählen Sie anschließend "Starten". Es sollte keine Fehlermeldung erscheinen.

Öffnen Sie nun mit Hilfe eines Browsers die URL https://localhost:9001 (oder die unter Punkt 2 konfigurierte URL) um den MailMonkey zu konfigurieren und Ihre Lizenz zu hinterlegen.