Qu'est-ce que l'Offline Key Exchange ?


L'Offline Key Exchange est une fonctionnalité intégrée aux SmartBoxes MS5 et MS4 qui permet aux organisations de bénéficier d'un accès ininterrompu à leurs clés, même si la SmartBox perd sa connexion au cloud. Cela peut arriver, par exemple, si la SmartBox perd sa connexion Wi-Fi, Ethernet ou cellulaire.

Pour les clients disposant d'une SmartBox de la série MS3 ou d'une génération antérieure, consultez le Plan d'Urgence en cas de Panne pour connaître les mesures à prendre pendant les pannes.

 

Comment fonctionne l'Offline Key Exchange


Les SmartBoxes synchronisent régulièrement les permissions d'accès aux clés et l'inventaire depuis le cloud (c'est-à-dire les applications mobiles et de bureau Keycafe). Lorsqu'une SmartBox perd sa connexion internet, sa mémoire intégrée rétablit son inventaire de clés et les permissions des utilisateurs à la dernière synchronisation. Généralement, cela correspond à quelques minutes auparavant, mais cela peut aller de quelques secondes à quelques heures, selon la force du signal, le moment et le forfait de l'organisation. Cela signifie que les échanges de clés les plus récents ou les permissions nouvellement créées peuvent ne pas être reconnus avec l'Offline Key Exchange.

Une fois que la SmartBox rétablit une connexion internet, elle tentera de synchroniser les échanges de clés effectués pendant qu'elle était hors ligne vers le cloud, ce qui sera reflété dans votre application Keycafe par un symbole hors ligne. Cela peut prendre quelques minutes, il est donc préférable d'attendre que la synchronisation soit complète avant d'utiliser à nouveau la SmartBox.

Screenshot 2026 09 18 at 12.28.12 PM

Fréquence de Synchronisation


La SmartBox synchronisera normalement les nouvelles permissions et les changements d'inventaire dans les 5 minutes, mais cela peut être influencé par divers facteurs, notamment la fréquence des retraits et restitutions de clés. Il existe une garantie de synchronisation des permissions qui varie selon le forfait :

  • 15 minutes pour Business Pro

  • 2 heures pour Premium

  • 6 heures pour Lite

La garantie de synchronisation de 15 minutes de Business Pro est bénéfique pour les sites qui gèrent un volume élevé de retraits et de restitutions de clés (~50+ par jour ouvrable).

 

Limitations


L'Offline Key Exchange est une fonctionnalité de secours d'urgence, et offre donc des fonctionnalités réduites par rapport au fonctionnement habituel d'une SmartBox connectée au cloud.

  1. Si la SmartBox est éteinte ou réinitialisée pendant la panne, l'Offline Key Exchange ne fonctionnera pas.

  2. Les retraits et restitutions de clés via l'application mobile ne sont pas possibles tant que la SmartBox n'est pas connectée au cloud.

  3. Toute modification effectuée dans l'application mobile ou de bureau Keycafe pendant l'Offline Key Exchange ne sera pas reconnue par la SmartBox tant qu'une connexion au cloud n'est pas rétablie.

  4. Les QR codes pour l'authentification des utilisateurs ne seront pas disponibles dans l'application mobile pendant une panne complète du cloud. La prise en charge de la disponibilité des QR codes sur l'application même en cas de panne complète est prévue dans la feuille de route du produit pour une future version.

  5. Les limites de clés maximales ne seront pas appliquées lorsque l'Offline Key Exchange est utilisée. Une fois qu'une connexion au cloud est rétablie, la limite reprendra.

  6. Certaines méthodes d'authentification utilisateur ne peuvent pas être utilisées pendant l'Offline Key Exchange. Voici une liste des options d'authentification qui fonctionnent / ne fonctionnent pas :

Méthode d'authentification

Fonctionne avec l'Offline Key Exchange

Code d'accès

✔️

Code de réservation / QR Code de réservation

✔️

Code clé

✔️

Badge utilisateur

✔️

QR Code utilisateur

-

Application mobile

-

Numéro de téléphone

-

Code Global SmartBox

-

Code d'alias

-

 

Problèmes de synchronisation


En raison de la nature imprévisible des pannes et du fonctionnement de la cadence de synchronisation de la SmartBox, l'inventaire des clés et les journaux d'accès peuvent se désynchroniser après l'utilisation de l'Offline Key Exchange. Voici quelques problèmes courants et leurs solutions :

Problème 1 :
Les retraits, restitutions de clés et changements de permissions qui surviennent immédiatement avant une panne ne sont pas reflétés sur la SmartBox pendant l'Offline Key Exchange.

Solution :
Attendez que la panne soit résolue avant de tenter de retirer ou de restituer ces clés, ou d'utiliser la permission nouvellement créée. Si une clé doit être accessible, les codes hors ligne peuvent être utilisés pour ouvrir les casiers – n'oubliez pas d'ajuster et de confirmer l'inventaire des casiers une fois qu'internet est rétabli.

 

Problème 2 :
La SmartBox est de nouveau en ligne après une période hors ligne, et un retrait ou une restitution de clé qui a été effectué pendant l'Offline Key Exchange n'est pas reflété dans le journal d'historique.

Solution :
Lorsque la SmartBox est de nouveau en ligne et reconnaît un conflit entre l'activité d'Offline Key Exchange et les échanges de clés en ligne qui ont eu lieu immédiatement avant la panne (c'est-à-dire l'activité que la SmartBox n'a pas reconnue pendant l'Offline Key Exchange), elle ignorera cette entrée du journal d'historique et enverra un e-mail au Propriétaire de l'Organisation avec les détails. Si vous remarquez que l'inventaire des casiers de la SmartBox dans l'application Keycafe n'est pas cohérent avec les échanges de clés effectués hors ligne, vous pouvez ouvrir tous les casiers et ajuster manuellement l'inventaire des casiers.

 

Implications pour l'API


Avec l'introduction de l'Offline Key Exchange, l'Exchange API a été dépréciée. Pour plus d'informations, consultez notre Référence API.