ISPConfig/Plugin/Automail

ISPConfig/Plugin/Automail - Automatischen Konfiguration von E-Mail-Clients

Beschreibung

ISPConfig Automail

• Email-Clients (Thunderbird, Outlook, ...) automatisch konfigurieren
• Einen oder mehrere Mailserver für Domains
• Definition von passenden Daten je Mailserver (Hostname, Port, ...)

Webseite stellt die Daten zur Verfügung

• Autoconfig (Thunderbird)
• Autodiscover (Outlook)

Autoconfig und Autodiscover

Email-Clients nach Vorgaben konfigurieren

• Unterschiedliche Adressen und unterschiedliche XML‑Files

Anforderungen

• aktuelle Version von ISPConfig
• Webseite (Apache oder nginx)

Architektur

Plugin-Teile

Erweiterung für ISPConfig	Verwalten der Einstellungen
Skript	um die entsprechenden XML-Dokumente unter der jeweiligen Domain zu generieren

Beispiel

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

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
 ISPConfig Automail module has been installed.

Konfiguration

Plugin aktivieren

1. An ISPConfig als admin anmelden
2. System /CP User anhlicken
3. Modul automail für den Benutzer admin aktivieren
4. Nach der nächsten Anmeldung steht das Modul zur Verfügung

Remote-Benutzer

1. Remote-Benutzer erstellen
   • Automail-Funktionen aktivieren
   • Fernzugriff zulassen, bei mehreren Servern

Plugin Konfigurieren

1. Unter Provider-ID geben Sie eine eindeutige ID ein, die Ihr Setup identifiziert.
2. Sie können den Domänennamen Ihres Servers verwenden.
3. Die beiden Hostnamen sind die Namen, unter denen Mails abgerufen (IMAP/POP3) und versendet (SMTP) werden.
4. Ports: Ports, die für Ihren Mailserver verwendet werden sollen.

Wenn SSL aktiviert ist, 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 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

Einrichten der Website in ISPConfig

autoconfig.example.de

Webseite in ISPConfig anlegen.

• PHP-Unterstützung
• keine Auto Subdomain
• SSL
  • für autodiscover benötigt notwendig

Optionen musst Du noch die Direktiven für Apache oder nginx entsprechend setzen

Apache

ServerAlias autoconfig.*

nginx

location ^~ /config\.php { deny all; }

location / { 
rewrite autodiscover\.xml$ /index.php last; 
rewrite Autodiscover\.xml$ /index.php last; 
rewrite config-v1\.1\.xml$ /index.php last; 
}
server_name autoconfig.*;

Durch Alias bzw. server_name kann diese Domain später auch von jeden Kunden bzw. jeder Email-Domain genutzt werden.

Jetzt legst Du die Aliasdomain autodiscover.example.de an und lässt diese auf autoconfig.example.de zeigen. Du brauchst dazu keine Redirects, wichtig ist nur, dass die Domain ein SSL-Zertifikat hat. Dazu reichen A-Records im DNS, die auf Deinen Webserver zeigen, damit Du Let’s Encrypt nutzen kannst.

Script auf der Webseite einrichten

1. Laden Sie die Dateien aus dem Website -Verzeichnis aus dem Archiv auf die neu erstellte Website hoch
2. config.php anpassen
3. Benennen Sie die htaccess in .htaccess um
   • Wird nginx verwendet, kann die Datei gelöscht werden

Weblinks

• Autoconfig-Dienst (Thunderbird)
• Autodiscover-Dienst (Outlook)