Zum Inhalt springen

ISPConfig/Plugin/Automail: Unterschied zwischen den Versionen

Aus Foxwiki
Versionsgeschichte interaktiv durchsuchen
← Zum vorherigen Versionsunterschied

Dirkwagner (Diskussion | Beiträge)

3 Benutzergruppen
151.635 Bearbeitungen
VisuellWikitext
K Textersetzung - „wikitable“ durch „table table-striped table-hover“
 
(113 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
'''ISPConfig Automail''' - plugin zur automatischen Konfiguration von E-Mail-Clients
<noinclude>
<!--
----
{{Navigation|<zurück>|<nachste>}}
----
-->
'''ISPConfig/Plugin/Automail''' - Automatische Konfiguration von [[E-Mail-Client]]s
</noinclude>


== Beschreibung ==
== Beschreibung ==
ISPConfig Automail
; [[Email-Client]]s 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, ...)


Mit dem Plugin '''ISPConfig Automail''' kannst Du Email-Clients wie Thunderbird oder Outlook automatisch konfigurieren.
Webseite
* stellt die Daten zur Verfügung
* Unterschiedliche Adressen und unterschiedliche XML‑Files


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.
; Anforderungen
* Aktuelle Version von [[ISPConfig]]
* Webseite ([[Apache]] oder [[nginx]])


Autoconfig und Autodiscover fordern über unterschiedliche Adressen XML-Files an, mit denen dann der Email-Client nach Deinen Vorgaben konfiguriert wird.
; Aufbau des Plugins
{| class="table table-striped table-hover options big"
| Erweiterung für [[ISPConfig]] || Verwaltung der Einstellungen
|-
| Skript || XML-Dateien je Domain generieren
|}


Um den ISPConfig Automail nutzen zu können, brauchst Du nur eine aktuelle Version von ISPConfig und eine Webseite (Apache oder nginx).
== Installation ==
<syntaxhighlight lang="bash" highlight="1-5" line>
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.
</syntaxhighlight>


Das Plugin besteht aus zwei Teilen
== Konfiguration ==
=== Plugin aktivieren ===
# An [[ISPConfig]] als [[ISPConfig/admin|admin]] anmelden
# ''System ''/''CP User'' anhlicken
# Modul ''automail'' für [[ISPConfig/admin|admin]] aktivieren
Nach der nächsten Anmeldung steht das Modul zur Verfügung


* die Erweiterung für ISPConfig zum Verwalten der Einstellungen
=== Remote-Benutzer ===
* ein Script, um die entsprechenden XML-Dokumente unter der jeweiligen Domain zu generieren.
Remote-Benutzer erstellen
* ''Automail-Funktionen'' aktivieren
* Fernzugriff zulassen, bei mehreren Servern


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.
=== Plug-In-Konfiguration ===


{| class="table table-striped table-hover options big"
! 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
|}


* Thunderbird
'''Achtung'''
* Outlook
<blockquote>
Das Zertifikat [[MUSS]] zum Hostnamen passen
</blockquote>


Ob Sie einen oder mehrere Mailserver für die Domains verwenden, macht keinen Unterschied.  
=== DNS-Einträge ===
* Definieren Sie die entsprechenden Daten wie Hostname und Port für jeden Mailserver.
; Beispiel
Alles andere wird über eine kleine Webseite erledigt, die einen
{| class="table table-striped table-hover options big"
* [https://developer.mozilla.org/en-US/docs/Mozilla/Thunderbird/Autoconfiguration Autoconfig-Dienst ](Thunderbird) oder
| example.com || Domain für die Abwicklung der Einrichtung von Mailclients
* [https://technet.microsoft.com/en-us/library/bb124251(v=exchg.160).aspx Autodiscover-Dienst ](Outlook)
|-
bereitstellt.
| client.com || Kunden-Domain, die example.com für die Einrichtung abfragt
|}


Autoconfig und Autodiscover fordern XML-Dateien über verschiedene Adressen an, um den E-Mail-Client nach Ihren Vorgaben zu konfigurieren.  
; DNS-Einträge erstellen
; A/AAAA-Record für example.com
* autoconfig.example.com
* autodiscover.example.com


Um ISPConfig Automail nutzen zu können, benötigen eine
; Je Kundendomäne
* aktuelle Version von ISPConfig
autoconfig.client.com. CNAME autoconfig.example.com.
* Webseite (Apache oder nginx).  
_autodiscover._tcp.client.com. SRV 0 0 443 autodiscover.example.com.


Das Plugin besteht aus zwei Teilen
; SRV-Eintrag
* das Schnittstellen-Plugin für ISPConfig, um die Einstellungen zu verwalten
Für die automatische Erkennung wird ein SRV-Eintrag empfohlen
* ein Skript zum Generieren der relevanten XML-Dokumente unter der jeweiligen Domain
* Dadurch erhalten Sie während der Einrichtung eine Zertifikatswarnung
* Es ist die einfachste Möglichkeit, beliebig viele Kundendomänen einzurichten


In diesem Beispiel ist
=== Website für Automail ===
* example.com Ihre Domain, über die die automatische Einrichtung der Mailclients laufen soll.
Einrichten der Website in [[ISPConfig]]
* client.com ist die Domäne, die example.com für die Einrichtung abfragt.


== Installation  ==
; autoconfig.example.de
cd /tmp
Webseite in [[ISPConfig]] anlegen
wget <nowiki>https://download.schaal-it.net/ispconfig-automail.tgz</nowiki>
* PHP-Unterstützung
tar xfz ispconfig-automail.tgz
* keine Auto-Subdomain
cd automail
* SSL
php install.php


== Einrichten der Website in ISPConfig ==
; Optionen
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.
Durch ''ServerAlias'' bzw.&nbsp;''server_name'' kann diese Domain später von jedem Kunden/jeder Email-Domain genutzt werden
 
Bei den Optionen musst Du noch die Direktiven für Apache oder nginx entsprechend setzen:


'''Apache'''
'''Apache'''
  ServerAlias autoconfig.*
  ServerAlias autoconfig.*
'''nginx'''
'''nginx'''
  location ^~ /config\.php { deny all; }
  location ^~ /config\.php { deny all; }
Zeile 66: Zeile 124:
  }
  }
  server_name autoconfig.*;
  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.
== 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.
[[Image:Bild1.png|top|alt="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
; Aliasdomain
* Dadurch erhalten Sie während der Einrichtung eine Zertifikatswarnung
Aliasdomain anlegen
* Es ist die einfachste Möglichkeit, beliebig viele Kundendomänen einzurichten
''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


== Website für ISPConfig:Automail ==
=== Script einrichten ===
* Jetzt müssen Sie die Website autoconfig.example.com mit PHP-Unterstützung und ohne Auto-Subdomain in ISPConfig erstellen.  
Script auf der Webseite einrichten
* Sie sollten diese Seite auch mit SSL sichern.  
# Laden Sie die Dateien aus dem '''Website '''-Verzeichnis aus dem Archiv auf die neu erstellte Website hoch
* 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
# config.php anpassen
# Benennen Sie die Datei htaccess in .htaccess um
#* Wird [[nginx]] verwendet, kann die Datei gelöscht werden


Sie müssen die Anweisungen für Apache entsprechend setzen:
=== Dateien ===
{| class="table table-striped table-hover options big"
|-
! Datei !! Beschreibung
|-
| ||
|-
| ||
|}


'''Apache '''
== Problembehebung ==
Serveralias autoconfig.*
<syntaxhighlight lang="bash" highlight="1" line copy>
</syntaxhighlight>


Mit Alias ​​oder Servername kann diese Domain später von beliebigen Kunden- oder E-Mail-Domains verwendet werden.
<!-- output -->
* Erstellen Sie die '''Aliasdomäne '''autodiscover.example.com und verweisen Sie sie auf autoconfig.example.com.
<syntaxhighlight lang="bash" highlight="" line>
* Sie brauchen keine Weiterleitungen, wichtig ist, dass die Domain ein SSL-Zertifikat hat.
</syntaxhighlight>
* 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 ==
<noinclude>
* 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.
----
{{Navigation|<zurück>|<nachste>}}
----
-->


== Prüfen  ==
== Anhang ==
=== Autoconfig ===
=== Siehe auch ===
wget <nowiki>http://autoconfig.client.com/config-v1.1.xml?emailaddress=test@client.com -O test </nowiki>
<div style="column-count:2">
<categorytree hideroot=on mode="pages">{{BASEPAGENAME}}</categorytree>
</div>
----
{{Special:PrefixIndex/{{BASEPAGENAME}}/}}


Im Dateitest finden Sie das Ergebnis. Die E-Mail-Adresse muss natürlich existieren.
=== Dokumentation ===
<!--
; Man-Page
# [https://manpages.debian.org/stable/procps/pgrep.1.de.html prep(1)]


=== Autodiscover ===
; Info-Pages
* [https://testconnectivity.microsoft.com/ Microsoft Remote Connectivity Analyzer].
-->


=== Links ===
==== Projekt ====
# https://schaal-it.dev/blog/ispconfig-automail


# [https://schaal-it.com/ispconfig-automail/ ISPConfig Automail]
==== Weblinks ====
# [https://developer.mozilla.org/en-US/docs/Mozilla/Thunderbird/Autoconfiguration Thunderbird/Autoconfiguration]
# [https://technet.microsoft.com/en-us/library/bb124251(v=exchg.160).aspx Outlook/Autodiscover]


[[Kategorie:Autodiscover]]
[[Kategorie:Autodiscover]]
[[Kategorie:ISPConfig/Mail]]
[[Kategorie:ISPConfig/Plugin]]


= ISPConfig Automail =
</noinclude>

Aktuelle Version vom 29. Juli 2026, 10:56 Uhr

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


Beschreibung

ISPConfig Automail

Email-Clients konfigurieren

Webseite

  • stellt die Daten zur Verfügung
  • Unterschiedliche Adressen und unterschiedliche XML‑Files
Anforderungen
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

Problembehebung


Anhang

Siehe auch


Dokumentation

Projekt

  1. https://schaal-it.dev/blog/ispconfig-automail
  1. Thunderbird/Autoconfiguration
  2. Outlook/Autodiscover


Abgerufen von „https://wiki.foxtom.de/index.php?title=ISPConfig/Plugin/Automail&oldid=172985“