Bonjour à tous,
Nous sommes une collectivité territoriale utilisant BlueMind 5.7.
Notre webmail est authentifié via OpenID Connect, avec MFA obligatoire. Cela fonctionne parfaitement, mais le MFA ne couvre pas les accès classiques via les autres protocoles de messagerie.
Pour répondre à cette problématique, mais également proposer une solution mobile mieux intégrée à BlueMind, nous avons développé une application Android interne basée notamment sur le projet open source Thunderbird pour Android.
Notre application regroupe messagerie, calendrier et contacts, sans utiliser IMAP, SMTP, ActiveSync ni CalDAV.
Elle fonctionne directement et uniquement avec les API REST et le bus d’événements BlueMind :
-
Authentification par clés API individuelles, une par appareil, provisionnées par QR code depuis notre réseau interne.
-
Synchronisation incrémentale par
_versionet_changesetById. -
Notifications en temps réel via
/eventbus(SockJS), avec synchronisation périodique de secours. -
Envoi des messages via Outbox et l’API correspondante.
Nous disposons aujourd’hui d’un prototype pleinement fonctionnel, qui répond à nos exigences en matière de souveraineté numérique, de maîtrise de la solution et de déploiement via notre MDM. Nous préparons désormais son passage en phase pilote.
Nous avons également vérifié nos 49 appels REST : tous figurent dans la référence OpenAPI 5.7.3268.
Notre principal objectif est maintenant de nous assurer de la maintenabilité de cette application sur plusieurs années, notamment lors des futures mises à jour de BlueMind.
Après consultation de la documentation, des Javadocs et des changelogs, il nous reste quelques questions.
1. Compatibilité des API REST
Nous avons bien identifié la documentation API par version ainsi que les changelogs, qui détaillent régulièrement des évolutions des interfaces.
Une ancienne annonce BlueMind mentionnait également un outil de comparaison des incompatibilités entre versions.
Cet outil est-il toujours disponible ?
Plus généralement, les opérations publiées dans la référence OpenAPI sont-elles toutes considérées comme des interfaces publiques destinées aux intégrations tierces, avec des changements incompatibles annoncés lors des nouvelles versions ?
2. EventBus et notifications temps réel
Pour assurer la synchronisation en temps réel de notre application Android, nous utilisons directement /eventbus via SockJS, avec deux abonnements :
-
Messagerie :
bm.mailbox.hook.<uid utilisateur>.changed -
Calendrier :
bm.calendar.hook.<uid calendrier>.changed
Ces deux événements fonctionnent correctement sur notre environnement BlueMind 5.7 et nous permettent de déclencher une synchronisation quasiment instantanée lors de modifications.
Nous avons retrouvé des informations générales sur l’architecture EventBus dans votre blog technique ainsi que des références à certains événements dans les Javadocs.
En revanche, nous n’avons trouvé aucune documentation officielle décrivant précisément ces deux adresses, leur fonctionnement ou le format des notifications associées.
Nos questions sont donc les suivantes :
-
Ces deux événements sont-ils des interfaces officiellement supportées pour les applications tierces, ou des mécanismes internes à BlueMind ?
-
Peut-on compter sur la stabilité de leurs adresses et du format des notifications lors des futures mises à jour ?
-
Existe-t-il une documentation de référence ou une autre interface officiellement recommandée pour recevoir ces notifications en temps réel ?
C’est un point particulièrement important pour nous, car la synchronisation temps réel de notre application repose directement sur ces deux événements
3. Synchronisation incrémentale
Nous utilisons _changesetById sur les messages, calendriers et carnets d’adresses.
La Javadoc mentionne également des mécanismes de nettoyage des anciens changements (IChangesetCleanup, changeset_cleanup_retention_time).
Notre interrogation porte sur le cas d’un appareil resté longtemps hors ligne.
Existe-t-il une durée de rétention des changements, et comment un client peut-il détecter qu’un since est devenu trop ancien et qu’une resynchronisation complète est nécessaire ?
4. Authentification sans mot de passe
L’option « Désactiver le mot de passe » correspond bien à notre objectif de sécurité.
La documentation précise qu’elle interdit l’authentification classique depuis les applications autres que le webmail.
Pouvez-vous confirmer qu’elle bloque également les connexions avec mot de passe utilisateur sur /api/auth/login, tout en conservant l’utilisation des clés API permanentes ?
La modification automatisée de NO_PASSWD_AUTH, notamment pour les utilisateurs synchronisés depuis LDAP, est-elle une méthode officiellement supportée ?
5. Administration et révocation des clés API
Nous disposons d’un portail interne permettant de provisionner et de gérer les clés associées aux appareils.
Les opérations de gestion des clés sont bien documentées, mais elles s’effectuent dans le contexte de la session utilisateur.
Pour intervenir sur un autre compte, nous utilisons actuellement /api/auth/_su, ce qui nécessite des privilèges importants.
Existe-t-il une méthode permettant à un compte de service de créer, lister et révoquer les clés API des utilisateurs avec des droits plus restreints que Sudo ?
Nous avons également identifié ISessionsMgmt.logoutUser, qui permet de fermer toutes les sessions d’un utilisateur.
Existe-t-il un mécanisme plus ciblé permettant d’invalider immédiatement les accès associés à une seule clé API, sans déconnecter toutes les autres sessions de l’utilisateur ?
Ces questions visent surtout à confirmer que nous nous appuyons sur les interfaces prévues pour ce type d’intégration, sans dépendre de comportements internes susceptibles de changer.
Nous sommes très satisfaits des possibilités offertes par les API BlueMind, qui nous ont permis de développer un client mobile complet sans recourir aux protocoles classiques.
Nous serions également intéressés par les retours d’autres développeurs ayant réalisé des intégrations similaires.
Merci d’avance à l’équipe BlueMind et à la communauté pour vos éclaircissements.
Nous partagerons volontiers notre retour d’expérience sur ce développement si cela peut être utile à d’autres.