diff --git a/critical/mail/autoconfig.md b/critical/mail/autoconfig.md new file mode 100644 index 0000000..48d6938 --- /dev/null +++ b/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 + + + crans.org + Mail crans + crans + + redisdead.crans.org + 465 + SSL + %EMAILLOCALPART% + plain + + + owl.crans.org + 993 + STARTTLS + %EMAILLOCALPART% + plain + + + +``` + +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.