[critical/mail] Ajout de autoconfig.md

critical/mail/autoconfig.md

@@ -0,0 +1,66 @@
+# Autoconfig
+
+Dans le protocole mail, la configuration du client mail est généralement laissé
+à la charge du client. C'est à lui de savoir à quels serveurs il souhaite se
+connecter, sur quels ports et en précisant le mécanisme ainsi que les
+informations d'authentification. Cependant ces informations n'étant pas toujours
+facilement accessible à l'utilisateur, thunderbird a mis en place une manière
+externe par laquelle le client peut récupérer toutes les informations
+nécessaires à sa configuration de tels sortes que l'utilisateur n'ait qu'à
+fournir son adresse mail et son mot de passe.
+
+## Principe
+
+Attention, ce mécanisme de création de compte n'est pour le moment normalisé
+dans aucune RFC, c'est le client mail qui choisit sa propre implementation du
+mécanisme. Il est donc complètement possible que
+    1. le client n'implémente pas du tout le mécanisme ou qu'il n'en implémente
+       qu'une partie
+    2. deux clients différents n'aient pas la même implémentation du mécanisme
+
+Quand on lui fournit une adresse mail de la forme `utilisateur@domain.tld`, le
+client va essayer de récupérer le contenu de l'uri suivante
+`http://autoconfig.domain.tld/mail/config-v1.1.xml` qui est un fichier xml assez
+simple qui décrit en quelques lignes une configuration que le client peut
+adopter. Une référence complète de sa syntaxe est trouvable à l'adresse suivante :
+`https://wiki.mozilla.org/Thunderbird:Autoconfiguration:ConfigFileFormat`. Voilà
+une configuration minimale dans le cas du crans :
+```xml
+<clientConfig version="1.0">
+  <emailProvider id="crans.org">
+    <domain>crans.org</domain>
+    <displayName>Mail crans</displayName>
+    <displayShortName>crans</displayShortName>
+    <incomingServer type="smtp">
+      <hostname>redisdead.crans.org</hostname>
+      <port>465</port>
+      <socketType>SSL</socketType>
+      <username>%EMAILLOCALPART%</username>
+      <authentication>plain</authentication>
+    </incomingServer>
+    <outgoingServer type="imap">
+      <hostname>owl.crans.org</hostname>
+      <port>993</port>
+      <socketType>STARTTLS</socketType>
+      <username>%EMAILLOCALPART%</username>
+      <authentication>plain</authentication>
+    </outgoingServer>
+  </emailProvider>
+</clientConfig>
+```
+
+Le fichier de configuration se lit assez bien, on dit à l'utilisateur de faire
+  - du smtp pour envoyer des mails en se connectant avec une connexion chiffrée
+    à `redisdead.crans.org` sur le port `465` et en utilisant la partie locale
+    de son adresse mail (le `user` dans `user@domain.tld`) comme nom
+    d'utilisateur et en utilisant le mode d'authentification ~~plain~~ LOGIN
+    (voir la suite)
+  - du imap pour recevoir les mails en se connectant avec une connexion STARTTLS
+    à `owl.crans.org` sur le port `993` et en utilisant la partie locale de son
+    adresse mail comme nom d'utilisateur et en utilisant le mode
+    d'authentification ~~plain~~ LOGIN
+
+La plupart des clients mails interprète l'utilisation du mot clé `plain` comme
+étant le méchanisme `login` du protocole SASL et non le méchanisme `plain` de ce
+même protocole. Au crans, les deux méthodes d'authentification étant supporté,
+cela ne pose pas de soucis.