====== Automatische Konfiguration von E-Mail-Konten ======

Üblicherweise muss eine Nutzerin beim Einrichten eines neuen E-Mail-Kontos in ihrem Mailprogramm alle Daten manuell eintragen. Allerdings lassen sich E-Mail-Konten auch automatisch konfigurieren. Dafür gibt es mehrere Wege:

^ Methode ^ Entwickler ^ Mail-Programme ^
| [[https://wiki.mozilla.org/Thunderbird:Autoconfiguration|Autoconfig]] | Mozilla | Thunderbird, K9 |
| [[https://www.rfc-editor.org/rfc/rfc6186#section-3|SRV-Eintrag]] | IETF | Claws Mail |

===== Autoconfig =====

Autoconfig ist Thunderbirds Methode für die automatische Einrichtung von E-Mail-Konten. Beim Einrichten eines neuen Kontos prüft Thunderbird, ob eine Konfigurationsdatei unter der Adresse ''http://autoconfig.example.org/mail/config-v1.1.xml'' verfügbar ist. Diese enthält alle für die automatische Einrichtung notwendigen Informationen.

Damit Autoconfig mit deinem Mailserver funktioniert, sind die folgenden Schritte notwendig:
  * Lege in den DNS-Einstellungen deines Domainanbieters einen neuen A-Eintrag mit dem Namen ''autoconfig.example.org.'' an.
  * Richte deinen Webserver so ein, dass er die Datei ''config-v1.1.xml'' korrekt ausliefert. Mit NGINX könnte das bspw. so aussehen:<code>
server {
    server_name autoconfig.example.org;
    listen 443 ssl;
    ssl_certificate /var/lib/dehydrated/certs/autoconfig.example.org/fullchain.pem;
    ssl_certificate_key /var/lib/dehydrated/certs/autoconfig.example.org/privkey.pem;
    root /var/www/autoconfig.example.org;
}
</code>
  * Erstelle nun die Datei ''/var/www/autoconfig.example.org/mail/config-v1.1.xml''. Das Format der Datei ist [[https://wiki.mozilla.org/Thunderbird:Autoconfiguration:ConfigFileFormat|vorgegeben]]. Ein Beispiel:<code XML>
<?xml version="1.0" encoding="UTF-8"?>

<clientConfig version="1.1">
  <emailProvider id="example.org">
    <domain>%EMAILDOMAIN%</domain>
    <displayName>%EMAILDOMAIN% mail</displayName>
    <displayShortName>%EMAILDOMAIN%</displayShortName>
    <incomingServer type="imap">
      <hostname>imap.example.org</hostname>
      <port>993</port>
      <socketType>SSL</socketType>
      <authentication>password-cleartext</authentication>
      <username>%EMAILADDRESS%</username>
    </incomingServer>
   <incomingServer type="pop3">
      <hostname>pop.example.org</hostname>
      <port>995</port>
      <socketType>SSL</socketType>
      <authentication>password-cleartext</authentication>
      <username>%EMAILADDRESS%</username>
    </incomingServer>
    <outgoingServer type="smtp">
      <hostname>smtp.example.org</hostname>
      <port>465</port>
      <socketType>SSL</socketType>
      <authentication>password-cleartext</authentication>
      <username>%EMAILADDRESS%</username>
    </outgoingServer>
    <documentation url="https://hilfe.example.org">
      <descr lang="de">Hilfe zu den E-Mail Einstellungen</descr>
      <descr lang="en">help for e-mail configuration</descr>
    </documentation>
  </emailProvider>
</clientConfig>
</code>

===== SRV-Eintrag =====

Einige Mailclients, wie bspw. [[https://claws-mail.org|Claws Mail]] unterstützen die Einrichtung per [[wpde>SRV_Resource_Record]]. Die Einträge müssen nach folgendem Muster aufgebaut sein:

^ Eintrag ^ Ziel ^
| ''_imaps._tcp.example.org'' | imap.example.org:993 |
| ''_pop3s._tcp.example.org'' | pop.example.org:995 |
| ''_submission._tcp.example.org'' | smtp.example.:465 |