Comment fonctionne le contrôle d’accès
L’appareil ne décide jamais seul. À chaque tentative, il interroge Chronix Hub et n’ouvre la porte que sur un oui explicite.
Le membre présente une carte, un visage, un QR ou tape un code
Appareil à la porte
Chronix Hub vérifie l’abonnement en temps réel
Écrit une ligne dans le journal en direct
La porte s’ouvre, ou reste fermée. Une ligne est écrite dans le journal en direct dans les deux cas.
Comme la réponse est calculée à partir de l’abonnement en temps réel au moment du passage, il n’y a rien à synchroniser. Gelez un abonnement, laissez-le expirer, résiliez-le ou révoquez une carte perdue : la tentative suivante est refusée.
La réponse est écrite dans le journal en direct avant d’être renvoyée : chaque tentative est enregistrée, y compris les cartes inconnues. Une réponse typique prend quelques centièmes de seconde en production.
Ce que Chronix Hub vérifie à chaque tentative
Dans cet ordre :
- La clé de l’appareil est-elle valide, et est-ce bien la clé de cet appareil ?
- L’adresse IP de l’appareil est-elle autorisée (si vous avez défini une liste d’autorisation) ?
- L’appareil a-t-il dépassé sa limite par minute (60 par défaut) ?
- L’appareil est-il activé, et la porte aussi ?
- La carte, le code ou le visage appartient-il à un membre ?
- Ce membre a-t-il un abonnement actif dont l’offre inclut l’accès ?
- Les horaires de la porte et ceux de l’offre sont-ils tous deux ouverts maintenant, dans le fuseau horaire du studio ?
- Le même membre est-il déjà passé par cette porte pendant la fenêtre d’anti-retour ?
- Si vous l’avez activé : doit-il plus que la limite de solde impayé ?
Ce que les membres peuvent utiliser
Un membre peut avoir plusieurs façons d’entrer. Toutes passent par la même vérification d’abonnement, donc les règles ne diffèrent jamais.
Carte ou badge
Le personnel ajoute le numéro de carte dans l’onglet Accès du membre (lisez-le avec le lecteur). Une carte n’appartient qu’à un membre à la fois ; révoquez une carte perdue pour libérer le numéro.
Visage
Un terminal facial envoie son propre identifiant pour la personne, que vous associez au membre. Chronix Hub ne stocke ni photo ni donnée biométrique, seulement l’identifiant de l’appareil. Les visages connus du terminal mais non associés apparaissent dans Inscriptions en attente, pour les lier en lot.
Pass QR
Le membre ouvre Mes abonnements dans le portail et présente le QR d’enregistrement. Il se renouvelle toutes les 30 secondes et ne sert qu’une fois : une capture d’écran est inutile. Scannez-le sur une borne web ou tout appareil qui lit les QR.
Code PIN à usage unique depuis l’appli
Le membre touche Afficher le PIN dans le portail et reçoit un code aléatoire à 6 chiffres, valable 5 minutes et utilisable une seule fois. Il le tape sur la borne ou sur n’importe quel clavier. Aucun PIN enregistré à partager ou à oublier.
Les options QR et PIN sont masquées dans le portail quand le studio n’a aucun appareil de porte actif, et quand un parent agit pour une personne à charge.
Mettre en place le contrôle d’accès, étape par étape
Tout se trouve dans Contrôle d’accès, dans la barre latérale d’administration. Les propriétaires et administrateurs peuvent modifier. Comptez une dizaine de minutes une fois l’appareil sur le réseau.
Créer les horaires d’ouverture (facultatif)
Onglet Horaires : des plages hebdomadaires dans le fuseau horaire du studio, par exemple lun-ven 06:00-22:00. Une plage qui finit avant de commencer passe minuit. Aucune plage signifie jamais ouvert.
Créer la porte
Onglet Portes : nommez-la, choisissez un horaire (aucun = toujours ouverte) et réglez l’anti-retour. La valeur par défaut est de 60 secondes ; 0 le désactive.
Ajouter l’appareil
Onglet Appareils, Ajouter un appareil : nommez-le, choisissez le fabricant, la porte. Facultatif : une liste d’IP autorisées (l’IP publique de la salle), une limite plus haute pour une rangée de tourniquets, et l’ouverture par défaut si la porte doit s’ouvrir pendant une panne d’internet.
Copier la clé et l’identifiant de l’appareil
La clé de l’appareil n’est affichée qu’une fois. Collez-la dans l’appareil ou le pont maintenant. Perdue ? Régénérez la clé : l’ancienne cesse de fonctionner immédiatement. Une borne web affiche à la place un lien de configuration à usage unique, à ouvrir sur la tablette.
Laisser l’offre ouvrir le portillon
Abonnements, modifier l’offre, activer Accorder l’accès et choisir éventuellement un horaire. Cochez Appliquer aux membres actuels pour l’étendre à ceux qui sont déjà sur l’offre ; sinon seules les nouvelles ventes l’obtiennent.
Ajouter les identifiants
Membres, le membre, Accès, Ajouter un identifiant : un numéro de carte ou une association de visage. Les pass QR et les PIN à usage unique ne demandent rien de votre part ; les membres les obtiennent dans le portail.
Tester
Présentez la carte d’un membre. En quelques secondes, la tentative apparaît dans le journal en direct avec son motif. Rien dans le journal signifie généralement que l’appareil n’a pas joint Chronix Hub : vérifiez la clé, l’identifiant, la liste d’IP et internet.
Choisir votre matériel
Chronix Hub parle une API web simple et neutre vis-à-vis des fabricants. Que votre matériel puisse l’utiliser directement dépend du matériel. Ces pages détaillent chaque option.
Borne web (tablette)
Fonctionne aujourd’huiToute tablette avec navigateur et caméra frontale. Les membres tapent un PIN à usage unique ou montrent un QR. Ni câblage, ni pont.
Lire le guide d’installationTout appareil compatible HTTPS
Fonctionne aujourd’huiUn contrôleur, un middleware ou un petit script capable d’une requête HTTPS par passage. Avec un exemple curl et le contrat JSON.
Lire le guide d’installationZKTeco
Nécessite un pontLes terminaux SpeedFace, ProFace et inBio parlent leur propre protocole et nécessitent un pont. Notre pont ZKTeco est prévu.
Lire le guide d’installationHikvision
Nécessite un pontTerminaux DS-K1T à visage, carte et PIN. Un pont sur votre réseau local interroge Chronix Hub puis ouvre la porte.
Lire le guide d’installationSuprema
Nécessite un pontBioStation, FaceStation et autres appareils BioStar 2, connectés via l’API BioStar 2 ou le G-SDK.
Lire le guide d’installationKisi
Nécessite un pontLecteurs et contrôleurs gérés dans le cloud. Une intégration interroge d’abord Chronix Hub, puis appelle l’API de déverrouillage de Kisi.
Lire le guide d’installationLes noms de produits appartiennent à leurs propriétaires. Chronix Hub n’est pas un partenaire certifié ou officiel d’un fabricant de matériel et ne vend pas de matériel.
Les codes de motif en clair
Chaque réponse porte un motif. L’appareil reçoit un court message affichable à l’écran, et le même motif apparaît dans le journal en direct.
| Code de motif | En clair | Que faire |
|---|---|---|
active_membership | Entrée autorisée. | Rien à faire. |
no_active_membership | Aucun abonnement trouvé pour cette personne. | Vendez un abonnement. |
membership_expired | L’abonnement est terminé. | Renouvelez-le. |
membership_cancelled | L’abonnement a été résilié. | Vendez-en un nouveau. |
membership_frozen | L’abonnement est gelé. Les membres gelés n’entrent jamais. | Dégelez-le. |
membership_no_gate_access | Leur offre n’inclut pas l’accès. | Activez Accorder l’accès sur l’offre et appliquez-le aux membres actuels. |
outside_schedule | Les horaires de l’offre ou de la porte sont fermés en ce moment. | Vérifiez les deux horaires (fuseau horaire du studio). |
antipassback | Le même membre vient de passer par cette porte. Aussi affiché pour un QR ou un PIN à usage unique déjà utilisé. | Attendez la fin de la fenêtre, ou mettez l’anti-retour à 0. |
unpaid_balance | Ils doivent plus que la limite définie. | Enregistrez un paiement, ou relevez la limite. |
unknown_credential | La carte, le code ou le visage n’est pas enregistré, a été révoqué, ou le PIN à usage unique a expiré ou n’existe pas. | Ajoutez la carte ou le visage, ou demandez au membre de toucher Afficher le PIN pour un nouveau code. |
credential_locked | Une carte a été refusée trop de fois pour des raisons que sa propre offre n’autorise pas : elle est verrouillée un moment, même avec un abonnement valide. | Ouvrez l’onglet Accès du membre et levez le verrouillage, ou attendez. |
device_disabled | Le lecteur est éteint. | Activez l’appareil. |
door_disabled | La porte est désactivée. | Activez la porte. |
Comment un appareil doit lire la réponse
Le matériel et les intégrateurs n’ont besoin que de ces sept cas.
| Réponse | Signification | Ce que l’appareil doit faire |
|---|---|---|
| 200 avec granted: true | Laissez-les entrer. | Ouvrir. |
| 200 avec granted: false | Un vrai non. Le motif explique pourquoi. | Rester fermé et afficher le message. |
| 401 | La clé est incorrecte, révoquée ou absente. | Rester fermé. Vérifier la clé. |
| 403 | Mauvais type de clé, contrôle d’accès absent de l’offre du studio, ou IP non autorisée. | Rester fermé. Vérifier la liste d’IP et l’offre. |
| 404 | L’identifiant de l’appareil ou la porte ne correspond pas à cette clé. | Rester fermé. Vérifier l’identifiant. |
| 429 | Trop de tentatives cette minute. | Rester fermé et réessayer bientôt. |
| 5xx ou pas de réponse | Quelque chose s’est mal passé. | Rester fermé, sauf si l’ouverture par défaut est activée et que le réseau est coupé. |
La règle d’or : seul granted: true ouvre la porte. Toute erreur signifie non. L’ouverture par défaut ne s’applique que lorsque l’appareil ne peut pas joindre Chronix Hub du tout ; Chronix Hub ne répond jamais oui à cause d’une erreur.
Dépannage
Commencez par le journal en direct. Ce que vous y voyez indique de quel côté chercher.
| Ce que vous voyez | Cause probable | Solution |
|---|---|---|
| Rien n’apparaît dans le journal en direct | L’appareil n’a jamais joint Chronix Hub. Les réponses 401, 403 et 404 ne sont pas journalisées. | Vérifiez la clé, l’identifiant de l’appareil, la liste d’IP et l’accès internet de l’appareil. |
| L’appareil est Hors ligne | Aucun passage ni signal de vie depuis 2 minutes. | Vérifiez le réseau de l’appareil et son réglage de signal de vie. |
| Chaque passage donne unknown_credential | La carte n’est pas enregistrée, ou a été révoquée. | Membres, le membre, Accès, Ajouter un identifiant. |
| Un PIN à usage unique est refusé | Il a déjà servi, un code plus récent l’a remplacé, ou 5 minutes ont passé. | Le membre touche de nouveau Afficher le PIN et tape le nouveau code. Un refus pour une autre raison ne consomme pas le code. |
| membership_no_gate_access | L’offre n’inclut pas l’accès. | Modifiez l’offre, activez Accorder l’accès, cochez Appliquer aux membres actuels. |
| outside_schedule à une heure où la porte devrait être ouverte | L’horaire de la porte ou celui de l’offre est fermé maintenant. | Vérifiez les deux horaires, dans le fuseau horaire du studio. |
| antipassback juste après une bonne entrée | Le même membre vient de passer par cette porte. | Attendez la fin de la fenêtre ou réglez-la à 0. |
| 429 aux heures de pointe | L’appareil a atteint sa limite par minute. | Relevez la limite de l’appareil (jusqu’à 600). |
| Pas d’Afficher le PIN ni de QR d’enregistrement dans le portail du membre | Le studio n’a aucun appareil de porte actif, ou un parent agit pour une personne à charge. | Ajoutez et activez un appareil, ou demandez au membre de se connecter lui-même. |
Paramètres de sécurité
Quelques réglages évitent qu’une clé volée ou un réseau instable ne devienne une porte ouverte.
Une clé par appareil
Chaque appareil a sa propre clé, affichée une fois et liée à cet appareil. Elle ne permet que de poser des questions de contrôle d’accès. Régénérez-la et l’ancienne meurt instantanément.
Liste d’IP autorisées
Ajoutez l’IP publique de votre salle (jusqu’à 50 adresses ou plages). Une clé copiée depuis un appareil est alors inutile ailleurs.
Limite de débit
60 tentatives par minute et par appareil par défaut, ajustable jusqu’à 600 pour une rangée de tourniquets derrière un même appareil.
Ouverture par défaut, volontaire
Un choix par appareil qui ne compte que lorsque l’appareil ne peut pas joindre Chronix Hub du tout. L’appareil décide alors seul. Laissez-le désactivé sauf si la porte doit s’ouvrir en cas de panne.
Pas de secrets en clair, pas de biométrie
Les numéros de carte ne sont jamais stockés en clair et les journaux n’affichent que les 4 derniers chiffres. Les visages sont un identifiant d’appareil opaque, jamais une photo ni un modèle. Les PIN à usage unique et les pass QR sont éphémères et à usage unique.
Verrouillages et alertes
Une carte refusée de façon répétée pour des raisons d’offre est verrouillée un moment (par défaut : 5 refus en 10 minutes la verrouillent 30 minutes). Les propriétaires et administrateurs reçoivent des alertes pour les rafales de refus et d’identifiants inconnus, avec au plus environ 6 e-mails par heure.
Vous préférez la version récit ?
Notre article de blog présente tourniquets, lecteurs et bornes du point de vue du gérant de studio.
Lire : le contrôle d’accès de salle de sport, expliquéQuestions fréquentes
Chronix Hub vend-il du matériel de contrôle d’accès ?
Non. Chronix Hub est la partie logicielle : il répond à « cette personne peut-elle entrer ? ». Vous apportez le tourniquet, le lecteur, le contrôleur ou la tablette. Les noms de produits appartiennent à leurs propriétaires et Chronix Hub n’est pas un partenaire certifié ou officiel d’un fabricant.
Quel matériel fonctionne aujourd’hui ?
Une borne web (toute tablette avec navigateur) et tout contrôleur, middleware ou script capable d’émettre une requête HTTPS à chaque passage. ZKTeco, Hikvision, Suprema et Kisi nécessitent un pont ou une intégration écrite sur l’API ouverte. Notre pont ZKTeco est prévu, sans date de sortie.
De quoi les membres ont-ils besoin sur leur téléphone ?
De rien pour une carte ou un visage. Pour un pass QR ou un PIN à usage unique, ils ouvrent le portail membre Chronix Hub de votre studio, rubrique Mes abonnements.
Les PIN sont-ils encore enregistrés sur le profil du membre ?
Non. Les PIN sont des codes à 6 chiffres à usage unique que le membre génère dans le portail. Chacun est valable 5 minutes et ne sert qu’une fois. En créer un nouveau remplace le précédent.
Que se passe-t-il si internet tombe ?
L’appareil ne peut pas interroger Chronix Hub : il reste fermé sauf si vous avez activé l’ouverture par défaut pour cet appareil. Une borne web affiche un avis et ignore les saisies ; rien n’est mis en file d’attente et personne n’entre plus tard. Elle réessaie toutes les 10 secondes et récupère seule.
Les membres gelés ou expirés peuvent-ils entrer ?
Non. La vérification utilise l’abonnement en temps réel : le passage suivant un gel, une expiration ou une résiliation est refusé.
Puis-je limiter les heures d’entrée ?
Oui, à deux endroits. Une porte peut avoir un horaire hebdomadaire, et chaque offre d’abonnement aussi. Les deux doivent être ouverts au moment du passage.
Puis-je refuser l’entrée en cas de solde impayé ?
En option. Dans Paramètres du studio, Paiements, définissez un montant Accès : solde impayé. Les membres qui doivent davantage sont refusés. Laissez vide pour ignorer les soldes.
Les photos de visage sont-elles stockées ?
Non. Le terminal facial garde ses propres visages. Chronix Hub ne stocke que l’identifiant du terminal pour la personne, associé à un membre.
Le contrôle d’accès est-il inclus dans mon offre ?
Le contrôle d’accès est une fonction d’offre. Si Contrôle d’accès manque dans votre barre latérale d’administration, contactez-nous et nous vérifierons votre offre.
Envie de voir le contrôle d’accès sur votre propre studio ?
Réservez une courte démo et nous passerons en revue votre porte, votre matériel et vos offres d’abonnement.