Étude de cas : accès à une pièce pour une seule personne avec Server Approval
L’exigence
Un client qui gère une pièce à accès restreint (par exemple une salle serveur, un coffre-fort ou un laboratoire) avait besoin d’une règle simple mais stricte, appliquée à la porte :
Une seule personne peut se trouver dans la pièce à la fois. La personne suivante ne doit pas être admise tant que l’occupant actuel n’a pas enregistré sa sortie.
L’appareil Cams gère la vérification de l’identité, et Server Approval étend cette fonction en permettant à votre propre logiciel d’ajouter par-dessus la logique « y a-t-il déjà quelqu’un à l’intérieur ? », afin de décider, en temps réel, si un utilisateur vérifié doit réellement être admis.
Pourquoi Server Approval convient
Par défaut (Server Approval désactivé), l’appareil accorde l’accès dès qu’il vérifie l’utilisateur localement ; votre logiciel en est informé ensuite. Cela convient pour une simple journalisation, mais cela ne permet pas d’empêcher l’entrée.
Avec Server Approval activé, l’appareil suspend l’opération après la vérification locale et attend que votre logiciel confirme le pointage avant d’ouvrir la porte. Cet aller-retour permet d’intégrer une logique métier, comme « y a-t-il déjà quelqu’un à l’intérieur ? », directement dans la décision d’accès, au lieu de simplement l’enregistrer après coup.
Fonctionnement du flux
- Un utilisateur pointe sur l’appareil.
- L’appareil le vérifie localement, puis envoie une requête JSON à l’URL de rappel enregistrée.
- Votre logiciel vérifie son propre état d’occupation et répond :
{"status": "done"}→ l’appareil accepte le pointage et ouvre la porte.{"status": "reject"}→ l’appareil refuse l’accès et garde la porte fermée.
- Lors de la sortie, votre logiciel met à jour l’état d’occupation afin que la prochaine entrée soit évaluée correctement.
Exemple avec deux utilisateurs
L’utilisateur X entre. L’appareil vérifie X, appelle l’URL de rappel, votre logiciel constate que la pièce est vide et renvoie done. X entre. Votre logiciel marque la pièce comme occupée.
L’utilisateur Y tente d’entrer alors que X est toujours à l’intérieur. L’appareil vérifie Y et appelle l’URL de rappel, comme pour tout autre pointage. Votre logiciel constate que la pièce est toujours occupée et renvoie reject. L’appareil refuse Y et la porte reste fermée. Y n’est jamais admis tant que votre logiciel ne l’indique pas autrement.
X sort. Votre logiciel enregistre la sortie et supprime l’indicateur d’occupation.
Y réessaie. Le même flux de rappel s’applique, mais cette fois votre logiciel constate que la pièce est libre et renvoie done. Y entre.
Le rôle de l’appareil ne change jamais : il vérifie toujours la personne et demande à votre logiciel quelle action effectuer ensuite. La seule chose qui change entre « reject » et « done » est ce que votre logiciel sait sur la personne actuellement à l’intérieur.
Notes de mise en œuvre
- La vérification de l’occupation relève entièrement de votre responsabilité : l’appareil ne garde aucune mémoire des personnes présentes. Un simple indicateur ou un enregistrement par pièce suffit pour un espace à occupation unique ; les configurations multi-pièces ou à capacité multiple nécessitent une petite table d’états indexée par pièce ou par appareil.
- Assurez-vous que les événements de sortie sont systématiquement enregistrés, car une sortie manquée bloquera définitivement la pièce, même après le départ de l’utilisateur.
- Testez le chemin de rappel en local avant la mise en service. Consultez notre guide complémentaire testing Cams API callbacks locally with tunneling tools pour configurer ngrok, Cloudflare Tunnel ou localhost.run sur votre environnement de développement.
Points à prévoir : connectivité et réponses de rappel
Server Approval repose sur un aller-retour en temps réel entre l’appareil et votre serveur, et sur la capacité de votre serveur à toujours répondre correctement. Deux situations méritent d’être anticipées :
L’appareil est hors ligne. Il ne peut pas envoyer le rappel de vérification en temps réel ; votre logiciel n’a donc jamais la possibilité de répondre done ou reject. L’appareil affiche un message « Déconnecté » et refuse le pointage directement ; il ne bascule pas vers un accès purement local.
Votre rappel renvoie autre chose que {"status": "done"} ou {"status": "reject"}. Une réponse invalide ou inattendue reste bloquée dans la file d’attente, et l’appareil ne transmettra plus aucune donnée de pointage à votre rappel tant que le problème n’est pas résolu. La porte reste donc fermée, non seulement pour cet utilisateur, mais aussi pour tous ceux qui suivent, jusqu’à ce que votre rappel réponde à nouveau correctement.
En d’autres termes, la garantie d’une seule personne à la fois n’est aussi solide que la connexion réseau de l’appareil et la fiabilité des réponses de votre rappel. Pour les déploiements en production, tenez compte de ces deux éléments dans votre configuration, par exemple avec des connexions filaires plutôt que Wi-Fi, des alertes en cas de hors-ligne prolongé, et une validation stricte garantissant que votre rappel renvoie toujours une réponse done/reject bien formée, y compris en cas d’erreur.
Résultat
Avec Server Approval activé et un simple indicateur d’occupation dans le logiciel du client, l’exigence d’une seule personne à la fois a été appliquée entièrement grâce aux capacités existantes de l’appareil : aucun matériel supplémentaire, et aucune modification côté appareil au-delà d’une simple option de configuration.