ISPConfig/Plugin/Automail

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

Aufruf

Optionen

Unix	GNU	Parameter	Beschreibung

Exit-Status

Wert	Beschreibung
0	Erfolg
>0	Fehler

Konfiguration

Dateien

Datei	Beschreibung

---

TMP

Beschreibung

ISPConfig Automail

• Email-Clients (Thunderbird, Outlook, ...) automatisch konfigurieren
• Einen oder mehrere Mailserver für Domains möglich
• 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)

Aufbau des Plug-Ins

Erweiterung für ISPConfig	Verwaltung der Einstellungen
Skript	XML-Dateien je Domain generieren

Beispiel

example.com	Domain, die die automatische Einrichtung der Mailclients abwickelt
client.com	Kunden-Domain, 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.

Plugin aktivieren

1. An ISPConfig als admin anmelden
2. System /CP User anhlicken
3. Modul automail für admin aktivieren

Nach der nächsten Anmeldung steht das Modul zur Verfügung

Remote-Benutzer

Remote-Benutzer erstellen

• Automail-Funktionen aktivieren
• Fernzugriff zulassen, bei mehreren Servern

Plugin Konfigurieren

Provider-ID

Eindeutige ID zur Identifikation des Set-ups

• Sie können den Domänennamen Ihres Servers verwenden

Hostnamen

• sind die Namen, unter denen Mails abgerufen (IMAP/POP3) und versendet (SMTP) werden

Ports

• Ports, die für Ihren Mailserver verwendet werden sollen

SSL

Wenn SSL aktiviert ist, wird das eingerichtete Email-Programm eine verschlüsselte Verbindung aufbauen

Achtung

Das Zertifikat MUSS zum Hostnamen passen

DNS-Einträge

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.

SRV-Eintrag

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

Einrichten der Website in ISPConfig

autoconfig.example.de

Webseite in ISPConfig anlegen

• PHP-Unterstützung
• keine Auto-Subdomain
• SSL

Optionen

Durch ServerAlias bzw. server_name kann diese Domain später von jedem Kunden/jeder Email-Domain genutzt werden

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.*;

Aliasdomain

Aliasdomain anlegen autodiscover.example.de zeigt auf autoconfig.example.de

• Keine Redirects
• SSL-Zertifikat
  • Dazu reichen A-Records im DNS, die auf Deinen Webserver zeigen, damit Du Let’s Encrypt nutzen kannst

Script einrichten

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 Datei htaccess in .htaccess um
   • Wird nginx verwendet, kann die Datei gelöscht werden

Weblinks

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