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
 
(150 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 eine
; Aufbau des Plugins
* aktuelle Version von ISPConfig
{| class="wikitable options big"
* Webseite (Apache oder nginx).
| 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
== Konfiguration ==
* example.com Ihre Domain, über die die automatische Einrichtung der Mailclients laufen soll.
=== Plugin aktivieren ===
* client.com ist die Domäne, die example.com für die Einrichtung abfragt.
# 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
# Gehen 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.client.com. CNAME autoconfig.example.com.
* autoconfig.example.com  
  _autodiscover._tcp.client.com. SRV 0 0 443 autodiscover.example.com.
* autodiscover.example.com
Wenn Sie IPv6 verwenden, sollten Sie auch AAAA-Einträge erstellen.  


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.*;
 
; 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
# 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
 
=== Dateien ===
{| class="wikitable options big"
|-
! Datei !! Beschreibung
|-
| ||
|-
| ||
|}
 
== Problembehebung ==
<syntaxhighlight lang="bash" highlight="1" line copy>
</syntaxhighlight>
 
<!-- output -->
<syntaxhighlight lang="bash" highlight="" line>
</syntaxhighlight>


Mit Alias ​​oder Servername kann diese Domain später von beliebigen Kunden- oder E-Mail-Domains verwendet werden.
<noinclude>
* 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.
{{Navigation|<zurück>|<nachste>}}
----
-->


== Upload the script to the webseite  ==
== Anhang ==
* 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.
=== Siehe auch ===
* Benennen Sie die htaccess in .htaccess um. Wenn Sie nginx verwenden, können Sie die Datei auch direkt löschen.
<div style="column-count:2">
<categorytree hideroot=on mode="pages">{{BASEPAGENAME}}</categorytree>
</div>
----
{{Special:PrefixIndex/{{BASEPAGENAME}}/}}


== Prüfen  ==
=== Dokumentation ===
=== Autoconfig ===
<!--
wget http://autoconfig.client.com/config-v1.1.xml?emailaddress=test@client.com -O test
; Man-Page
# [https://manpages.debian.org/stable/procps/pgrep.1.de.html prep(1)]


Im Dateitest finden Sie das Ergebnis. Die E-Mail-Adresse muss natürlich existieren.
; Info-Pages
-->


=== Autodiscover ===  
=== Links ===
* [https://testconnectivity.microsoft.com/ Microsoft Remote Connectivity Analyzer].
==== 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]


# [https://schaal-it.com/ispconfig-automail/ ISPConfig Automail]
[[Kategorie:Autodiscover]]
[[Kategorie:ISPConfig/Mail]]
[[Kategorie:ISPConfig/Plugin]]


[[Kategorie:Netzwerke:Mail:Server]]
</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“