Quels terminaux la Gateway prend en charge, comment chacun se connecte (Native Push ou Hybrid Push) et quelles opérations d’API sont disponibles dans chaque mode.
Introduction
Compatibilité des terminaux
La Cams Biometric Gateway prend en charge tous les terminaux biométriques de pointage et de contrôle d’accès. Votre seul choix : le mode de connexion adapté à votre installation.
Tout autre terminal fonctionne via Hybrid Push. Vous choisissez le mode de connexion adapté à votre installation — les fonctionnalités de l’API dépendent du mode sélectionné.
Marques de terminaux prises en charge
Cams BiometricsZKTecoSupremaHikvisionAnvizMorpho / IDEMIAVirdiMantraNitgenRealtime / StartekBiomaxSecugeneSSLMatrix COSEC+ Toute autre marque
Modalités d’authentification prises en charge
Empreinte digitaleReconnaissance facialeVeines de la paumeCarte RFIDPIN / Mot de passeQR / Code-barresSuivi GPS
Chaque terminal biométrique se connecte à la Cams Biometric Gateway via l’un des deux modes push. Le type de votre terminal détermine le mode à utiliser.
Native Push Terminaux Cams & vérifiés
Tous les terminaux Cams Biometrics et les appareils vérifiés sur developer.camsbiometrics.com se connectent via Native Push. Aucune configuration supplémentaire — le terminal communique directement avec la Biometric Gateway par Internet.
Prise en charge complète de l’API. Les 38 opérations fonctionnent sans aucune limitation — API de callback comme RESTful. Latence nulle pour les callbacks, ~15 secondes pour les commandes RESTful.
Hybrid Push Tous les autres terminaux
Pour les terminaux non-Cams et non vérifiés, vous choisissez un mode de connexion Hybrid Push adapté à votre environnement. La combinaison de la méthode de communication et de la topologie de déploiement détermine les fonctionnalités d’API disponibles.
Méthodes de communication
(a) SDK du terminalLa Gateway communique avec le matériel via le SDK du fabricant. Toutes les fonctionnalités prises en charge par le SDK sont disponibles via l’API. La meilleure option pour un accès complet à l’API.
(b) Lecture de base de donnéesLa Gateway lit une base de données locale installée sur l’ordinateur du site (où le logiciel du terminal stocke les présences). Seul l’envoi des journaux de présence/pointage vers votre serveur est pris en charge. Aucune API RESTful (pas d’ajout/suppression d’utilisateur, pas de chargement de journaux, etc.).
(c) Traitement de fichierUn fichier de présence désigné sur l’ordinateur local est placé sous surveillance continue. À chaque mise à jour du fichier par le logiciel du terminal, les nouveaux enregistrements de présence sont automatiquement détectés, récupérés et envoyés à votre URL de callback en temps réel. Mêmes limites d’API que la lecture de base de données -- envoi des présences uniquement, aucune API RESTful.
Topologies de déploiement
(X) DirectL’ordinateur du site dispose d’une adresse IP publique avec redirection de port vers le réseau local. La Biometric Gateway se connecte directement au terminal/à la base/aux fichiers via Internet.
(Y) IndirectUn Hybrid Connector est installé sur l’ordinateur local. Il fait le pont entre la machine/base/fichiers locaux et la Biometric Gateway — aucune IP publique requise côté client.
Hybrid Push — Matrice de disponibilité des fonctionnalités
Mode
Communication
Topologie
API de callback
API RESTful
Terminal direct
(a) SDK
(X) IP publique
Complet
Complet (limites du SDK)
Terminal indirect
(a) SDK
(Y) Hybrid Connector
Complet
Complet (limites du SDK)
Base de données directe
(b) Lecture de base de données
(X) IP publique
Présences uniquement
Non pris en charge
Base de données indirecte
(b) Lecture de base de données
(Y) Hybrid Connector
Présences uniquement
Non pris en charge
Fichier direct
(c) Fichier
(X) IP publique
Présences uniquement
Non pris en charge
Fichier indirect
(c) Fichier
(Y) Hybrid Connector
Présences uniquement
Non pris en charge
Quel mode choisir ? Si votre terminal non-Cams dispose d’un SDK pris en charge par la Gateway, choisissez le mode SDK du terminal (a) pour un accès complet à l’API. Sinon, la lecture de base de données (b) ou le traitement de fichier (c) permettront tout de même d’acheminer les données de présence. Pour la topologie, choisissez Indirect (Y) avec le Hybrid Connector si vous ne pouvez pas mettre en place d’IP publique — c’est le plus simple à déployer.
Les limites matérielles peuvent restreindre davantage les fonctionnalités de l’API. Même en mode SDK du terminal, certaines API peuvent ne pas fonctionner selon le firmware ou les capacités du SDK du modèle. Testez toujours avec votre matériel et vérifiez auprès de l’équipe d’assistance Cams.
