Anleitungen · Für Admins

Exchange (EWS) anbinden

Neruna Desktop spricht mit Exchange 2013 oder neuer über Exchange Web Services: Mail, Kalender und Kontakte – direkt oder hinter einem Reverse Proxy mit Client-Zertifikat.

Voraussetzungen

Exchange 2013, 2016, 2019 oder Subscription Edition. Für Exchange Online (Microsoft 365) gibt es die eigene Kontoart mit Microsoft-Anmeldung.
EWS ist für das Postfach erlaubt (Get-CASMailbox anna | fl EwsEnabled).
Die Adresse https://server/EWS/Exchange.asmx ist vom Computer aus per HTTPS erreichbar.

In Neruna einrichten

Konto hinzufügen → Microsoft Exchange (EWS).
Server: der Hostname genügt (mail.example.com), Neruna ergänzt /EWS/Exchange.asmx. Andere Pfade als ganze Adresse eintragen. Leer lassen: Neruna sucht die Adresse in der Konfiguration der Domain und im Neruna-Verzeichnis.
Benutzer: anna@example.com (UPN) oder FIRMA\anna; leer = E-Mail-Adresse.
Neruna prüft die Verbindung vor dem Speichern; Mail, Kalender und Kontakte kommen danach in einem Konto.

Anmeldung

Automatisch: Was der Server anbietet: Kerberos/NTLM (Negotiate) oder Basic. Unter Linux und macOS ohne zusätzliche Pakete.
Basic: Sofort mit Benutzername und Passwort, ohne Nachfrage des Servers. Für Reverse Proxys, die NTLM nicht durchreichen.
Nur Client-Zertifikat: Kein Passwort: Der Proxy prüft das Client-Zertifikat und meldet bei Exchange an (z. B. mit Kerberos Constrained Delegation).

Reverse Proxy mit Client-Zertifikat

Verlangt der Proxy vor Exchange ein Zertifikat, wählst du es im Konto unter «Client-Zertifikat»: aus einer Datei (.p12/.pfx – Neruna legt sie samt Passwort im Schlüsselbund des Computers ab, nicht in der Datenbank) oder unter Windows und macOS direkt aus dem Zertifikatsspeicher des Benutzers, auch von einer Smartcard. Neruna zeigt das Zertifikat, sobald der Proxy danach fragt – auch wenn seine Liste akzeptierter Aussteller es nicht nennt.

Der Proxy muss /EWS/ mit langen Anfragen durchlassen. NTLM braucht dieselbe Verbindung für mehrere Anfragen; reicht der Proxy das nicht durch, «Basic» wählen.

Was abgeglichen wird

E-Mail: Ordner und Mails (die neuesten 2000 pro Ordner, ältere auf Wunsch), gelesen, gekennzeichnet, beantwortet; Suche auf dem Server. Neue Mails jede Minute.
Kalender: Kalender mit Serien und deren Ausnahmen. Einladungen, Zu- und Absagen verschickt Exchange selbst.
Kontakte: Kontaktordner mit Namen, Firma, drei E-Mail-Adressen, Telefonnummern, Adressen, Notiz und Geburtstag.

Noch nicht: freigegebene Postfächer und öffentliche Ordner, Abwesenheitsnotiz, Verteilerlisten, Kontaktbilder.

Prüfen und Fehlersuche

Antwortet die Adresse mit 401, ist EWS erreichbar und verlangt eine Anmeldung:

curl -sI https://mail.example.com/EWS/Exchange.asmx
curl -sI --cert-type P12 --cert client.p12:password https://mail.example.com/EWS/Exchange.asmx

401: Benutzername oder Passwort stimmt nicht – oder der Proxy reicht NTLM nicht durch: «Basic» versuchen.
400 / 403: Der Proxy verlangt ein Client-Zertifikat oder akzeptiert das gewählte nicht.
404: Falsche Adresse – üblich ist /EWS/Exchange.asmx.
TLS: Zertifikatsfehler des Servers: Für Testserver gibt es im Konto «Jedes Server-Zertifikat akzeptieren».

Damit Neruna die Adresse selbst findet: EWS-Adresse im Neruna-Verzeichnis eintragen lassen (info@neruna.org) oder in der eigenen Autoconfig-Datei als <incomingServer type="exchange"> mit <ewsURL>.