Zum Inhalt springen

ISPConfig/Plugin/Automail: Unterschied zwischen den Versionen

Aus Foxwiki
K Dirkwagner verschob die Seite ISPConfig/Automail nach ISPConfig/Plugin/Automail
 
(33 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 5: Zeile 5:
----
----
-->
-->
'''ISPConfig/Plugin/Automail''' - Automatischen Konfiguration von E-Mail-Clients
'''ISPConfig/Plugin/Automail''' - Automatische Konfiguration von [[E-Mail-Client]]s
</noinclude>
</noinclude>


== Beschreibung ==
== Beschreibung ==
; ISPConfig Automail
ISPConfig Automail
* Email-Clients (Thunderbird, Outlook, ...) automatisch konfigurieren
; [[Email-Client]]s konfigurieren
* Einen oder mehrere Mailserver für Domains möglich
* 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


Zeile 26: Zeile 25:
* 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]] || Verwaltung der Einstellungen
| Erweiterung für [[ISPConfig]] || Verwaltung der Einstellungen
|-
|-
| Skript || XML-Dateien je Domain generieren
| Skript || XML-Dateien je Domain generieren
|}
; Beispiel
{| class="wikitable options big"
| example.com || Domain, die die automatische Einrichtung der Mailclients abwickelt
|-
| client.com || Kunden-Domain, die example.com für die Einrichtung abfragt
|}
|}


== Installation ==
== Installation ==
<syntaxhighlight lang="bash" highlight="1" line copy>
<syntaxhighlight lang="bash" highlight="1-5" line>
</syntaxhighlight>
cd /tmp
 
wget https://download.schaal-it.net/ispconfig-automail.tgz
== Aufruf ==
tar xfz ispconfig-automail.tgz
<syntaxhighlight lang="bash" highlight="1" line copy>
cd automail
php install.php
ISPConfig Automail module has been installed.
</syntaxhighlight>
</syntaxhighlight>
=== Optionen ===
{| class="wikitable sortable options gnu big"
|-
! Unix !! GNU !! Parameter !! Beschreibung
|-
| || || ||
|-
|}
=== Parameter ===
=== Umgebungsvariablen ===
=== Exit-Status ===
{| class="wikitable options col1center big"
|-
! Wert !! Beschreibung
|-
| 0 || Erfolg
|-
| >0 || Fehler
|}
== Anwendung ==
<syntaxhighlight lang="bash" highlight="1" line copy>
</syntaxhighlight>
<!-- output -->
<syntaxhighlight lang="bash" highlight="" line>
</syntaxhighlight>
=== Problembehebung ===


== Konfiguration ==
== Konfiguration ==
=== Dateien ===
{| class="wikitable options big"
|-
! Datei !! Beschreibung
|-
| ||
|-
| ||
|}
<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 ====
==== Weblinks ====
<!--
{{DEFAULTSORT:new}}
{{DISPLAYTITLE:new}}
-->
[[Kategorie:new]]
</noinclude>
= TMP =
== Installation ==
cd /tmp
wget <nowiki>https://download.schaal-it.net/ispconfig-automail.tgz</nowiki>
tar xfz ispconfig-automail.tgz
cd automail
php install.php
  ISPConfig Automail module has been installed.
=== Plugin aktivieren ===
=== Plugin aktivieren ===
# An [[ISPConfig]] als [[ISPConfig/admin|admin]] anmelden
# An [[ISPConfig]] als [[ISPConfig/admin|admin]] anmelden
Zeile 144: Zeile 54:
* Fernzugriff zulassen, bei mehreren Servern
* Fernzugriff zulassen, bei mehreren Servern


=== Plugin Konfigurieren ===
=== Plug-In-Konfiguration ===
; Provider-ID
 
Eindeutige ID zur Identifikation des Set-ups
{| class="wikitable options big"
! Einstellung !! Beschreibung
|-
| Provider-ID ||
* Eindeutige ID zur Identifikation des Set-ups
* Sie können den Domänennamen Ihres Servers verwenden
* Sie können den Domänennamen Ihres Servers verwenden
 
|-
; Hostnamen
| Hostnamen ||
* sind die Namen, unter denen Mails abgerufen (IMAP/POP3) und versendet (SMTP) werden
* Namen, unter denen Mails abgerufen (IMAP/POP3) und versendet (SMTP) werden
 
|-
; Ports
| Ports ||
* Ports, die für Ihren Mailserver verwendet werden sollen
* Ports, die für Ihren Mailserver verwendet werden sollen
 
|-
<!--
| SSL ||  
[[Image:Bild1.png|top|alt="ISPConfig Automailer-Setup"]]
* Wenn ''SSL'' aktiviert ist, wird das eingerichtete Email-Programm eine verschlüsselte Verbindung aufbauen
-->
|}
 
; SSL
Wenn ''SSL'' aktiviert ist, wird das eingerichtete Email-Programm eine verschlüsselte Verbindung aufbauen


'''Achtung'''
'''Achtung'''
Zeile 168: Zeile 79:


=== DNS-Einträge ===
=== DNS-Einträge ===
DNS-Einträge erstellen
; 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
; A/AAAA-Record für example.com
; A/AAAA-Record für example.com
* autoconfig.example.com  
* autoconfig.example.com  
Zeile 221: Zeile 139:
#* Wird [[nginx]] verwendet, kann die Datei gelöscht werden
#* Wird [[nginx]] verwendet, kann die Datei gelöscht werden


== Weblinks ==
=== Dateien ===
* [https://developer.mozilla.org/en-US/docs/Mozilla/Thunderbird/Autoconfiguration Autoconfig-Dienst ](Thunderbird)
{| class="wikitable options big"
* [https://technet.microsoft.com/en-us/library/bb124251(v=exchg.160).aspx Autodiscover-Dienst ](Outlook)
|-
! Datei !! Beschreibung
|-
| ||
|-
| ||
|}
 
== Problembehebung ==
<syntaxhighlight lang="bash" highlight="1" line copy>
</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