Zum Inhalt springen

ISPConfig/Plugin/Automail: Unterschied zwischen den Versionen

Aus Foxwiki
Versionsgeschichte interaktiv durchsuchen
← Zum vorherigen Versionsunterschied

Dirkwagner (Diskussion | Beiträge)

3 Benutzergruppen
150.038 Bearbeitungen
VisuellWikitext
K Dirkwagner verschob die Seite ISPConfig/Automail nach ISPConfig/Plugin/Automail
 
(154 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 ==
* Thunderbird
ISPConfig Automail
* Outlook  
; [[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, ...)


Ob Sie einen oder mehrere Mailserver für die Domains verwenden, macht keinen Unterschied.
Webseite
* Definieren Sie einfach die entsprechenden Daten wie Hostname und Port für jeden Mailserver.
* stellt die Daten zur Verfügung
* alles andere wird über eine kleine Webseite erledigt, die einen [https://developer.mozilla.org/en-US/docs/Mozilla/Thunderbird/Autoconfiguration Autoconfig-Dienst ](Thunderbird) oder [https://technet.microsoft.com/en-us/library/bb124251(v=exchg.160).aspx Autodiscover-Dienst ](Outlook) bereitstellt.
* Unterschiedliche Adressen und unterschiedliche XML‑Files


Autoconfig und Autodiscover fordern XML-Dateien über verschiedene Adressen an, um den E-Mail-Client nach Ihren Vorgaben zu konfigurieren.
; Anforderungen
* Aktuelle Version von [[ISPConfig]]
* Webseite ([[Apache]] oder [[nginx]])


Um ISPConfig Automail nutzen zu können, benötigen Sie lediglich eine aktuelle Version von ISPConfig und eine Webseite (Apache oder nginx).
; Aufbau des Plugins
{| class="wikitable options big"
| Erweiterung für [[ISPConfig]] || Verwaltung der Einstellungen
|-
| Skript || XML-Dateien je Domain generieren
|}


Das Plugin besteht aus zwei Teilen
== Installation ==
* das Schnittstellen-Plugin für ISPConfig, um die Einstellungen zu verwalten
<syntaxhighlight lang="bash" highlight="1-5" line>
* ein Skript zum Generieren der relevanten XML-Dokumente unter der jeweiligen Domain
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>


In diesem Beispiel ist example.com Ihre Domain, über die die automatische Einrichtung der Mailclients laufen soll. Diese Domain können Sie frei wählen. Die Domäne client.com ist die Domäne, die example.com für die Einrichtung abfragt.
== 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


== Installieren Sie ISPConfig Automail  ==
=== Remote-Benutzer ===
Remote-Benutzer erstellen
* ''Automail-Funktionen'' aktivieren
* Fernzugriff zulassen, bei mehreren Servern


=== Plug-In-Konfiguration ===


== Aktivieren Sie das Plugin  ==
{| class="wikitable options big"
# Melden Sie sich als admin bei ISPConfig an
! Einstellung !! Beschreibung
# Ggehen Sie zu '''System '''/ '''CP User '''
|-
# Aktivieren Sie das Modul automail für den Benutzer admin.
| Provider-ID ||
# Nachdem Sie sich ab- und wieder angemeldet haben, steht Ihnen das Modul zur Verfügung.
* 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
|}


== Remote-Benutzer  ==
'''Achtung'''
* Erstellen Sie einen Remote-Benutzer, der die „Automail-Funktionen“ verwenden kann.
<blockquote>
* Wenn Sie eine Konfiguration mit mehreren Servern haben, müssen Sie möglicherweise den Fernzugriff zulassen.
Das Zertifikat [[MUSS]] zum Hostnamen passen
</blockquote>


== Konfigurieren Sie das Plugin  ==
=== DNS-Einträge ===
* Unter '''Provider-ID '''geben Sie eine eindeutige ID ein, die Ihr Setup identifiziert.
; Beispiel
*  Sie können den Domänennamen Ihres Servers verwenden.
{| class="wikitable options big"
* Die beiden '''Hostnamen '''sind die Namen, unter denen Mails abgerufen (IMAP/POP3) und versendet (SMTP) werden. Wenn Sie alles auf demselben Server ausführen, müssen Sie in beiden Feldern denselben Namen eingeben.  
| example.com || Domain für die Abwicklung der Einrichtung von Mailclients
* Sie bei '''Ports '''die Ports ein, die für Ihren Mailserver verwendet werden sollen.
|-
| client.com || Kunden-Domain, die example.com für die Einrichtung abfragt
|}


[[Image:Bild1.png|top|alt="ISPConfig Automailer-Setup"]]
; DNS-Einträge erstellen
; A/AAAA-Record für example.com
* autoconfig.example.com
* autodiscover.example.com


== Erstellen Sie die erforderlichen DNS-Einträge ==
; Je Kundendomäne
* Sie benötigen einen A-Record für autoconfig.example.com und autodiscover.example.com, der auf Ihren Webserver verweist.
  autoconfig.client.com. CNAME autoconfig.example.com.
* Wenn Sie IPv6 verwenden, sollten Sie auch AAAA-Einträge erstellen.  
_autodiscover._tcp.client.com. SRV 0 0 443 autodiscover.example.com.


Erstellen Sie zwei Einträge in jeder Kundendomäne. Für die Autokonfiguration reicht ein einfacher CNAME:
; SRV-Eintrag
autoconfig.client.com.  CNAME autoconfig.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


Für die automatische Erkennung wird ein SRV-Eintrag empfohlen. Dadurch erhalten Sie während der Einrichtung eine Zertifikatswarnung, aber es ist die einfachste Möglichkeit, beliebig viele Kundendomänen einzurichten:
=== Website für Automail ===
_autodiscover._tcp.client.com.  SRV 0 0 443 autodiscover.example.com.
Einrichten der Website in [[ISPConfig]]


== Erstellen Sie die Website in ISPConfig ==
; autoconfig.example.de
* Jetzt müssen Sie die Website autoconfig.example.com mit PHP-Unterstützung und ohne Auto-Subdomain in ISPConfig erstellen.
Webseite in [[ISPConfig]] anlegen
* Sie sollten diese Seite auch mit SSL sichern.
* PHP-Unterstützung
* 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
* keine Auto-Subdomain  
* SSL


Sie müssen die Anweisungen für Apache oder nginx entsprechend setzen:
; Optionen
Durch ''ServerAlias'' bzw.&nbsp;''server_name'' kann diese Domain später von jedem Kunden/jeder Email-Domain genutzt werden


'''Apache '''
'''Apache'''
  Serveralias autoconfig.*  
  ServerAlias autoconfig.*


'''nginx '''
'''nginx'''
  location ^~ /config\.php { alle ablehnen;  }
  location ^~ /config\.php { deny all; }
  Lage / {  
   
  autodiscover\.xml$ /index.php zuletzt neu schreiben;  
  location / {  
  Autodiscover\.xml$ /index.php neu schreiben zuletzt;  
  rewrite autodiscover\.xml$ /index.php last;  
  config-v1\.1\.xml$ /index.php neu schreiben zuletzt;  
  rewrite Autodiscover\.xml$ /index.php last;  
  rewrite config-v1\.1\.xml$ /index.php last;  
  }
  }
  Servername autoconfig.*;  
  server_name autoconfig.*;


Mit Alias ​​oder Servername kann diese Domain später von beliebigen Kunden- oder E-Mail-Domains verwendet werden.
; Aliasdomain
* Erstellen Sie die '''Aliasdomäne '''autodiscover.example.com und verweisen Sie sie auf autoconfig.example.com.
Aliasdomain anlegen
* Sie brauchen keine Weiterleitungen, wichtig ist, dass die Domain ein SSL-Zertifikat hat.
''autodiscover.example.de'' zeigt auf ''autoconfig.example.de''
* A-Records im DNS reichen aus, um auf Ihren Webserver zu verweisen, damit Sie Let's Encrypt verwenden können.
* Keine Redirects
* SSL-Zertifikat
** Dazu reichen A-Records im DNS, die auf Deinen Webserver zeigen, damit Du Let’s Encrypt nutzen kannst


== Upload the script to the webseite  ==
=== Script 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.
Script auf der Webseite einrichten
* Benennen Sie die htaccess in .htaccess um. Wenn Sie nginx verwenden, können Sie die Datei auch direkt löschen.
# Laden Sie die Dateien aus dem '''Website '''-Verzeichnis aus dem Archiv auf die neu erstellte Website hoch
# config.php anpassen
# Benennen Sie die Datei htaccess in .htaccess um
#* Wird [[nginx]] verwendet, kann die Datei gelöscht werden


== Prüfen  ==
=== Dateien ===
=== Autoconfig ===
{| class="wikitable options big"
wget http://autoconfig.client.com/config-v1.1.xml?emailaddress=test@client.com -O test
|-
! Datei !! Beschreibung
|-
| ||
|-
| ||
|}


Im Dateitest finden Sie das Ergebnis. Die E-Mail-Adresse muss natürlich existieren.
== Problembehebung ==
<syntaxhighlight lang="bash" highlight="1" line copy>
</syntaxhighlight>


=== Autodiscover ===
<!-- output -->
* [https://testconnectivity.microsoft.com/ Microsoft Remote Connectivity Analyzer].
<syntaxhighlight lang="bash" highlight="" line>
</syntaxhighlight>


<noinclude>
<!--
----
{{Navigation|<zurück>|<nachste>}}
----
-->


# [https://schaal-it.com/ispconfig-automail/ ISPConfig Automail]
== Anhang ==
=== Siehe auch ===
<div style="column-count:2">
<categorytree hideroot=on mode="pages">{{BASEPAGENAME}}</categorytree>
</div>
----
{{Special:PrefixIndex/{{BASEPAGENAME}}/}}


[[Kategorie:Netzwerke:Mail:Server]]
=== Dokumentation ===
<!--
; Man-Page
# [https://manpages.debian.org/stable/procps/pgrep.1.de.html prep(1)]
 
; Info-Pages
-->
 
=== Links ===
==== Projekt ====
# https://schaal-it.dev/blog/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:ISPConfig/Mail]]
[[Kategorie:ISPConfig/Plugin]]
 
</noinclude>

Aktuelle Version vom 27. Juli 2026, 09:27 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=172357“