Guide · Per gli admin

Collegare Exchange (EWS)

Neruna Desktop comunica con Exchange 2013 o successivo tramite Exchange Web Services: posta, calendario e contatti – direttamente o dietro un reverse proxy con certificato client.

Requisiti

Exchange 2013, 2016, 2019 o Subscription Edition. Per Exchange Online (Microsoft 365) c'è un tipo di account a parte con l'accesso Microsoft.
EWS è consentito per la casella (Get-CASMailbox anna | fl EwsEnabled).
L'indirizzo https://server/EWS/Exchange.asmx è raggiungibile dal computer via HTTPS.

Configurazione in Neruna

Aggiungi account → Microsoft Exchange (EWS).
Server: basta il nome host (mail.example.com), Neruna aggiunge /EWS/Exchange.asmx. Altri percorsi come indirizzo completo. Lasciato vuoto: Neruna cerca l'indirizzo nella configurazione del dominio e nell'elenco Neruna.
Utente: anna@example.com (UPN) o AZIENDA\anna; vuoto = indirizzo e-mail.
Neruna verifica la connessione prima di salvare; posta, calendario e contatti arrivano poi in un solo account.

Accesso

Automatico: Ciò che offre il server: Kerberos/NTLM (Negotiate) o Basic. Su Linux e macOS senza pacchetti aggiuntivi.
Basic: Subito con nome utente e password, senza richiesta del server. Per i reverse proxy che non inoltrano NTLM.
Solo certificato client: Nessuna password: il proxy verifica il certificato client e accede a Exchange (ad es. con Kerberos Constrained Delegation).

Reverse proxy con certificato client

Se il proxy davanti a Exchange richiede un certificato, lo scegli nell'account in «Certificato client»: da un file (.p12/.pfx – Neruna lo conserva con la sua password nel portachiavi del computer, non nel database) oppure, su Windows e macOS, direttamente dall'archivio certificati dell'utente, anche da una smart card. Neruna presenta il certificato non appena il proxy lo chiede – anche se il suo elenco di emittenti accettati non lo nomina.

Il proxy deve lasciar passare /EWS/, anche le richieste lunghe. NTLM ha bisogno della stessa connessione per più richieste; se il proxy non la mantiene, scegli «Basic».

Cosa viene sincronizzato

E-mail: Cartelle e messaggi (i 2000 più recenti per cartella, i più vecchi su richiesta), letto, contrassegnato, risposto; ricerca sul server. Nuova posta ogni minuto.
Calendario: Calendari con serie e relative eccezioni. Inviti, accettazioni e rifiuti li invia Exchange stesso.
Contatti: Cartelle contatti con nome, azienda, tre indirizzi e-mail, numeri di telefono, indirizzi, nota e compleanno.

Non ancora: caselle condivise e cartelle pubbliche, risposta di assenza, liste di distribuzione, foto dei contatti.

Verifica e risoluzione dei problemi

Se l'indirizzo risponde 401, EWS è raggiungibile e chiede l'accesso:

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: Nome utente o password errati – oppure il proxy non inoltra NTLM: provare «Basic».
400 / 403: Il proxy richiede un certificato client o non accetta quello scelto.
404: Indirizzo errato – di solito è /EWS/Exchange.asmx.
TLS: Errore del certificato del server: per i server di test l'account offre «Accetta qualsiasi certificato del server».

Perché Neruna trovi da solo l'indirizzo: fai aggiungere l'indirizzo EWS all'elenco Neruna (info@neruna.org) o inseriscilo nel tuo file autoconfig come <incomingServer type="exchange"> con <ewsURL>.