ISPConfig/Plugin/Automail

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

Beschreibung

ISPConfig Automail

Email-Clients konfigurieren

• Email-Clients automatisch nach Vorgaben konfigurieren
• Autoconfig (Thunderbird)
• Autodiscover (Outlook)
• Einen oder mehrere Mailserver für Domains möglich
• Definition von passenden Daten je Mailserver (Hostname, Port, ...)

Webseite

• stellt die Daten zur Verfügung
• Unterschiedliche Adressen und unterschiedliche XML‑Files

Anforderungen

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

Aufbau des Plugins

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

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 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

Plug-In-Konfiguration

Einstellung	Beschreibung
Provider-ID	Eindeutige ID zur Identifikation des Set-ups Sie können den Domänennamen Ihres Servers verwenden
Hostnamen	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

Beispiel

example.com	Domain für die Abwicklung der Einrichtung von Mailclients
client.com	Kunden-Domain, die example.com für die Einrichtung abfragt

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

Dateien

Datei	Beschreibung

Anhang

---

Links

Projekt

1. https://schaal-it.dev/blog/ispconfig-automail

Weblinks

1. Thunderbird/Autoconfiguration
2. Outlook/Autodiscover