73 lines
3.1 KiB
Markdown
73 lines
3.1 KiB
Markdown
# 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
|
|
|
|
1. 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.
|