Version vom 17. März 2022, 14:53 Uhr

ISPConfig Automail - plugin zur automatischen Konfiguration von E-Mail-Clients

Beschreibung

Thunderbird
Outlook

Ob Sie einen oder mehrere Mailserver für die Domains verwenden, macht keinen Unterschied.

Definieren Sie einfach die entsprechenden Daten wie Hostname und Port für jeden Mailserver.
alles andere wird über eine kleine Webseite erledigt, die einen Autoconfig-Dienst (Thunderbird) oder Autodiscover-Dienst (Outlook) bereitstellt.

Autoconfig und Autodiscover fordern XML-Dateien über verschiedene Adressen an, um den E-Mail-Client nach Ihren Vorgaben zu konfigurieren.

Um ISPConfig Automail nutzen zu können, benötigen Sie lediglich eine aktuelle Version von ISPConfig und eine Webseite (Apache oder nginx).

Das Plugin besteht aus zwei Teilen * das Schnittstellen-Plugin für ISPConfig, um die Einstellungen zu verwalten

ein Skript zum Generieren der relevanten XML-Dokumente unter der jeweiligen Domain

In diesem Beispiel ist example.com Ihre Domain, über die die automatische Einrichtung der Mailclients laufen soll. Diese Domain können Sie frei wählen. Die Domäne client.com ist die Domäne, die example.com für die Einrichtung abfragt.

Installieren Sie ISPConfig Automail

Aktivieren Sie das Plugin

Melden Sie sich als admin bei ISPConfig an
Ggehen Sie zu System / CP User
Aktivieren Sie das Modul automail für den Benutzer admin.
Nachdem Sie sich ab- und wieder angemeldet haben, steht Ihnen das Modul zur Verfügung.

Remote-Benutzer

Erstellen Sie einen Remote-Benutzer, der die „Automail-Funktionen“ verwenden kann.
Wenn Sie eine Konfiguration mit mehreren Servern haben, müssen Sie möglicherweise den Fernzugriff zulassen.

Konfigurieren Sie das Plugin

Unter Provider-ID geben Sie eine eindeutige ID ein, die Ihr Setup identifiziert.
Sie können den Domänennamen Ihres Servers verwenden.
Die beiden Hostnamen sind die Namen, unter denen Mails abgerufen (IMAP/POP3) und versendet (SMTP) werden. Wenn Sie alles auf demselben Server ausführen, müssen Sie in beiden Feldern denselben Namen eingeben.
Sie bei Ports die Ports ein, die für Ihren Mailserver verwendet werden sollen.

"ISPConfig Automailer-Setup"

Erstellen Sie die erforderlichen DNS-Einträge

Sie benötigen einen A-Record für autoconfig.example.com und autodiscover.example.com, der auf Ihren Webserver verweist.
Wenn Sie IPv6 verwenden, sollten Sie auch AAAA-Einträge erstellen.

Erstellen Sie zwei Einträge in jeder Kundendomäne. Für die Autokonfiguration reicht ein einfacher CNAME:

autoconfig.client.com.  CNAME autoconfig.example.com.

Für die automatische Erkennung wird ein SRV-Eintrag empfohlen. Dadurch erhalten Sie während der Einrichtung eine Zertifikatswarnung, aber es ist die einfachste Möglichkeit, beliebig viele Kundendomänen einzurichten:

_autodiscover._tcp.client.com.  SRV 0 0 443 autodiscover.example.com.

Erstellen Sie die Website in ISPConfig

Jetzt müssen Sie die Website autoconfig.example.com mit PHP-Unterstützung und ohne Auto-Subdomain in ISPConfig erstellen.
Sie sollten diese Seite auch mit SSL sichern.
Dies ist für die automatische Konfiguration nicht erforderlich, wird aber später für die automatische Erkennung benötigt. Sie können Let's Encrypt ganz einfach verwenden

Sie müssen die Anweisungen für Apache oder nginx entsprechend setzen:

Apache

Serveralias autoconfig.*

nginx

location ^~ /config\.php { alle ablehnen;  }
Lage / { 
autodiscover\.xml$ /index.php zuletzt neu schreiben; 
Autodiscover\.xml$ /index.php neu schreiben zuletzt; 
config-v1\.1\.xml$ /index.php neu schreiben zuletzt; 
}
Servername autoconfig.*;

Mit Alias oder Servername kann diese Domain später von beliebigen Kunden- oder E-Mail-Domains verwendet werden.

Erstellen Sie die Aliasdomäne autodiscover.example.com und verweisen Sie sie auf autoconfig.example.com.
Sie brauchen keine Weiterleitungen, wichtig ist, dass die Domain ein SSL-Zertifikat hat.
A-Records im DNS reichen aus, um auf Ihren Webserver zu verweisen, damit Sie Let's Encrypt verwenden können.

Upload the script to the webseite

Laden Sie die Dateien aus dem Website -Verzeichnis aus dem Archiv auf die neu erstellte Website hoch und passen Sie die Daten in der config.php an.
Benennen Sie die htaccess in .htaccess um. Wenn Sie nginx verwenden, können Sie die Datei auch direkt löschen.

Prüfen

Autoconfig

wget http://autoconfig.client.com/config-v1.1.xml?emailaddress=test@client.com -O test

Im Dateitest finden Sie das Ergebnis. Die E-Mail-Adresse muss natürlich existieren.

Autodiscover

Microsoft Remote Connectivity Analyzer.

ISPConfig Automail

@@ Zeile 1: / Zeile 1: @@
-Mit unserem Plugin '''ISPConfig Automail '''können Sie E-Mail-Clients wie Thunderbird oder Outlook automatisch konfigurieren.
+'''ISPConfig Automail''' - plugin zur automatischen Konfiguration von E-Mail-Clients
-Ob Sie einen oder mehrere Mailserver für die Domains verwenden, macht keinen Unterschied. Definieren Sie einfach die entsprechenden Daten wie Hostname und Port für jeden Mailserver. alles andere wird über eine kleine Webseite erledigt, die einen [https://developer.mozilla.org/en-US/docs/Mozilla/Thunderbird/Autoconfiguration Autoconfig-Dienst ](Thunderbird) oder [https://technet.microsoft.com/en-us/library/bb124251(v=exchg.160).aspx Autodiscover-Dienst ](Outlook) bereitstellt.
+= Beschreibung =
+* Thunderbird
+* Outlook
+Ob Sie einen oder mehrere Mailserver für die Domains verwenden, macht keinen Unterschied.
+* Definieren Sie einfach die entsprechenden Daten wie Hostname und Port für jeden Mailserver.
+* alles andere wird über eine kleine Webseite erledigt, die einen [https://developer.mozilla.org/en-US/docs/Mozilla/Thunderbird/Autoconfiguration Autoconfig-Dienst ](Thunderbird) oder [https://technet.microsoft.com/en-us/library/bb124251(v=exchg.160).aspx Autodiscover-Dienst ](Outlook) bereitstellt.
 Autoconfig und Autodiscover fordern XML-Dateien über verschiedene Adressen an, um den E-Mail-Client nach Ihren Vorgaben zu konfigurieren.
@@ Zeile 9: / Zeile 15: @@
 Das Plugin besteht aus zwei Teilen * das Schnittstellen-Plugin für ISPConfig, um die Einstellungen zu verwalten
 * ein Skript zum Generieren der relevanten XML-Dokumente unter der jeweiligen Domain
 In diesem Beispiel ist example.com Ihre Domain, über die die automatische Einrichtung der Mailclients laufen soll. Diese Domain können Sie frei wählen. Die Domäne client.com ist die Domäne, die example.com für die Einrichtung abfragt.
@@ Zeile 16: / Zeile 20: @@
 == Installieren Sie ISPConfig Automail  ==
-CD/tmp
- wget https://download.schaal-it.net/ispconfig-automail.tgz
- tar xfz ispconfig-automail.tgz
- CD-Automail
- php install.php
 == Aktivieren Sie das Plugin  ==
+# Melden Sie sich als admin bei ISPConfig an
-Melden Sie sich als admin bei ISPConfig an, gehen Sie zu '''System '''/ '''CP User '''und aktivieren Sie das Modul automail für den Benutzer admin. Nachdem Sie sich ab- und wieder angemeldet haben, steht Ihnen das Modul zur Verfügung.
+# Ggehen Sie zu '''System '''/ '''CP User '''
+# Aktivieren Sie das Modul automail für den Benutzer admin.
+# Nachdem Sie sich ab- und wieder angemeldet haben, steht Ihnen das Modul zur Verfügung.
 == Remote-Benutzer  ==
+* Erstellen Sie einen Remote-Benutzer, der die „Automail-Funktionen“ verwenden kann.
-Erstellen Sie einen Remote-Benutzer, der die „Automail-Funktionen“ verwenden kann. Wenn Sie eine Konfiguration mit mehreren Servern haben, müssen Sie möglicherweise den Fernzugriff zulassen.
+* Wenn Sie eine Konfiguration mit mehreren Servern haben, müssen Sie möglicherweise den Fernzugriff zulassen.
 == Konfigurieren Sie das Plugin  ==
+* Unter '''Provider-ID '''geben Sie eine eindeutige ID ein, die Ihr Setup identifiziert.
-Unter '''Provider-ID '''geben Sie eine eindeutige ID ein, die Ihr Setup identifiziert. Sie können den Domänennamen Ihres Servers verwenden.
+*  Sie können den Domänennamen Ihres Servers verwenden.
+* Die beiden '''Hostnamen '''sind die Namen, unter denen Mails abgerufen (IMAP/POP3) und versendet (SMTP) werden. Wenn Sie alles auf demselben Server ausführen, müssen Sie in beiden Feldern denselben Namen eingeben.
-Die beiden '''Hostnamen '''sind die Namen, unter denen Mails abgerufen (IMAP/POP3) und versendet (SMTP) werden. Wenn Sie alles auf demselben Server ausführen, müssen Sie in beiden Feldern denselben Namen eingeben.
+* Sie bei '''Ports '''die Ports ein, die für Ihren Mailserver verwendet werden sollen.
-Sie bei '''Ports '''die Ports ein, die für Ihren Mailserver verwendet werden sollen.
 [[Image:Bild1.png|top|alt="ISPConfig Automailer-Setup"]]
 == Erstellen Sie die erforderlichen DNS-Einträge  ==
+* Sie benötigen einen A-Record für autoconfig.example.com und autodiscover.example.com, der auf Ihren Webserver verweist.
-Sie benötigen einen A-Record für autoconfig.example.com und autodiscover.example.com, der auf Ihren Webserver verweist. Wenn Sie IPv6 verwenden, sollten Sie auch AAAA-Einträge erstellen.
+* Wenn Sie IPv6 verwenden, sollten Sie auch AAAA-Einträge erstellen.
 Erstellen Sie zwei Einträge in jeder Kundendomäne. Für die Autokonfiguration reicht ein einfacher CNAME:
+ autoconfig.client.com.  CNAME autoconfig.example.com.
-autoconfig.client.com.  CNAME autoconfig.example.com.
 Für die automatische Erkennung wird ein SRV-Eintrag empfohlen. Dadurch erhalten Sie während der Einrichtung eine Zertifikatswarnung, aber es ist die einfachste Möglichkeit, beliebig viele Kundendomänen einzurichten:
+ _autodiscover._tcp.client.com.  SRV 0 0 443 autodiscover.example.com.
-_autodiscover._tcp.client.com.  SRV 0 0 443 autodiscover.example.com.
 == Erstellen Sie die Website in ISPConfig  ==
+* Jetzt müssen Sie die Website autoconfig.example.com mit PHP-Unterstützung und ohne Auto-Subdomain in ISPConfig erstellen.
-Jetzt müssen Sie die Website autoconfig.example.com mit PHP-Unterstützung und ohne Auto-Subdomain in ISPConfig erstellen. Sie sollten diese Seite auch mit SSL sichern. Dies ist für die automatische Konfiguration nicht erforderlich, wird aber später für die automatische Erkennung benötigt. Sie können Let's Encrypt ganz einfach verwenden
+* Sie sollten diese Seite auch mit SSL sichern.
+* Dies ist für die automatische Konfiguration nicht erforderlich, wird aber später für die automatische Erkennung benötigt. Sie können Let's Encrypt ganz einfach verwenden
 Sie müssen die Anweisungen für Apache oder nginx entsprechend setzen:
 '''Apache '''
+ Serveralias autoconfig.*
-Serveralias autoconfig.*
 '''nginx '''
+ location ^~ /config\.php { alle ablehnen;  }
-location ^~ /config\.php { alle ablehnen;  }
   Lage / {
   autodiscover\.xml$ /index.php zuletzt neu schreiben;
@@ Zeile 74: / Zeile 69: @@
 Mit Alias oder Servername kann diese Domain später von beliebigen Kunden- oder E-Mail-Domains verwendet werden.
+* Erstellen Sie die '''Aliasdomäne '''autodiscover.example.com und verweisen Sie sie auf autoconfig.example.com.
-Erstellen Sie die '''Aliasdomäne '''autodiscover.example.com und verweisen Sie sie auf autoconfig.example.com. Sie brauchen keine Weiterleitungen, wichtig ist, dass die Domain ein SSL-Zertifikat hat. A-Records im DNS reichen aus, um auf Ihren Webserver zu verweisen, damit Sie Let's Encrypt verwenden können.
+* Sie brauchen keine Weiterleitungen, wichtig ist, dass die Domain ein SSL-Zertifikat hat.
+* A-Records im DNS reichen aus, um auf Ihren Webserver zu verweisen, damit Sie Let's Encrypt verwenden können.
 == Upload the script to the webseite  ==
+* Laden Sie die Dateien aus dem '''Website '''-Verzeichnis aus dem Archiv auf die neu erstellte Website hoch und passen Sie die Daten in der config.php an.
-Laden Sie die Dateien aus dem '''Website '''-Verzeichnis aus dem Archiv auf die neu erstellte Website hoch und passen Sie die Daten in der config.php an. Benennen Sie die htaccess in .htaccess um. Wenn Sie nginx verwenden, können Sie die Datei auch direkt löschen.
+* Benennen Sie die htaccess in .htaccess um. Wenn Sie nginx verwenden, können Sie die Datei auch direkt löschen.
 == Prüfen  ==
+=== Autoconfig ===
+ wget http://autoconfig.client.com/config-v1.1.xml?emailaddress=test@client.com -O test
-Sie können Autoconfig einfach über wget testen:
+Im Dateitest finden Sie das Ergebnis. Die E-Mail-Adresse muss natürlich existieren.
-wget http://autoconfig.client.com/config-v1.1.xml?emailaddress=test@client.com -O test
+=== Autodiscover ===
+* [https://testconnectivity.microsoft.com/ Microsoft Remote Connectivity Analyzer].
-Im Dateitest finden Sie das Ergebnis. Die E-Mail-Adresse muss natürlich existieren.
-Für Autodiscover gibt es den [https://testconnectivity.microsoft.com/ Microsoft Remote Connectivity Analyzer ].
+# [https://schaal-it.com/ispconfig-automail/ ISPConfig Automail]
-# [https://schaal-it.com/ispconfig-automail/ ISPConfig Automail]
 [[Kategorie:Netzwerke:Mail:Server]]