Autoconfig und Autodiscover

Wofür sind Autoconfig/Autodiscover? Und was bringen diese?¶

Autoconfig und Autodiscover sind Mechanismen, die entwickelt wurden, um E-Mail-Clients automatisch zu konfigurieren und somit den Endnutzern die manuelle Einrichtung von E-Mail-Konten zu ersparen. Beide Mechanismen verfolgen dasselbe Ziel, sind aber unterschiedlich implementiert und werden von verschiedenen E-Mail-Clients verwendet.

Über Autoconfig¶

Zielgruppe: Hauptsächlich für Mozilla Thunderbird und andere E-Mail-Clients.
Funktionsweise: Der Client sucht nach einer XML-Konfigurationsdatei, die auf einem Webserver des E-Mail-Anbieters hinterlegt ist.
Konfigurationsparameter: Enthält grundlegende Informationen wie IMAP/POP3- und SMTP-Serveradressen, Ports und SSL-Einstellungen.

Neugierig, wie eine Autoconfig Datei aussieht?

Eine autoconfig.xml Datei sieht in der Regel so aus:

<?xml version="1.0" encoding="UTF-8"?>
<clientConfig version="1.1">
<emailProvider id="example.com">
    <domain>example.com</domain>
    <displayName>Example Mail</displayName>
    <displayShortName>Example</displayShortName>
    <incomingServer type="imap">
    <hostname>imap.example.com</hostname>
    <port>993</port>
    <socketType>SSL</socketType>
    <username>%EMAILADDRESS%</username>
    <authentication>password-cleartext</authentication>
    </incomingServer>
    <outgoingServer type="smtp">
    <hostname>smtp.example.com</hostname>
    <port>587</port>
    <socketType>STARTTLS</socketType>
    <username>%EMAILADDRESS%</username>
    <authentication>password-cleartext</authentication>
    </outgoingServer>
</emailProvider>
</clientConfig>

Über Autodiscover¶

Zielgruppe: Hauptsächlich für Microsoft Outlook und andere Microsoft-Produkte.
Funktionsweise: Nutzt spezielle DNS-Einträge sowie einen Webservice, um die XML-Konfigurationsdatei bereitzustellen.
Unterstützte Dienste: Neben der Konfiguration von E-Mail-Konten können auch andere Exchange-Dienste wie Kalender und Kontakte automatisch eingerichtet werden.

Neugierig, wie eine Autodiscover Datei aussieht?

Eine autodiscover.xml sieht in der Regel so aus:

<?xml version="1.0" encoding="UTF-8"?>
<Autodiscover xmlns="http://schemas.microsoft.com/exchange/autodiscover/responseschema/2006">
<Response xmlns="http://schemas.microsoft.com/exchange/autodiscover/outlook/responseschema/2006a">
    <Account>
    <AccountType>email</AccountType>
    <Action>settings</Action>
    <Protocol>
        <Type>EXCH</Type>
        <Server>mail.example.com</Server>
        <SSL>true</SSL>
        <AuthPackage>Basic</AuthPackage>
        <ServerExclusiveConnect>false</ServerExclusiveConnect>
        <Port>443</Port>
        <ASUrl>https://mail.example.com/EWS/Exchange.asmx</ASUrl>
    </Protocol>
    <Protocol>
        <Type>SMTP</Type>
        <Server>smtp.example.com</Server>
        <Port>587</Port>
        <DomainRequired>false</DomainRequired>
        <LoginName>%EMAILADDRESS%</LoginName>
        <SPA>false</SPA>
        <SSL>true</SSL>
        <AuthRequired>true</AuthRequired>
    </Protocol>
    </Account>
</Response>
</Autodiscover>

Wir bieten Ihnen einen Autodiscover und Autoconfig-Dienst für alle in mailcow Groupware verwalteten Domains an: autodiscover.mailcow.de bzw. autoconfig.mailcow.de

Damit Ihre E-Mail Programme (Clients) den Dienst korrekt für Ihre Domain nutzen können, benötigen Sie einen SRV- und bestenfalls auch einen CNAME-Record, die in den DNS-Einstellungen Ihres Domain-Providers zu setzen sind.

Notwendige Konfiguration für Autoconfig¶

Hinweis

Wenn Sie planen mit einem E-Mail Client zu arbeiten, der Autoconfig unterstützt, sollten Sie die Konfiguration durchführen, andernfalls ist dies nicht umbedingt notwendig.

CNAME DNS Einstellungen¶

Setzen Sie einen CNAME in Ihrer DNS Verwaltung für Ihre Domain, der so aufgebaut ist:

Parameter	Wert
Name	`autoconfig`
Ziel	`autoconfig.mailcow.de`
TTL	beliebig (wir empfehlen >= 60 Min bzw. 3600 Sekunden)

Beispiel DNS Konfiguration

Im DNS Zonen Format würde der CNAME Eintrag so aussehen:

autoconfig.ihredomain.   IN   3600    CNAME    autoconfig.mailcow.

Dieser CNAME-Eintrag sorgt dafür, dass Anfragen an autoconfig.ihredomain.de an den Server autoconfig.mailcow.de weitergeleitet werden, der die XML-Konfigurationsdatei bereitstellt.

SRV DNS Einstellungen¶

Setzen Sie außerdem noch einen SRV der auf Ihre Stammdomain zeigt und wie folgt aufgebaut ist:

Parameter	Wert
Name	`@` (oder leer, je nach DNS Provider)
Ziel	`autoconfig.mailcow.de`
Protokoll	`_tcp`
Dienst	`_autoconfig`
Priorität	10
Gewichtung	10
Port	443
TTL	beliebig (wir empfehlen >= 60 Min bzw. 3600 Sekunden)

Beispiel DNS Konfiguration

Im DNS Zonen Format würde der SRV Eintrag so aussehen:

_autoconfig._tcp.ihredomain.de  3600  IN  SRV 10 10 443 autoconfig.mailcow.de

Dieser SRV-Eintrag gibt an, dass der Autodconfig-Dienst über den Server autoconfig.mailcow.de auf Port 443 verfügbar ist.

Notwendige Konfiguration für Autodiscover¶

Hinweis

Wenn Sie planen mit einem E-Mail Client zu arbeiten, der Autoconfig unterstützt, sollten Sie die Konfiguration durchführen, andernfalls ist dies nicht umbedingt notwendig.

CNAME DNS Einstellungen¶

Setzen Sie einen CNAME in Ihrer DNS Verwaltung für Ihre Domain, der so aufgebaut ist:

Parameter	Wert
Name	`autodiscover`
Ziel	`autodiscover.mailcow.de`
TTL	beliebig (wir empfehlen >= 60 Min bzw. 3600 Sekunden)

Beispiel DNS Konfiguration

Im DNS Zonen Format würde der CNAME Eintrag so aussehen:

autodiscover.ihredomain.   IN   3600    CNAME    autodiscover.mailcow.

Dieser CNAME-Eintrag sorgt dafür, dass Anfragen an autodiscover.ihredomain.de an den Server autodiscover.mailcow.de weitergeleitet werden, der die XML-Konfigurationsdatei bereitstellt.

SRV DNS Einstellungen¶

Setzen Sie außerdem noch einen SRV der auf Ihre Stammdomain zeigt und wie folgt aufgebaut ist:

Parameter	Wert
Name	`@` (oder leer, je nach DNS Provider)
Ziel	`autodiscover.mailcow.de`
Protokoll	`_tcp`
Dienst	`_autodiscover`
Priorität	10
Gewichtung	10
Port	443
TTL	beliebig (wir empfehlen >= 60 Min bzw. 3600 Sekunden)

Beispiel DNS Konfiguration

Im DNS Zonen Format würde der SRV Eintrag so aussehen:

_autodiscover._tcp.ihredomain.de  3600  IN  SRV 10 10 443 autodiscover.mailcow.de

Dieser SRV-Eintrag gibt an, dass der Autodiscover-Dienst über den Server autodiscover.mailcow.de auf Port 443 verfügbar ist.