Skip to content

Changelog plugin Badger Fork

IMPORTANT

S'il n'y a pas d'information sur la mise à jour, c'est que celle-ci concerne uniquement de la mise à jour de documentation, de traduction ou de texte.

21/10/2026

  • Ajout : nouvelle option « Contrôler l'IP d'origine des lecteurs » dans la configuration du plugin, activée par défaut : les appels de lecteur relayés par un tunnel ou un reverse proxy (accès distant, cloudflared…) sont refusés ; décochez-la seulement si vos lecteurs passent eux-mêmes par un reverse proxy ou un NAT (un avertissement s'affiche alors). Sur la fiche d'un lecteur, l'« IP autorisée » est désormais l'adresse d'où le lecteur appelle réellement et se corrige à la main ; la nouvelle case « Refuser les appels venant d'une autre IP », décochée par défaut, limite ce lecteur à cette adresse (à réserver aux lecteurs à IP fixe). Sans cette case, vos lecteurs restent acceptés même si leur adresse change, comme avant.
  • Documentation : la documentation explique la nouvelle option « Contrôler l'IP d'origine des lecteurs » (quand la décocher, et pourquoi un accès distant par tunnel ne le justifie pas), le champ « IP autorisée » et la case « Refuser les appels venant d'une autre IP » de la fiche d'un lecteur, ainsi que les nouveaux messages de refus dans le dépannage.
  • Évolution : les appels de lecteur qui ne respectent pas le format émis par les sketches (commande inconnue, nom, adresse IP, badge ou code mal formés) sont désormais refusés sans aucun effet et signalés au niveau Avertissement du log ; tout ce qu'envoient vos lecteurs reste accepté, y compris la touche Entrée seule au clavier. Le log du plugin ne peut plus être falsifié par une valeur reçue (caractères spéciaux remplacés par « ? », longueur limitée) et n'affiche jamais un code saisi.
  • Correctif : un badge créé en mode inclusion reçoit désormais le modèle « Tag RFID » (seules les entrées Analog1 à Analog5 sont « Analog Input ») et un lecteur qui annonce son modèle à l'inclusion le reçoit dès sa création, avec la commande PinTryLimit pour un lecteur wiegand2 ; les équipements existants ne changent pas.
  • Documentation : la documentation décrit les nouveaux refus d'un appel hors format dans le dépannage, le modèle affiché des badges et des lecteurs créés en inclusion, et la neutralisation des valeurs dans le log.
  • Correctif : le blocage d'un lecteur après des badges inconnus ou des codes faux est désormais fiable : il dure exactement le temps réglé (même à un changement d'heure ou de jour), double à chaque récidive jusqu'à un maximum, et une limite d'échecs cumulés (10 en 10 minutes par défaut, réglable dans la nouvelle section « Blocage des lecteurs » de la configuration du plugin) bloque aussi les séries entrecoupées de badges ou de codes valides. Les limites sont enregistrées sur la fiche : 3 pour un nouveau lecteur, la valeur qui s'appliquait déjà (1) pour un lecteur existant qui n'en avait pas ; une limite vide, nulle ou négative est refusée. La fiche affiche l'état du verrouillage avec un bouton « Débloquer » ; un lecteur bloqué n'est jamais désactivé et la commande PinTryLimit est créée au premier blocage sur code si elle manque.
  • Documentation : la documentation décrit le blocage des lecteurs (fonctionnement, réglages de la configuration du plugin et de la fiche, bouton « Débloquer ») et la conduite à tenir face à un lecteur bloqué dans le dépannage.
  • Évolution : les codes PIN des équipements code ne sont plus stockés ni affichés en clair : ils sont chiffrés à la mise à jour sans changer, et vos lecteurs continuent d'ouvrir avec les mêmes codes. Sur la page d'un équipement code, le champ du code est masqué et vide (laissez-le vide pour garder le code), le bouton « Voir le code » l'affiche à l'administrateur, et la commande GetPin devient optionnelle (case « Ajouter une commande info GetPin », cochée automatiquement là où la commande existait déjà). Les codes aléatoires de ChangePin sont désormais tirés par un générateur sûr. Attention : revenir ensuite à une version antérieure du plugin impose de restaurer la sauvegarde Jeedom faite avant cette mise à jour.
  • Documentation : la documentation décrit le code masqué, le bouton « Voir le code », la commande GetPin optionnelle, la validation de ChangePin et ce que fait la mise à jour sur les codes existants.
  • Évolution : le mode inclusion s'arrête désormais tout seul au bout de quelques minutes (5 par défaut, réglable de 1 à 60), avec un compte à rebours et un bouton Prolonger, au plus 20 créations par inclusion (réglable), une notification dans le centre de messages et, en option, une liste d'éléments à approuver ; une inclusion laissée active est arrêtée par la mise à jour et la case « Autoriser l'inclusion de devices inconnus » disparaît de la configuration du plugin.
  • Documentation : la documentation décrit l'inclusion limitée dans le temps, la limite de créations et l'approbation des lecteurs et badges créés.
  • Ajout : la page du plugin affiche un tableau « Posture de sécurité des lecteurs » qui indique, pour chaque lecteur, son niveau de protection (v0 filtré par IP, v0 non filtré, v1 non appairé, v1 signé), sa version minimale exigée, sa dernière activité et l'action recommandée, avec un bouton « Appairer ce lecteur » pour exiger le protocole v1 signé lecteur par lecteur (jamais par défaut) ; un avertissement rappelle, tant qu'un lecteur actif utilise encore l'ancien protocole, qu'il peut être usurpé par un appareil du réseau local. Vos lecteurs actuels continuent de fonctionner exactement comme avant.
  • Documentation : la documentation décrit le tableau « Posture de sécurité des lecteurs » (niveaux, mentions, recommandations, exigence du protocole v1 signé) et le dépannage des refus de l'appairage depuis ce tableau.
  • Correctif : un lecteur v1 encore configuré sur l'ancienne adresse du plugin n'est plus rejeté en erreur 403 quand il envoie un appel sans commande : l'appel est ignoré et journalisé, comme avant la validation des entrées.
  • Ajout : une mise à jour du plugin applique désormais ses évolutions de données une seule fois et dans l'ordre, et signale dans le centre de messages une évolution qui échoue (elle est retentée automatiquement à la mise à jour ou la réactivation suivante).
  • Évolution : désactiver puis réactiver le plugin ne débloque plus les lecteurs bloqués : utilisez le bouton « Débloquer » de la fiche du lecteur.
  • Documentation : la documentation explique les évolutions de données appliquées à la mise à jour, le message affiché en cas d'échec et la conduite à tenir.
  • Évolution : maintenance interne du plugin (code simplifié, éléments inutilisés retirés), sans aucun changement pour vos lecteurs, badges, codes et scénarios ; aucun lecteur n'est à reflasher.
  • Évolution : les dossiers internes du plugin (analyses, sketches, code interne) ne sont plus lisibles directement depuis un navigateur sous Apache, la page de configuration indique que cette protection dépend du serveur web, et les boutons de téléchargement des sketches d'origine ouvrent désormais leur page sur GitHub.
  • Documentation : la documentation de la configuration explique la protection des dossiers internes et donne la règle à ajouter sous nginx.
  • Ajout : lecteurs v1 (sketch Badger2) : le plugin sait déchiffrer les badges et codes d'un lecteur appairé qui les envoie chiffrés, et le tableau « Posture de sécurité des lecteurs » propose, lecteur par lecteur, d'exiger ce chiffrement (désactivé par défaut, proposé seulement une fois un badge ou code chiffré reçu) ; les identifiants envoyés en clair par ce lecteur sont alors refusés. Les lecteurs flashés avec le sketch d'origine ne sont pas concernés.
  • Documentation : la référence technique décrit la nouvelle colonne « Chiffrement des identifiants » du tableau de posture de sécurité des lecteurs, ses états et quand exiger le chiffrement d'un lecteur.
  • Documentation : nouvelle page « Sécurité de vos lecteurs » : ce que protège chaque mesure et ce qu'elle ne protège pas (un lecteur flashé avec le sketch d'origine reste usurpable depuis le réseau local), réglages par défaut, ce qui change à la mise à jour, et procédures pas à pas pour débloquer un lecteur, inclure et approuver, gérer les codes, exiger le protocole v1 signé, filtrer par IP et protéger les dossiers du plugin sous Apache et nginx ; le dépannage couvre désormais chaque message de refus.
  • Ajout : chaque lecteur dispose d'une option « Comparer les codes exactement » (décochée par défaut, rien ne change) : cochée, un code tapé sur ce lecteur n'ouvre plus que s'il est tapé à l'identique (42 n'ouvre plus 0042), et le tableau de posture indique l'état de l'option pour chaque lecteur v0.
  • Documentation : la page Sécurité explique l'option « Comparer les codes exactement » : son effet, comment l'activer sans risque et ce qu'en montre le tableau de posture.

20/10/2026

  • Ajout : un lecteur Badger2 en protocole v1 peut désormais être appairé depuis sa fiche : le plugin génère son secret (affiché une seule fois), vérifie la signature de chacun de ses appels, refuse les appels rejoués ou repassés en v0 à son nom, et l'administrateur peut régénérer le secret ou rabaisser le lecteur à v0 ; les lecteurs jamais appairés, dont tous les lecteurs déjà installés, fonctionnent exactement comme avant.
  • Documentation : la documentation explique l'appairage d'un lecteur Badger2 en protocole v1 : où le trouver dans la fiche, l'affichage unique du secret, ce qui est refusé ensuite, la régénération du secret et le retour à v0.
  • Ajout : un administrateur peut télécharger depuis la fiche d'un lecteur un fichier de configuration du sketch Badger2 déjà rempli (carte, adresse de Jeedom, identifiant et secret du lecteur) ; le secret d'appairage n'est plus affiché à l'écran, il n'est fourni que dans ce fichier, et un lecteur d'origine n'est en rien modifié par ce téléchargement.
  • Documentation : la documentation explique le téléchargement de la configuration du sketch d'un lecteur v1 (choix de la carte, adresse de Jeedom, Wi-Fi, emplacement du fichier, cas d'un lecteur d'origine) et la nouvelle façon de récupérer le secret après l'appairage.
  • Documentation : la documentation est réorganisée en deux entrées : un tutoriel pas à pas pour débutants, de l'achat du matériel à la première porte ouverte, et une référence technique complète (cartes et capacités, câblage, appairage, compatibilité des anciens lecteurs, console, dépannage détaillé) ; vos anciens lecteurs continuent de fonctionner sans rien changer, et le nouveau sketch exige une Mega 2560 ou un ESP.
  • Correctif : import depuis Badger : si Badger d'origine n'avait jamais réglé l'inclusion, l'import n'efface plus l'option d'inclusion de Badger Fork. Si vous aviez activé l'inclusion dans Badger Fork avant un import, vérifiez son état dans la page du plugin.
  • Évolution : le sketch Badger2 (protocole v1) compile désormais tel quel : la ligne de sécurité BADGER2_DEVELOPPEMENT_ACCEPTE n'existe plus, ni dans le sketch ni dans le fichier de configuration téléchargé depuis la fiche d'un lecteur, appairé ou non ; une telle ligne restée dans un ancien fichier est simplement ignorée. Le sketch v1 n'a toujours pas été essayé sur une carte réelle : gardez de quoi revenir au sketch d'origine. Les lecteurs d'origine ne sont pas concernés.
  • Évolution : sur un lecteur ESP doté de la mise à jour à distance (sketch Badger2), la commande console « ota - » désactive désormais la mise à jour à distance immédiatement : l'ancien mot de passe ne sert plus, sans attendre de redémarrage. Les lecteurs Mega et les lecteurs d'origine ne sont pas concernés.
  • Documentation : la référence du protocole v1 des futurs lecteurs Badger2 ne promet plus d'empreinte de configuration (cfg) ; ce champ reste accepté mais sans effet (les lecteurs déjà installés ne sont pas concernés).
  • Évolution : le protocole v1 des futurs lecteurs Badger2 ne comporte plus du tout d'empreinte de configuration : ni champ, ni capacité, ni libellé dans la fiche du lecteur ; un lecteur qui enverrait encore ces données les verrait ignorées comme toute donnée inconnue. Les lecteurs déjà installés ne sont pas concernés.

19/10/2026

  • Documentation : la référence du protocole v1 des futurs lecteurs Badger2 précise le traitement des réponses non signées ou mal signées et l'usage réservé du secret du lecteur (en préparation : les lecteurs déjà installés ne sont pas concernés).
  • Évolution : les futurs lecteurs Badger2 en protocole v1 exigeront une Arduino Mega 2560 ou un ESP ; une Uno ou une Nano garde son sketch actuel (BadgerW5100 ou BadgerENC28J60), qui reste pris en charge et fonctionne comme avant (aucun lecteur déjà installé n'est concerné).
  • Documentation : la référence du protocole v1 des futurs lecteurs Badger2 précise les retours que le lecteur sait appliquer (ouverture de la gâche, voyant, buzzer, heure) et les conditions de leur prise en compte selon qu'un secret est configuré ou non (en préparation : les lecteurs déjà installés ne sont pas concernés).
  • Documentation : la référence du protocole v1 des futurs lecteurs Badger2 décrit le mode hors ligne : refus par défaut quand Jeedom est injoignable, liste blanche locale d'empreintes signée par le plugin ou, à vos risques, ouverture libre, et remise des passages à Jeedom à son retour (en préparation : les lecteurs déjà installés ne sont pas concernés).
  • Documentation : la référence du protocole v1 des futurs lecteurs Badger2 décrit les ordres signés que Jeedom pourra envoyer au lecteur (ouverture de la gâche, voyant, buzzer, battement, resynchronisation de la liste blanche, redémarrage) et leur accusé de réception ; le port d'ordres ne doit jamais être joignable depuis Internet (en préparation : les lecteurs déjà installés ne sont pas concernés)
  • Documentation : la référence du protocole v1 des futurs lecteurs Badger2 mentionne deux capacités informatives, la console de provisionnement (configuration et diagnostic par le port série du lecteur) et la LED d'état (en préparation : les lecteurs déjà installés ne sont pas concernés)
  • Documentation : la référence du protocole v1 des futurs lecteurs Badger2 mentionne la capacité informative de mise à jour à distance du firmware, protégée par mot de passe et réservée aux cartes ESP (en préparation : les lecteurs déjà installés ne sont pas concernés)
  • Ajout : le plugin reçoit désormais les appels des futurs lecteurs Badger2 en protocole v1 : un lecteur v1 est reconnu par son identifiant et par son adresse enregistrée, ses badges et codes déclenchent les mêmes commandes qu'un lecteur actuel, et Analyse > Santé affiche « v1 : supportée » (les lecteurs déjà installés fonctionnent exactement comme avant).
  • Ajout : la fiche de chaque lecteur affiche désormais son protocole, son firmware, sa carte et son transport, les capacités qu'il annonce et la date de sa dernière annonce (« v0 (sketch d'origine) » pour un lecteur d'origine, « En attente de l'annonce du lecteur » pour un lecteur v1 qui ne s'est pas encore annoncé).
  • Documentation : nouvelle section « Version, firmware et capacités de chaque lecteur ».

18/10/2026

  • Correctif : les traductions anglaise, allemande et espagnole de la configuration du plugin et des équipements, et des messages de migration depuis Badger, sont complétées.
  • Documentation : publication de la référence technique du protocole v1 des futurs lecteurs Badger2 (en préparation : ni le plugin ni les sketches actuels ne l'utilisent encore ; les lecteurs déjà installés ne sont pas concernés).
  • Ajout : le plugin reconnaît la version de protocole de chaque appel de lecteur : les lecteurs actuels (sketch d'origine, ancienne ou nouvelle adresse) fonctionnent exactement comme avant, un appel annonçant une version inconnue est refusé avec un avertissement explicite, et les versions prises en charge sont visibles dans Analyse > Santé.
  • Documentation : la page de présentation et la référence du protocole des lecteurs décrivent la reconnaissance des versions et leur affichage dans Analyse > Santé.
  • Ajout : nouveau mode debug réservé à l'administrateur, activable 15, 30 ou 60 minutes depuis la page du plugin : il montre en clair ce que les lecteurs envoient et ce que le plugin en fait, avec une option « observation seule » pour mettre au point un lecteur sans rien déclencher.
  • Évolution : les badges et codes reçus des lecteurs ne sont plus écrits en clair dans le log du plugin, y compris dans le nom d'un badge ou d'un code qui les contiendrait.
  • Documentation : la documentation décrit le mode debug : activation, ce qui est montré ou jamais montré, arrêt automatique, et précautions avec l'observation seule.
  • Documentation : la référence du protocole v1 des futurs lecteurs Badger2 décrit le champ facultatif port, qui indique lequel des deux lecteurs Wiegand d'un même boîtier a lu le badge (en préparation : les lecteurs déjà installés ne sont pas concernés).
  • Documentation : la référence du protocole v1 des futurs lecteurs Badger2 décrit la saisie de code au clavier : badge suivi d'un code envoyés ensemble et envoi touche par touche, deux options désactivées par défaut (en préparation : les lecteurs déjà installés ne sont pas concernés).
  • Documentation : la référence du protocole v1 des futurs lecteurs Badger2 précise le sens de l'état des entrées (bouton de sortie, sonnette, autoprotection, entrées analogiques) et les valeurs de l'événement de porte (en préparation : les lecteurs déjà installés ne sont pas concernés).
  • Documentation : la référence du protocole v1 des futurs lecteurs Badger2 décrit l'annonce de démarrage (capacités, cause du redémarrage), le battement de cœur et son compteur d'événements perdus, ainsi que la période de battement que le plugin peut ajuster (en préparation : les lecteurs déjà installés ne sont pas concernés).

17/10/2026

  • Correctif : sécurité : les lecteurs ne sont plus acceptés que depuis une adresse IP locale (réseau privé). Un appel venant d'Internet est refusé et signalé dans le log.
  • Correctif : sécurité : les appels des lecteurs arrivant par un tunnel ou un reverse proxy (cloudflared, accès distant…) sont désormais refusés, et l'adresse de bouclage ou du serveur n'est plus jamais enregistrée comme IP d'un lecteur.

22/09/2026

  • Correctif : les liens de documentation, de changelog et de téléchargement des librairies Arduino pointent de nouveau vers un emplacement valide
  • Correctif : les liens de documentation et de changelog pointent vers le site publie jeedomdocs.decastro.fr
  • Nouveauté : publication du plugin sur le Market, avec import des équipements et rétro-compatibilité de l'ancien plugin Badger
  • Correctif : page de configuration : tant que l'ancien plugin Badger est installé, le bouton d'URL de compatibilité reste en mode « Ajouter » et grisé, au lieu de proposer à tort de la retirer
  • Correctif : les librairies Arduino (EtherCard et Wiegand) sont désormais téléchargeables depuis le site de documentation : les liens de la page de configuration fonctionnent de nouveau
  • Correctif : import de la configuration Badger : le bouton renvoyait une erreur 500 sans aucun message. La cause du blocage est maintenant affichée et journalisée, et un équipement en échec n'interrompt plus l'import des autres.
  • Correctif : import de la configuration Badger : l'import échouait sur tous les équipements tant que le plugin Badger était installé (Jeedom interdit deux équipements de même nom dans le même objet). Les équipements sont maintenant importés sans objet parent, et y sont replacés automatiquement dès la désinstallation de Badger.
  • Ajout : migration depuis Badger : une case à cocher (activée par défaut) reporte automatiquement, partout dans Jeedom, les références aux commandes de Badger sur celles de Badger Fork — scénarios, vues, design, interactions et droits utilisateur. Sans elle, ces éléments pointeraient vers des commandes supprimées à la désinstallation de Badger.
  • Documentation : ajout d'une page décrivant toute la procédure de migration depuis l'ancien plugin Badger (import, case de remplacement des commandes, objets parents, désinstallation, URL de compatibilité). L'installation est désormais documentée uniquement depuis le Market.

01/06/2022

  • Divers petits correctifs (liens, images, etc)
  • Ajout d'un système pour oublier automatiquement les chiffres saisis au bout de 30 s (pour éviter que la prochaine saisie d'un code complet soit en erreur)
  • Ajout de la gestion des entrées analogiques pour utiliser des boutons poussoir ou le bouton sonnette d'un digicode
  • Mise à jour de la documentation

01/05/2022

  • Reprise du plugin
  • Correctif : problème de class object
  • Correctif : liens des sketchs
  • Correctif : liens de documentation
  • Suppression des bords blancs sur l'icône