Guides · Pour les admins

Connecter Exchange (EWS)

Neruna Desktop dialogue avec Exchange 2013 ou plus récent via Exchange Web Services : e-mail, agenda et contacts – directement ou derrière un reverse proxy avec certificat client.

Prérequis

Exchange 2013, 2016, 2019 ou Subscription Edition. Pour Exchange Online (Microsoft 365), il existe un type de compte distinct avec la connexion Microsoft.
EWS est autorisé pour la boîte (Get-CASMailbox anna | fl EwsEnabled).
L'adresse https://serveur/EWS/Exchange.asmx est joignable depuis l'ordinateur en HTTPS.

Configuration dans Neruna

Ajouter un compte → Microsoft Exchange (EWS).
Serveur : le nom d'hôte suffit (mail.example.com), Neruna ajoute /EWS/Exchange.asmx. Saisir d'autres chemins comme adresse complète. Laissé vide : Neruna cherche l'adresse dans la configuration du domaine et dans l'annuaire Neruna.
Utilisateur : anna@example.com (UPN) ou ENTREPRISE\anna ; vide = adresse e-mail.
Neruna vérifie la connexion avant d'enregistrer ; e-mail, agenda et contacts arrivent ensuite dans un seul compte.

Authentification

Automatique: Ce que le serveur propose : Kerberos/NTLM (Negotiate) ou Basic. Sous Linux et macOS sans paquets supplémentaires.
Basic: Directement avec nom d'utilisateur et mot de passe, sans demande du serveur. Pour les reverse proxies qui ne transmettent pas NTLM.
Certificat client seul: Pas de mot de passe : le proxy vérifie le certificat client et s'authentifie auprès d'Exchange (p. ex. avec Kerberos Constrained Delegation).

Reverse proxy avec certificat client

Si le proxy devant Exchange exige un certificat, vous le choisissez dans le compte sous « Certificat client » : depuis un fichier (.p12/.pfx – Neruna le conserve avec son mot de passe dans le trousseau de l'ordinateur, pas dans la base de données) ou, sous Windows et macOS, directement dans le magasin de certificats de l'utilisateur, cartes à puce comprises. Neruna présente le certificat dès que le proxy le demande – même si sa liste d'émetteurs acceptés ne le mentionne pas.

Le proxy doit laisser passer /EWS/, y compris les requêtes longues. NTLM a besoin de la même connexion pour plusieurs requêtes ; si le proxy ne la conserve pas, choisissez « Basic ».

Ce qui est synchronisé

E-mail: Dossiers et e-mails (les 2000 plus récents par dossier, les plus anciens sur demande), lu, marqué, répondu ; recherche sur le serveur. Nouveaux e-mails chaque minute.
Agenda: Agendas avec séries et leurs exceptions. Exchange envoie lui-même invitations, acceptations et refus.
Contacts: Dossiers de contacts avec nom, entreprise, trois adresses e-mail, téléphones, adresses, note et anniversaire.

Pas encore : boîtes partagées et dossiers publics, réponse d'absence, listes de distribution, photos des contacts.

Vérification et dépannage

Si l'adresse répond 401, EWS est joignable et demande une authentification :

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: Nom d'utilisateur ou mot de passe incorrect – ou le proxy ne transmet pas NTLM : essayer « Basic ».
400 / 403: Le proxy exige un certificat client ou n'accepte pas celui choisi.
404: Adresse incorrecte – l'habituelle est /EWS/Exchange.asmx.
TLS: Erreur de certificat du serveur : pour les serveurs de test, le compte propose « Accepter tout certificat de serveur ».

Pour que Neruna trouve l'adresse tout seul : faites ajouter l'adresse EWS à l'annuaire Neruna (info@neruna.org) ou placez-la dans votre propre fichier autoconfig comme <incomingServer type="exchange"> avec <ewsURL>.