ISPConfig/Automail

Aus Foxwiki

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

Beschreibung

Installation

Anwendungen

Fehlerbehebung

Syntax

Optionen

Parameter

Umgebungsvariablen

Exit-Status

Konfiguration

Dateien

Sicherheit

Dokumentation

RFC

Man-Pages

Info-Pages

Siehe auch

Links

Projekt-Homepage

Weblinks

Einzelnachweise

Testfragen

Testfrage 1

Antwort1

Testfrage 2

Antwort2

Testfrage 3

Antwort3

Testfrage 4

Antwort4

Testfrage 5

Antwort5

Installation

cd /tmp
wget https://download.schaal-it.net/ispconfig-automail.tgz
tar xfz ispconfig-automail.tgz
cd automail
php install.php

Plugin aktivieren

  1. Melden Sie sich als admin bei ISPConfig an
  2. Gehen Sie zu System / CP User
  3. Aktivieren Sie das Modul automail für den Benutzer admin
  4. 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.

"ISPConfig Automailer-Setup"

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.

Einrichten der Website in ISPConfig

Als nächstes legst Du die Webseite autoconfig.example.de mit PHP-Unterstützung und ohne Auto Subdomain in ISPConfig an. Du solltest diese Seite auch über SSL absichern. Das ist zwar für autoconfig nicht erforderlich, wird aber später für autodiscover benötigt. Du kannst dazu ohne weiteres Let’s Encrypt einsetzen.

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

  • 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


  1. ISPConfig Automail