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.036 Bearbeitungen
VisuellWikitext
Keine Bearbeitungszusammenfassung
K Dirkwagner verschob die Seite ISPConfig/Automail nach ISPConfig/Plugin/Automail
 
(57 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
'''ISPConfig/Plugin/Automail''' - 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
ISPConfig Automail
* Email-Clients (Thunderbird, Outlook, ...) automatisch konfigurieren
; [[Email-Client]]s konfigurieren
* Einen oder mehrere Mailserver für Domains
* 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, ...)
* Definition von passenden Daten je Mailserver (Hostname, Port, ...)


; Webseite stellt die Daten zur Verfügung
Webseite  
* Autoconfig (Thunderbird)
* stellt die Daten zur Verfügung
* Autodiscover (Outlook)
 
; [[Autoconfig]] und [[Autodiscover]]
[[Email-Client]]s nach Vorgaben konfigurieren
* Unterschiedliche Adressen und unterschiedliche XML‑Files
* Unterschiedliche Adressen und unterschiedliche XML‑Files


; Anforderungen
; Anforderungen
* aktuelle Version von [[ISPConfig]]
* Aktuelle Version von [[ISPConfig]]
* Webseite ([[Apache]] oder [[nginx]])
* Webseite ([[Apache]] oder [[nginx]])


; Aufbau des Plug-Ins
; Aufbau des Plugins
{| class="wikitable options big"
{| class="wikitable options big"
| Erweiterung für [[ISPConfig]] || Verwalten der Einstellungen
| Erweiterung für [[ISPConfig]] || Verwaltung der Einstellungen
|-
|-
| Skript || um die entsprechenden XML-Dokumente unter der jeweiligen Domain zu generieren
| Skript || XML-Dateien je Domain generieren
|}
|}
; Beispiel
Hier wird example.de hier als Domain genutzt
* Automatische Einrichten der Mail-Clients
* Domain ist frei wähbar
* Die Domain kunde.de ist die Domain, die für die Einrichtung example.de abfragt
In diesem Beispiel ist
* example.com Ihre Domain, über die die automatische Einrichtung der Mailclients laufen soll
* client.com ist die Domäne, die example.com für die Einrichtung abfragt.


== Installation ==
== Installation ==
cd /tmp
<syntaxhighlight lang="bash" highlight="1-5" line>
wget <nowiki>https://download.schaal-it.net/ispconfig-automail.tgz</nowiki>
cd /tmp
tar xfz ispconfig-automail.tgz
wget https://download.schaal-it.net/ispconfig-automail.tgz
cd automail
tar xfz ispconfig-automail.tgz
php install.php
cd automail
  ISPConfig Automail module has been installed.
php install.php
ISPConfig Automail module has been installed.
</syntaxhighlight>


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


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


=== Plugin Konfigurieren ===
=== Plug-In-Konfiguration ===
# Unter '''Provider-ID '''geben Sie eine eindeutige ID ein, die Ihr Setup identifiziert.
 
# 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.
! Einstellung !! Beschreibung
# '''Ports:''' Ports, die für Ihren Mailserver verwendet werden sollen.
|-
| 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'''
[[Image:Bild1.png|top|alt="ISPConfig Automailer-Setup"]]
<blockquote>
-->
Das Zertifikat [[MUSS]] zum Hostnamen passen
</blockquote>


Wenn ''SSL'' aktiviert ist, wird das eingerichtete Email-Programm eine verschlüsselte Verbindung aufbauen
=== DNS-Einträge ===
* Dazu muss das Zertifikat zwingend zum Hostnamen passen
; Beispiel
{| class="wikitable options big"
| 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 ===
; DNS-Einträge erstellen
; A/AAAA-Record für example.com
; A/AAAA-Record für example.com
* autoconfig.example.com  
* autoconfig.example.com  
Zeile 78: Zeile 95:
  _autodiscover._tcp.client.com. SRV 0 0 443 autodiscover.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
Für die automatische Erkennung wird ein SRV-Eintrag empfohlen
* Dadurch erhalten Sie während der Einrichtung eine Zertifikatswarnung
* Dadurch erhalten Sie während der Einrichtung eine Zertifikatswarnung
Zeile 83: Zeile 101:


=== Website für Automail ===
=== Website für Automail ===
* Jetzt müssen Sie die Website autoconfig.example.com mit PHP-Unterstützung und ohne Auto-Subdomain in [[ISPConfig]] erstellen.
Einrichten der Website in [[ISPConfig]]
* 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]] ===
; autoconfig.example.de
; autoconfig.example.de
Webseite in [[ISPConfig]] anlegen
Webseite in [[ISPConfig]] anlegen
* PHP-Unterstützung
* PHP-Unterstützung
* keine Auto Subdomain  
* keine Auto-Subdomain  
* SSL
* SSL
** für [[autodiscover]] benötigt notwendig


; Optionen
; 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.*
Zeile 118: Zeile 124:
  }
  }
  server_name autoconfig.*;
  server_name autoconfig.*;
Durch ''ServerAlias'' bzw.&nbsp;''server_name'' kann diese Domain später von jedem Kunden/jeder Email-Domain genutzt werden


; Aliasdomain
; Aliasdomain
'''Aliasdomain''' autodiscover.example.de anlegen
Aliasdomain anlegen
zeigt auf autoconfig.example.de
''autodiscover.example.de'' zeigt auf ''autoconfig.example.de''
* Keine Redirects
* Keine Redirects
* SSL-Zertifikat
* SSL-Zertifikat
** Dazu reichen A-Records im DNS, die auf Deinen Webserver zeigen, damit Du Let’s Encrypt nutzen kannst
** Dazu reichen A-Records im DNS, die auf Deinen Webserver zeigen, damit Du Let’s Encrypt nutzen kannst


=== Script auf der Webseite einrichten ===
=== Script einrichten ===
Script auf der Webseite einrichten
# Laden Sie die Dateien aus dem '''Website '''-Verzeichnis aus dem Archiv auf die neu erstellte Website hoch
# Laden Sie die Dateien aus dem '''Website '''-Verzeichnis aus dem Archiv auf die neu erstellte Website hoch
# config.php anpassen
# config.php anpassen
Zeile 134: Zeile 139:
#* Wird [[nginx]] verwendet, kann die Datei gelöscht werden
#* Wird [[nginx]] verwendet, kann die Datei gelöscht werden


== Anwendungen ==
=== Dateien ===
=== Problembehebung ===
{| class="wikitable options big"
|-
! Datei !! Beschreibung
|-
| ||
|-
| ||
|}


== Weblinks ==
== Problembehebung ==
* [https://developer.mozilla.org/en-US/docs/Mozilla/Thunderbird/Autoconfiguration Autoconfig-Dienst ](Thunderbird)
<syntaxhighlight lang="bash" highlight="1" line copy>
* [https://technet.microsoft.com/en-us/library/bb124251(v=exchg.160).aspx Autodiscover-Dienst ](Outlook)
</syntaxhighlight>
 
<!-- output -->
<syntaxhighlight lang="bash" highlight="" line>
</syntaxhighlight>
 
<noinclude>
<!--
----
{{Navigation|<zurück>|<nachste>}}
----
-->
 
== Anhang ==
=== Siehe auch ===
<div style="column-count:2">
<categorytree hideroot=on mode="pages">{{BASEPAGENAME}}</categorytree>
</div>
----
{{Special:PrefixIndex/{{BASEPAGENAME}}/}}
 
=== 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:Autodiscover]]
[[Kategorie:ISPConfig/Mail]]
[[Kategorie:ISPConfig/Mail]]
[[Kategorie:ISPConfig/Plugin]]
[[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“