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
K Dirkwagner verschob die Seite ISPConfig/Automail nach ISPConfig/Plugin/Automail
 
(50 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 ==
=== Plugin aktivieren ===
=== Plugin aktivieren ===
# An [[ISPConfig]] als [[ISPConfig/admin|admin]] anmelden
# An [[ISPConfig]] als [[ISPConfig/admin|admin]] anmelden
Zeile 51: Zeile 50:


=== 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.
# 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.


<!--
{| class="wikitable options big"
[[Image:Bild1.png|top|alt="ISPConfig Automailer-Setup"]]
! 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
|}


Wenn ''SSL'' aktiviert ist, wird das eingerichtete Email-Programm eine verschlüsselte Verbindung aufbauen
'''Achtung'''
;Achtung
<blockquote>
<blockquote>
Das Zertifikat [[MUSS]] zum Hostnamen passen
Das Zertifikat [[MUSS]] zum Hostnamen passen
</blockquote>
</blockquote>


=== DNS-Einträge erstellen ===
=== DNS-Einträge ===
; 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 80: 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 90: Zeile 106:
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 107: 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


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


Sie müssen die Anweisungen für Apache entsprechend setzen:
<!-- output -->
<syntaxhighlight lang="bash" highlight="" line>
</syntaxhighlight>
 
<noinclude>
<!--
----
{{Navigation|<zurück>|<nachste>}}
----
-->


'''Apache '''
== Anhang ==
Serveralias autoconfig.*
=== Siehe auch ===
<div style="column-count:2">
<categorytree hideroot=on mode="pages">{{BASEPAGENAME}}</categorytree>
</div>
----
{{Special:PrefixIndex/{{BASEPAGENAME}}/}}


Mit Alias ​​oder Servername kann diese Domain später von beliebigen Kunden- oder E-Mail-Domains verwendet werden
=== Dokumentation ===
* 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
; Man-Page
* A-Records im DNS reichen aus, um auf Ihren Webserver zu verweisen, damit Sie Let's Encrypt verwenden können
# [https://manpages.debian.org/stable/procps/pgrep.1.de.html prep(1)]


=== Script auf der Webseite einrichten ===
; Info-Pages
# 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


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


== Weblinks ==
==== Weblinks ====
* [https://developer.mozilla.org/en-US/docs/Mozilla/Thunderbird/Autoconfiguration Autoconfig-Dienst ](Thunderbird)
# [https://developer.mozilla.org/en-US/docs/Mozilla/Thunderbird/Autoconfiguration Thunderbird/Autoconfiguration]
* [https://technet.microsoft.com/en-us/library/bb124251(v=exchg.160).aspx Autodiscover-Dienst ](Outlook)
# [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“