Neruna Tester la bêta

Guides · Pour les admins

Configuration automatique pour votre domaine.

Il suffit de saisir l'adresse e-mail et le mot de passe dans Neruna pour être prêt – mail, agenda et contacts compris. Un petit fichier XML sur votre serveur web suffit.

Comment Neruna cherche

Après « Suivant », Neruna interroge ces emplacements dans l'ordre – la première réponse l'emporte. Chacun a au plus 8 secondes, et uniquement en chiffré (HTTPS).

  1. Neruna Cloud – si l'appareil est connecté au cloud de votre organisation, les réglages viennent de là.

  2. https://autoconfig.example.com/mail/config-v1.1.xml

  3. https://example.com/.well-known/autoconfig/mail/config-v1.1.xml

  4. La base autoconfig publique de Mozilla pour les grands fournisseurs. Elle n'apprend que le domaine, jamais l'adresse complète.

Si Neruna ne trouve rien, il propose mail.domaine pour IMAP et SMTP et l'adresse e-mail comme nom d'utilisateur – à vérifier et ajuster. Il cherche ensuite aussi agendas et contacts sous /.well-known.

Neruna n'exploite pas les entrées DNS SRV (RFC 6186) pour le moment.

Le fichier

Le format autoconfig habituel (config-v1.1.xml), lu aussi par d'autres logiciels de messagerie. Neruna lit en plus agenda et carnet d'adresses :

<?xml version="1.0" encoding="UTF-8"?>
<clientConfig version="1.1">
  <emailProvider id="example.com">
    <domain>example.com</domain>
    <displayName>Example AG</displayName>
    <incomingServer type="imap">
      <hostname>mail.example.com</hostname>
      <port>993</port>
      <socketType>SSL</socketType>
      <authentication>password-cleartext</authentication>
      <username>%EMAILADDRESS%</username>
    </incomingServer>
    <outgoingServer type="smtp">
      <hostname>mail.example.com</hostname>
      <port>587</port>
      <socketType>STARTTLS</socketType>
      <authentication>password-cleartext</authentication>
      <username>%EMAILADDRESS%</username>
    </outgoingServer>
  </emailProvider>
  <calendar type="caldav">
    <serverURL>https://dav.example.com/</serverURL>
    <username>%EMAILADDRESS%</username>
  </calendar>
  <addressBook type="carddav">
    <serverURL>https://dav.example.com/</serverURL>
    <username>%EMAILADDRESS%</username>
  </addressBook>
</clientConfig>
socketType
SSL – chiffré dès la connexion (IMAP 993, SMTP 465) ; STARTTLS – chiffrement après la connexion (IMAP 143, SMTP 587).
authentication
password-cleartext signifie nom d'utilisateur et mot de passe – via la connexion chiffrée, pas en clair sur le réseau.
username
Variables : %EMAILADDRESS% (adresse complète), %EMAILLOCALPART% (avant le @), %EMAILDOMAIN%.
calendar, addressBook
Facultatif, directement dans clientConfig. L'adresse du serveur suffit – Neruna trouve lui-même les agendas et carnets d'adresses.

DNS et serveur web

Créez pour autoconfig.votre-domaine une entrée DNS pointant vers un serveur web, et placez-y le fichier sous /mail/config-v1.1.xml :

autoconfig.example.com.   3600  IN  CNAME  www.example.com.

Le certificat doit être valable pour autoconfig.votre-domaine – Neruna n'interroge qu'en HTTPS et rejette les certificats invalides.

Impossible d'ajouter un nom d'hôte ? Le fichier sur le domaine principal sous /.well-known/autoconfig/mail/config-v1.1.xml suffit alors.

Plusieurs domaines sur le même serveur : chaque domaine a besoin de sa propre entrée autoconfig, le fichier peut être partout le même. Neruna ajoute ?emailaddress=… – un serveur web statique l'ignore simplement.

Tester

Si le fichier XML revient, Neruna le trouve aussi :

curl -s "https://autoconfig.example.com/mail/config-v1.1.xml?emailaddress=anna@example.com"

Dans Neruna, « Ajouter un compte » affiche après « Suivant » d'où viennent les réglages (p. ex. « autoconfig.example.com »). Si rien n'apparaît, aucun emplacement n'a répondu.

Trouver agendas et contacts →