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 dir einen Autodiscover und Autoconfig-Dienst für alle in shared mailcow verwalteten Domains an: autodiscover.mailcow.de bzw. autoconfig.mailcow.de

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

Notwendige Konfiguration für Autoconfig¶

Hinweis

Wenn du planst mit einem E-Mail Client zu arbeiten, der Autoconfig unterstützt, solltest du die Konfiguration durchführen, andernfalls ist dies nicht unbedingt notwendig.

CNAME DNS Einstellungen¶

Setze einen CNAME in deiner DNS Verwaltung für deine 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.de   IN   3600    CNAME    autoconfig.mailcow.de

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¶

Setze außerdem noch einen SRV der auf deine 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 du planst mit einem E-Mail Client zu arbeiten, der Autoconfig unterstützt, solltest du die Konfiguration durchführen, andernfalls ist dies nicht unbedingt notwendig.

CNAME DNS Einstellungen¶

Setze einen CNAME in deiner DNS Verwaltung für deine 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.de   IN   3600    CNAME    autodiscover.mailcow.de

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¶

Setze außerdem noch einen SRV der auf deine 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.