crans
/
documentation
mirror of https://gitlab.crans.org/nounous/documentation.git
19
0
Fork 0
Code Issues Projects Releases Wiki Activity
documentation/services/mail/autoconfig.md

3.1 KiB
Raw Blame History

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 :

<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.