Neruna Prova la beta

Guide · Per gli admin

Configurazione automatica per il tuo dominio.

Chi inserisce in Neruna solo indirizzo e-mail e password deve essere a posto – con mail, calendario e contatti. Basta un piccolo file XML sul tuo server web.

Come cerca Neruna

Dopo «Avanti», Neruna interroga questi punti in ordine – vince la prima risposta. Ognuno ha al massimo 8 secondi, solo in forma cifrata (HTTPS).

  1. Neruna Cloud – se il dispositivo è collegato al cloud della tua organizzazione, le impostazioni arrivano da lì.

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

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

  4. Il database autoconfig pubblico di Mozilla per i grandi provider. Conosce solo il dominio, mai l'indirizzo completo.

Se Neruna non trova nulla, propone mail.dominio per IMAP e SMTP e l'indirizzo e-mail come nome utente – da controllare e adattare. Poi cerca anche calendari e contatti in /.well-known.

Al momento Neruna non valuta i record DNS SRV (RFC 6186).

Il file

Il consueto formato autoconfig (config-v1.1.xml), letto anche da altri programmi di posta. Neruna legge in più calendario e rubrica:

<?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 – cifrato dall'inizio (IMAP 993, SMTP 465); STARTTLS – cifratura dopo la connessione (IMAP 143, SMTP 587).
authentication
password-cleartext significa nome utente e password – sulla connessione cifrata, non in chiaro sulla rete.
username
Segnaposto: %EMAILADDRESS% (indirizzo completo), %EMAILLOCALPART% (prima della @), %EMAILDOMAIN%.
calendar, addressBook
Facoltativo, direttamente in clientConfig. Basta l'indirizzo del server – Neruna trova da solo i singoli calendari e rubriche.

DNS e server web

Crea per autoconfig.tuo-dominio un record DNS che punta a un server web e metti lì il file in /mail/config-v1.1.xml:

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

Il certificato deve essere valido per autoconfig.tuo-dominio – Neruna interroga solo via HTTPS e scarta i certificati non validi.

Non puoi aggiungere un nome host? Allora basta il file sul dominio principale in /.well-known/autoconfig/mail/config-v1.1.xml.

Più domini sullo stesso server di posta: ogni dominio ha bisogno del proprio record autoconfig, il file può essere ovunque lo stesso. Neruna aggiunge ?emailaddress=… – un server web statico lo ignora semplicemente.

Verificare

Se torna il file XML, lo trova anche Neruna:

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

In Neruna, «Aggiungi account» mostra dopo «Avanti» da dove arrivano le impostazioni (ad es. «autoconfig.example.com»). Se non compare nulla, nessun punto ha risposto.

Trovare calendari e contatti →