ISPConfig/Automail
ISPConfig Automail - plugin zur automatischen Konfiguration von E-Mail-Clients
Beschreibung
Mit dem Plugin ISPConfig Automail kannst Du Email-Clients wie Thunderbird oder Outlook automatisch konfigurieren.
Ob Du einen oder mehrere Mailserver für die Domains verwendest, macht keinen Unterschied. Du definierst nur für jeden Mailserver die passenden Daten wie Hostname und Port; alles andere erfolgt durch eine kleine Webseite, die einen Autoconfig-Dienst (Thunderbird) oder Autodiscover-Dienst (Outlook) zur Verfügung stellt.
Autoconfig und Autodiscover fordern über unterschiedliche Adressen XML-Files an, mit denen dann der Email-Client nach Deinen Vorgaben konfiguriert wird.
Um den ISPConfig Automail nutzen zu können, brauchst Du nur eine aktuelle Version von ISPConfig und eine Webseite (Apache oder nginx).
Das Plugin besteht aus zwei Teilen
- die Erweiterung für ISPConfig zum Verwalten der Einstellungen
- ein Script, um die entsprechenden XML-Dokumente unter der jeweiligen Domain zu generieren.
In diesem Beispiel ist example.de Deine Domain, über die das automatische Einrichten der Mail-Clients laufen soll. Diese Domain kannst Du frei wählen. Die Domain kunde.de ist die Domain, die für die Einrichtung example.de abfragt.
- Thunderbird
- Outlook
Ob Sie einen oder mehrere Mailserver für die Domains verwenden, macht keinen Unterschied.
- Definieren Sie 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 eine
- aktuelle Version von ISPConfig
- 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.
- client.com ist die Domäne, die example.com für die Einrichtung abfragt.
Installation
cd /tmp wget https://download.schaal-it.net/ispconfig-automail.tgz tar xfz ispconfig-automail.tgz cd automail php install.php
Plugin aktivieren
- Melden Sie sich als admin bei ISPConfig an
- Gehen Sie zu System / CP User
- Aktivieren Sie das Modul automail für den Benutzer admin
- Nach der nächsten Anmeldung steht das Modul zur Verfügung
Remote-Benutzer
- Erstellen Sie einen Remote-Benutzer, der die „Automail-Funktionen“ verwenden kann.
- Bei einer Konfiguration mit mehreren Servern, auch den Fernzugriff zulassen.
Plugin Konfigurieren
- 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.
- Ports: Ports, die für Ihren Mailserver verwendet werden sollen.
Wenn Du SSL aktivierst, wird das eingerichtete Email-Programm eine verschlüsselte Verbindung aufbauen. Dazu muss das Zertifikat zwingend zum Hostnamen passen.
DNS-Einträge erstellen
- A/AAAA-Record für example.com
- autoconfig.example.com
- autodiscover.example.com
- Je Kundendomäne
autoconfig.client.com. CNAME autoconfig.example.com. _autodiscover._tcp.client.com. SRV 0 0 443 autodiscover.example.com.
Für die automatische Erkennung wird ein SRV-Eintrag empfohlen
- Dadurch erhalten Sie während der Einrichtung eine Zertifikatswarnung
- Es ist die einfachste Möglichkeit, beliebig viele Kundendomänen einzurichten
Website für ISPConfig:Automail
- 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 entsprechend setzen:
Apache
Serveralias 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.
Script auf der Webseite einrichten
- 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