====== Automatische Konfiguration von Thunderbird ======

//Evolution and KMail and Kontact use it, too.//

Mögliche Alternativen: 
  * [[RFC>6186]]
  * [[https://github.com/sys4/automx/blob/master/INSTALL|automx]] (funktioniert auch mit Outlook, MacOS und iOS, aber letzte Änderung 2016)

===== Voraussetzung =====
  * [[postfix]] bevorzugt mit [[postfix-tls|TLS]] ((https://bugzilla.mozilla.org/show_bug.cgi?id=667896))
  * [[dovecot-imapd]] mit [[dovecot-ssl|TLS]]
  * Apache mit TLS
  * [[apache-virtual-hosts]], geht aber auch ohne virtual host, mit ''/.well-known/autoconfig/mail/config-v1.1.xml''
    * Wie in [[bind]] beschrieben einen CNAME ''autoconfig'' für die Domain anlegen. 
    * Wie in [[apache-virtual-hosts]] beschrieben einen Virtual Host für die Domain anlegen. 

===== Apache konfigurieren =====
==== mit Alias ====
<file txt /etc/apache2/conf-available/autoconfig.conf>
Alias /.well-known/autoconfig /var/www/autoconfig

<Directory /var/www/autoconfig/>
    Options FollowSymlinks
    Options -Indexes
    AllowOverride None
    Require all granted
</Directory>
</file>

  a2enconf autoconfig

++++ Alternativ: mit Virtual Host |
==== mit Virtual Host ====

<file txt autoconfig.z21.example.net.conf>
<VirtualHost *:80>
  ServerName autoconfig.z21.example.net
  DocumentRoot /var/www/autoconfig

  <Directory "/var/www/autoconfig">
    require all granted
  </Directory>
</VirtualHost>
</file>

  a2ensite autoconfig.z21.example.net
++++
  apache2ctl graceful

===== Datei config-v1.1.xml hinterlegen =====
  mkdir -p /var/www/autoconfig/mail

<file xml /var/www/autoconfig/mail/config-v1.1.xml>
<?xml version="1.0" encoding="UTF-8"?>

<clientConfig version="1.1">
  <emailProvider id="z21.example.net">
    <domain>z21.example.net</domain>
    <displayName>z21 Mail</displayName>
    <displayShortName>z21</displayShortName>
    <incomingServer type="imap">
      <hostname>vm02.z21.example.net</hostname>
      <port>143</port>
      <socketType>STARTTLS</socketType>
      <authentication>password-cleartext</authentication>
      <username>%EMAILLOCALPART%</username>
    </incomingServer>
    <outgoingServer type="smtp">
      <hostname>vm02.z21.example.net</hostname>
      <port>25</port>
      <socketType>plain</socketType>
      <authentication>client-IP-address</authentication>
      <username>%EMAILLOCALPART%</username>
    </outgoingServer>
    <documentation url="https://vm02.z21.example.net/test.html">
      <descr lang="de">Allgemeine Beschreibung der Einstellungen</descr>
      <descr lang="en">Generic settings page</descr>
    </documentation>
  </emailProvider>
</clientConfig>
</file>

Testen: https://vm02.z21.example.net/.well-known/autoconfig/mail/config-v1.1.xml

====== Dokumentation ======
  * https://wiki.mozilla.org/Thunderbird:Autoconfiguration:ConfigFileFormat
  * https://developer.mozilla.org/de/docs/Mozilla/Thunderbird/Autokonfiguration
  * https://developer.mozilla.org/en-US/docs/Mozilla/Thunderbird/Autoconfiguration/FileFormat/HowTo