# BlueMind 5.7 : développement d'un client Android via REST/EventBus, questions sur la maintenabilité des API

**URL:** <https://forum.bluemind.net/t/bluemind-5-7-developpement-dun-client-android-via-rest-eventbus-questions-sur-la-maintenabilite-des-api/5075>\
**Category:** Discussions\
**Created:** [October 27, 2026, 8:30pm UTC](https://forum.bluemind.net/t/bluemind-5-7-developpement-dun-client-android-via-rest-eventbus-questions-sur-la-maintenabilite-des-api/5075 "2026-10-27T20:30:30Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![didier.paulin](https://forum.bluemind.net/letter_avatar_proxy/v4/letter/d/e480ec/32.png) [@didier.paulin](https://forum.bluemind.net/u/didier.paulin)\
**Post date:** [October 27, 2026, 8:30pm UTC](https://forum.bluemind.net/t/bluemind-5-7-developpement-dun-client-android-via-rest-eventbus-questions-sur-la-maintenabilite-des-api/5075/1 "2026-10-27T20:30:30Z")

</div>

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 `_version` et `_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.

---

<div class="post-metadata">

**Author:** ![thomas.fricker](https://forum.bluemind.net/user_avatar/forum.bluemind.net/thomas.fricker/32/894_2.png) [@thomas.fricker](https://forum.bluemind.net/u/thomas.fricker)\
**Post date:** [November 7, 2026, 12:44pm UTC](https://forum.bluemind.net/t/bluemind-5-7-developpement-dun-client-android-via-rest-eventbus-questions-sur-la-maintenabilite-des-api/5075/2 "2026-11-07T12:44:35Z")

</div>

Bonjour,

EventBus

Ces deux adresses sont des mécanismes internes. Elles ne sont pas documentées pour les tiers, et ni leur nom ni le format des messages ne font l’objet d’un engagement de stabilité. Deux points concrets :

- bm.mailbox.hook..changed n’est plus utilisé par aucune de nos applications ; il ne subsiste que pour l’ancien bandeau. C’est votre dépendance la plus fragile. Notre webmail s’abonne à mailreplica.\<uid du propriétaire\>.updated, dont le message indique le dossier modifié (champ mailbox) et sa version : vous pouvez ne resynchroniser que ce dossier. Les changements d’arborescence arrivent sur la même adresse, avec isHierarchy: true.
- bm.calendar.hook..changed est utilisé par nos applications web. Son comportement a déjà changé en 5.7.4 : un seul message, regroupé sur 500 ms, au lieu de deux.

Nous vous conseillons de traiter chaque notification comme un simple signal « ce conteneur a changé », sans exploiter le contenu du message, puis de lancer la synchronisation incrémentale. Gardez la synchronisation périodique de secours et réabonnez-vous à chaque reconnexion du socket. Le droit de lecture sur le conteneur est vérifié au moment de l’abonnement.

Il n’existe pas aujourd’hui de documentation de référence ni d’autre mécanisme de notification recommandé pour les applications tierces, en dehors des protocoles standards.

1. Synchronisation incrémentale

Seules les suppressions sont purgées : la trace d’un élément supprimé disparaît après changeset\_cleanup\_retention\_time jours (60 par défaut, paramètre de configuration système). Les créations et les modifications ne se perdent pas, car le journal garde le dernier état de chaque élément.

Le serveur ne signale pas un since trop ancien. La réponse est normale, avec des listes created et updated complètes, mais il y manque les suppressions purgées, et les éléments concernés restent sur l’appareil. Nous vous conseillons de :

- mémoriser la date de la dernière synchronisation réussie de chaque conteneur et, au-delà de la rétention moins une marge (par exemple 50 jours), refaire une synchronisation complète. Avec since=0, created contient tous les éléments existants et aucune suppression : supprimez localement tout ce qui n’y figure pas ;
- repartir de zéro si la version renvoyée est inférieure au since envoyé, ce qui signifie que le conteneur a été recréé (notre webmail fait de même). Un conteneur supprimé renvoie une erreur 404 ;
- pour les messages, préférer \_filteredChangesetById avec mustNot: [“Deleted”], où un message effacé apparaît tout de suite dans deleted. Avec \_changesetById, il apparaît d’abord dans updated avec le drapeau Deleted pendant le délai de conservation des messages effacés (7 jours par défaut), et seulement ensuite dans deleted.

1. Authentification sans mot de passe

Oui. Quand l’option est active, /api/auth/login refuse le mot de passe de l’utilisateur, qu’il soit en base BlueMind ou dans l’annuaire LDAP/AD. Il en va de même pour IMAP, POP, SMTP, ActiveSync, CalDAV/CardDAV et MAPI. Les clés API restent acceptées, qu’elles soient transmises comme mot de passe à login ou directement dans l’en-tête X-BM-ApiKey.

Attention : l’activation ne ferme pas les sessions déjà ouvertes avec un mot de passe. Fermez-les ensuite avec bm-cli user logout --email .

Pour l’automatisation, l’option correspond à la propriété NO\_PASSWD\_AUTH (valeur “true”) de l’objet User, modifiée via IUser.update. C’est ce que font la console d’administration et bm-cli user mfa --email --no-allow-password. update remplace l’utilisateur entier : lisez-le, modifiez la propriété, puis renvoyez l’objet complet. La synchronisation LDAP/AD conserve cette propriété.

1. Clés API

En 5.7, IAPIKeys ne gère que les clés de l’utilisateur de la session, et il n’existe pas de variante d’administration : \_su reste la seule méthode. Pour en limiter la portée, le rôle sudo peut être délégué sur une unité d’organisation plutôt que sur tout le domaine. Le compte de service ne pourra alors prendre l’identité que des utilisateurs de cette unité.

Il n’existe pas non plus de révocation ciblée d’une clé. Supprimer une clé empêche immédiatement toute nouvelle authentification avec elle, mais ne ferme pas les sessions déjà ouvertes avec cette clé, qui restent valides tant qu’elles sont utilisées. Pour couper un appareil, supprimez d’abord la clé, puis fermez les sessions de l’utilisateur (bm-cli user logout) ; l’ordre compte. Les autres appareils peuvent se reconnecter avec leur propre clé ; seul le webmail demandera une nouvelle authentification.

---

<div class="post-metadata">

**Author:** ![didier.paulin](https://forum.bluemind.net/letter_avatar_proxy/v4/letter/d/e480ec/32.png) [@didier.paulin](https://forum.bluemind.net/u/didier.paulin)\
**Post date:** [November 9, 2026, 9:38am UTC](https://forum.bluemind.net/t/bluemind-5-7-developpement-dun-client-android-via-rest-eventbus-questions-sur-la-maintenabilite-des-api/5075/3 "2026-11-09T09:38:28Z")

</div>

Bonjour Thomas,

Merci beaucoup pour ces réponses, très claires et précieuses !

Voici ce que nous avons mis en place côté application Android, qui repose entièrement sur les API REST de BlueMind (avec une flotte cible d’environ 500 mobiles) :

- **Push mail** : nous écoutons désormais `mailreplica.<owner>.updated`, comme votre webmail, tout en conservant temporairement `bm.mailbox.hook` pendant la transition. Chaque notification est considérée comme un simple signal de changement, déclenchant une synchronisation incrémentale. Nous avons également prévu une **synchronisation périodique de secours** et un réabonnement à chaque reconnexion.

- **Synchronisation incrémentale** : nous gérons les suppressions qui ne figurent plus dans les changesets après expiration de leur rétention, les éventuels retours en arrière de version (conteneur restauré ou recréé), ainsi que le drapeau `Deleted`.

- **Authentification** : exclusivement par clé API, sans utilisation du mot de passe utilisateur. Nous avons également bien pris en compte l’ordre de révocation recommandé : suppression de la clé, puis fermeture des sessions.

Comme notre application repose **entièrement sur vos API REST** , nous aimerions clarifier un dernier point pour garantir sa pérennité et limiter les risques de régression lors des futures mises à jour de BlueMind.

**Concernant la stabilité des endpoints REST :**

Parmi ceux que nous utilisons actuellement (`_changesetById`, `_version`, `_mgetById`, `_search`, téléchargement des messages au format EML et `containers/_manage/_list`), lesquels sont considérés comme **stables et officiellement supportés**?

Certains sont-ils plutôt destinés à un usage interne et donc susceptibles d’évoluer sans garantie de compatibilité, à l’image du bus d’événements ?

Encore merci pour votre disponibilité et pour la qualité de vos réponses !

---

<div class="post-metadata">

**Author:** ![thomas.fricker](https://forum.bluemind.net/user_avatar/forum.bluemind.net/thomas.fricker/32/894_2.png) [@thomas.fricker](https://forum.bluemind.net/u/thomas.fricker)\
**Post date:** [November 9, 2026, 11:36am UTC](https://forum.bluemind.net/t/bluemind-5-7-developpement-dun-client-android-via-rest-eventbus-questions-sur-la-maintenabilite-des-api/5075/4 "2026-11-09T11:36:50Z")

</div>

Bonjour,  
pour les endpoints que vous utilisez, ils sont stable et on s’engage de les garder compatible dans cette façon, au moins jusqu’à la version 6 (qui est encore loin :-))
