Anleitungen · Für Admins

Automatische Einrichtung für deine Domain.

Wer in Neruna nur E-Mail-Adresse und Passwort eingibt, soll fertig sein – mit Mail, Kalender und Kontakten. Dafür genügt eine kleine XML-Datei auf deinem Webserver.

So sucht Neruna

Nach «Weiter» fragt Neruna der Reihe nach diese Stellen – die erste Antwort gewinnt. Jede Stelle hat höchstens 8 Sekunden Zeit, gefragt wird nur verschlüsselt (HTTPS).

Neruna Cloud – ist das Gerät mit der Cloud deiner Organisation verbunden, kommen die Einstellungen von dort.
https://autoconfig.example.com/mail/config-v1.1.xml
https://example.com/.well-known/autoconfig/mail/config-v1.1.xml
Die öffentliche Autoconfig-Datenbank von Mozilla für grosse Anbieter. Sie erfährt nur die Domain, nie die ganze Adresse.

Findet Neruna nichts, schlägt es mail.domain für IMAP und SMTP und die E-Mail-Adresse als Benutzernamen vor – zum Prüfen und Anpassen. Kalender und Kontakte sucht Neruna danach zusätzlich unter /.well-known.

DNS-SRV-Einträge (RFC 6186) wertet Neruna derzeit nicht aus.

Die Datei

Das übliche Autoconfig-Format (config-v1.1.xml), das auch andere Mailprogramme lesen. Neruna liest zusätzlich Kalender und Adressbuch:

<?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 – verschlüsselt ab Verbindungsbeginn (IMAP 993, SMTP 465); STARTTLS – Verschlüsselung nach dem Verbindungsaufbau (IMAP 143, SMTP 587).
authentication: password-cleartext heisst: Benutzername und Passwort – über die verschlüsselte Verbindung, nicht offen im Netz.
username: Platzhalter: %EMAILADDRESS% (ganze Adresse), %EMAILLOCALPART% (vor dem @), %EMAILDOMAIN%.
calendar, addressBook: Optional, direkt in clientConfig. Die Adresse des Servers genügt – die einzelnen Kalender und Adressbücher findet Neruna selbst.

DNS und Webserver

Lege für autoconfig.deine-domain einen DNS-Eintrag an, der auf einen Webserver zeigt, und lege dort die Datei unter /mail/config-v1.1.xml ab:

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

Das Zertifikat muss für autoconfig.deine-domain gültig sein – Neruna fragt nur über HTTPS und verwirft ungültige Zertifikate.

Kein eigener Hostname möglich? Dann genügt die Datei auf der Hauptdomain unter /.well-known/autoconfig/mail/config-v1.1.xml.

Mehrere Domains auf demselben Mailserver: Jede Domain braucht ihren eigenen autoconfig-Eintrag, die Datei darf überall dieselbe sein. Neruna hängt ?emailaddress=… an – ein statischer Webserver ignoriert das einfach.

Testen

Kommt die XML-Datei zurück, findet sie auch Neruna:

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

In Neruna zeigt «Konto hinzufügen» nach «Weiter» an, woher die Einstellungen stammen (z. B. «autoconfig.example.com»). Steht dort nichts, hat keine Stelle geantwortet.

Kalender und Kontakte finden →