Skip to content
KitploitKITPLOIT
OutilsBlog
Soumettre
OutilsBlog
Soumettre

Outils de Hacking, PenTest et Cybersécurité pour votre Arsenal de Sécurité !

Kitploit est un répertoire d'outils de hacking, de cybersécurité et de pentesting. Découvrez les dernières mises à jour des projets pour trouver des vulnérabilités, analyser des systèmes, automatiser les tests et renforcer votre sécurité.

··Flux·Contact·Confidentialité·© 2026 Kitploit

Répertoire d'outils

Catégories

Voir toutes les catégories
Loading categories
ESP-RFID-Tool — Un outil pour journaliser les données et tester les appareils dotés d'une interface Wiegand. Peut être utilisé pour créer un lecteur RFID portable ou être installé directement dans une installation existante. Fournit un accès à une interface web via le Wi-Fi en mode AP ou Client. Fonctionne avec presque tous les appareils dotés d'une interface Wiegand standard 5V. Le principal groupe cible est celui des cartes HID 26-37 bits. Similaire au Tastic RFID Thief, à Blekey et à ESPKey. | Kitploit
Outils/GitHubGitHub/rfidtool/esp-rfid-tool
Sécurité des Systèmes EmbarquésReconnaissanceOutils RFID/NFCCollecte d'InformationsFuzzingHacking MatérielTests d'IntrusionRed Teaming

Populaires

Voir tout →

Découvrez les outils les plus utilisés par notre communauté.

Explorer tous les outils

Parcourez notre collection d'outils

Voir tous les outils →

À propos

Un outil pour journaliser les données et tester les appareils dotés d'une interface Wiegand. Peut être utilisé pour créer un lecteur RFID portable ou être installé directement dans une installation existante. Fournit un accès à une interface web via le Wi-Fi en mode AP ou Client. Fonctionne avec presque tous les appareils dotés d'une interface Wiegand standard 5V. Le principal groupe cible est celui des cartes HID 26-37 bits. Similaire au Tastic RFID Thief, à Blekey et à ESPKey.

GitHub
rfidtool/esp-rfid-tool

ESP-RFID-Tool

Voir le dépôt
5791117il y a 4 ansVérifié par Kitploit
Partager

ESP-RFID-Tool

Par Corey Harding

Logo

Site web officiel :

  • www.rfid-tool.com

Board April Brother fabrique actuellement ce matériel et il peut être acheté directement depuis la Chine sur :

  • Boutique officielle : https://blog.aprbrother.com/product/esp-rfid-tool
  • Boutique AliExpress : https://www.aliexpress.com/item/ESP-RFID-Tool/32850151497.html
  • Boutique Tindie : https://www.tindie.com/products/aprbrother/esp-rfid-tool/

Distributeurs tiers :

  • Hacker Warehouse (USA) : https://hackerwarehouse.com/product/esp-rfid-tool/

Vidéos de démonstration de capture d'identifiants à l'aide de diverses technologies qui utilisent une interface Wiegand :

  • Réalisation d'une ATTAQUE PAR REJEU à l'aide de la fonction TX expérimentale : https://youtu.be/u1y7UZpup9I
  • Forçage par force brute de codes PIN à l'aide de la fonction TX expérimentale : https://youtu.be/OZCaypGBVv4
  • Lecteur RFID longue portée portable HID 5375 : https://youtu.be/B86926CHImE
  • Lecteur RFID/clavier HID 5355 : https://youtu.be/ojIpcY8Y3KQ
  • Lecteur RFID/piste magnétique HID multiCLASS RM40 : https://youtu.be/9OccRaLxXg8
  • Lecteur RFID HID multiCLASS : https://youtu.be/2sCLkpuxAks
  • RFID/biométrie/clavier avec serrure à pêne électronique : https://youtu.be/0o8r_ufRrFo

Firmware :

  • Officiel
    • ESP-RFID-Tool : https://github.com/rfidtool/ESP-RFID-Tool/releases
      • Les versions >=1.1.0 sont compilées avec le package du gestionnaire de cartes esp8266 2.4.1
      • Les versions < 1.1.0 sont compilées avec le package du gestionnaire de cartes esp8266 2.3.0
  • Non officiel
    • Portage de Tastic RFID Thief : https://github.com/exploitagency/ESP-RFID-Thief/releases

Cas d'utilisation prévus

  • Chercheurs en sécurité effectuant des évaluations d'équipe rouge.
    • Capture des valeurs de cartes pour les cloner par la suite.
    • Rejeu de captures binaires brutes.*(voir note ci-dessous)
    • Fuzzing des systèmes de contrôle d'accès.*(voir note ci-dessous)
    • Forçage par force brute des codes PIN.*(voir note ci-dessous)
    • Mode déni de service.*(voir note ci-dessous)
  • Pour créer un dispositif autonome permettant de capturer des identifiants ou de tester des badges et/ou des lecteurs de cartes sans avoir besoin d'un contrôleur Wiegand.
    • Ajoutez une batterie et un lecteur de cartes pour rendre l'appareil portable.
    • Ajoutez une alimentation de laboratoire pour tester le matériel.
  • Installateurs qui résolvent des problèmes liés à un lecteur de cartes, aux lignes de données, ou qui testent même une carte défectueuse.
  • Utile pour les commerçants ou les revendeurs de surplus qui testent si les équipements de contrôle d'accès sont fonctionnels.
  • Passionnés qui expérimentent divers systèmes utilisant une interface Wiegand.
  • Simulation d'un système de contrôle d'accès à l'aide de plusieurs unités ESP-RFID-Tool.
  • RFID-Tool n'est pas destiné à être utilisé de manière illégale.

Qu'est-ce que c'est ?

Un enregistreur de données universel qui capture les données binaires brutes d'une interface Wiegand standard 5 V. L'appareil peut enregistrer les identifiants des systèmes de contrôle d'accès ou de presque tout appareil utilisant une interface Wiegand, comme les lecteurs de cartes RFID, les claviers à code PIN, les systèmes à piste magnétique, les codes-barres et même certains lecteurs biométriques. Les interfaces Wiegand ne doivent pas non plus se limiter aux seuls systèmes de contrôle d'accès. Le principal groupe cible de cet appareil est celui des cartes HID 26-37 bits. Pour les types de cartes connus, les données binaires et hexadécimales sont affichées directement dans le fichier journal pour faciliter l'identification du badge et également au cas où un clone d'une carte serait nécessaire. Pour les types de cartes inconnus, seules les données binaires brutes sont affichées.

Comment l'installer ?

L'appareil peut être installé directement dans un système existant, en tirant son alimentation du câblage préexistant, ou il peut également être utilisé pour transformer un lecteur en unité portable autonome pour l'enregistrement de données lorsqu'une batterie est ajoutée. Le câblage est simple et se compose de 4 fils : (+), (-), D0 (vert) et D1 (blanc). L'appareil peut fonctionner avec des tensions allant d'environ 4,5 V jusqu'à un maximum de 12 V. Les tensions couramment rencontrées sont 12 V et 5 V. **(Voir les notes d'installation ci-dessous)

Comment accéder aux journaux ?

L'accès aux fichiers journaux et aux divers paramètres est fourni via une interface web. L'appareil dispose de capacités WiFi et peut être configuré pour créer son propre point d'accès ou pour se connecter à un réseau existant. En cas de verrouillage de l'interface web, vous pouvez ponter le cavalier J3 à la mise sous tension ou pendant la réinitialisation de l'appareil pour retrouver l'accès sans perdre vos fichiers journaux.

Je veux en savoir un peu plus...

Le matériel est basé sur une puce WiFi ESP12 avec une pile TCP/IP complète et une unité microcontrôleur. Le logiciel est open source, sous licence MIT, et sera publié le jour du lancement du produit. Le logiciel résidera dans ce dépôt GitHub afin de pouvoir être examiné par la communauté. Nous accepterons diverses pull requests de la communauté après examen, si elles améliorent la valeur de l'appareil pour les autres. Le logiciel a été écrit dans l'IDE Arduino, de sorte que les passionnés comme les professionnels n'auront aucun mal à modifier le code s'ils le souhaitent. Une interface Wiegand fonctionne avec 3 fils : une masse, Data0 et Data1. Un zéro est envoyé lorsque D0 passe à l'état bas et un un est envoyé lorsque D1 passe à l'état bas, l'autre ligne restant à l'état haut pendant ce temps. La synchronisation est de 40 µs de l'état bas à l'état haut sur une ligne, avec 2 ms entre les bits. Le logiciel enregistre cette sortie binaire dans un fichier et, si l'appareil pense qu'il s'agit d'un format de carte connu, le préambule est deviné (non envoyé par le lecteur de cartes, mais identique pour toutes les cartes d'un format spécifique ; notre cible principale est les cartes HID 26-37 bits) et les données binaires brutes et hexadécimales sont enregistrées. Pour les formats de cartes inconnus, seule la sortie binaire brute est enregistrée, sans estimation du préambule et sans afficher les données au format hexadécimal, afin d'éviter toute confusion. Si vous savez quel type de carte a été capturé, il suffit de rechercher le préambule et de l'ajouter au début du binaire, puis de le convertir généralement au format hexadécimal pour créer un clone d'une carte. Il est possible que la carte soit en réalité d'un format inconnu et que le préambule ait été deviné incorrectement, l'appareil pensant qu'il s'agissait d'un format de carte connu (la supposition est basée sur le nombre de bits émis par le lecteur). Si c'est le cas, dans le fichier journal, il y a un espace littéral dans le binaire entre le préambule et les données de la carte ; ignorez simplement le préambule. Lors du rejeu d'un identifiant capturé*(voir note ci-dessous), vous n'incluez pas le préambule, car celui-ci n'est pas émis par le lecteur de cartes ; vous rejouez*(voir note ci-dessous) uniquement les données réelles de la carte telles qu'elles sont émises par le lecteur. Vous n'avez à vous préoccuper du préambule que si vous créez un clone d'une carte. La fonction principale de cet appareil est d'enregistrer les données binaires brutes telles qu'elles sont émises par une interface Wiegand. Vous pouvez lire de 1 bit jusqu'à 4 096 bits. Le paramètre de tampon par défaut ne permet que 52 bits et doit être augmenté manuellement depuis la page des paramètres, accessible via l'interface web.

*Mode TX expérimental

L'appareil a été conçu avec un matériel minimal pour maintenir des coûts extrêmement bas et accessibles aux passionnés, et pour que les professionnels de la sécurité puissent acheter plusieurs unités et les utiliser sans craindre d'en perdre une. Cela dit, il n'y a pas de convertisseurs de niveaux (level shifters) sur la carte (il est possible qu'une version PRO soit publiée à l'avenir). Cela signifie qu'avec le matériel actuel, l'appareil peut fonctionner avec une interface Wiegand 3V3 ainsi qu'avec une interface Wiegand 5 V, car le matériel fonctionne à 3V3 et tolère également le 5 V. L'inconvénient est que tous les contrôleurs Wiegand 5 V ne sont pas garantis d'être déclenchés lors du rejeu ou du fuzzing des données, car seule une tension de 3V3 est émise par l'appareil. Il y a également un risque lorsque l'appareil est en mode TX et que la sortie passe à l'état bas pendant 40 µs : si l'appareil devait également recevoir des données pendant ce temps, un court-circuit se produirait. Pour cette raison, assurez-vous qu'absolument aucune carte n'est scannée pendant que l'appareil est en mode TX. L'appareil ne passe en mode TX que lorsque vous appuyez sur un bouton de soumission de formulaire ; dès que la transmission des données est terminée, il revient en mode écoute. Pour les raisons ci-dessus, le mode TX est réservé à une utilisation expérimentale et a été conçu principalement pour faciliter le débogage du logiciel lors de modifications (deux unités étaient reliées entre elles). Utilisez le mode transmission à vos propres risques ; il n'est pas officiellement pris en charge. Considérez-le comme un bonus du logiciel.

**Notes d'installation

Cliquez ici pour les schémas de câblage Cliquez ici pour voir les options de connecteurs

  • Assurez-vous que le lecteur émet des données au format Wiegand
  • Connectez D0 de l'appareil à D0 du lecteur
  • Connectez D1 de l'appareil à D1 du lecteur
  • Connectez + de l'appareil à + du lecteur
  • Connectez - de l'appareil à - du lecteur
    • L'ESP-RFID-Tool accepte 4,5-12 V, mais vous devez également vous assurer de fournir suffisamment de tension et de courant pour alimenter votre lecteur si vous créez une unité autonome ou portable.
    • SÉCURITÉ : J'ai appris que le régulateur de tension utilisé sur les unités commerciales que vous pouvez trouver en vente est différent de celui que j'avais initialement choisi pour ce projet. De plus, en raison de la pénurie mondiale de puces et de la possibilité que les fabricants substituent des composants, je réduis la tension maximale absolue à 12 V, car vous pourriez solliciter l'unité à ses limites à cette tension et des précautions supplémentaires doivent être prises. La plupart de mes prototypes portables plus petits fonctionnaient à environ 9 V (x6 piles AA) et j'ai trouvé cela plus que suffisant. Rappelez-vous que vous pouvez toujours alimenter votre lecteur et l'unité RFID-Tool séparément si nécessaire, et je suggère d'alimenter votre projet avec la tension la plus basse possible avec laquelle vous pouvez vous en sortir. En fait, j'ai trouvé plusieurs lecteurs qui fonctionnent très bien à une tension inférieure à celle recommandée. Notez que je n'ai pas remarqué d'augmentation significative de portée dans mes tests initiaux entre l'alimentation de mon lecteur à 12 V et à 24 V (je ne recommande pas cela, car j'ai tendance à abuser des spécifications pour ce que je teste, et j'utilisais un régulateur de tension différent dans mon prototype). Sachez également que la plupart des batteries couramment utilisées produisent plus que la tension nominale généralement indiquée lorsqu'elles sont complètement chargées. Il peut également être judicieux d'appliquer un dissipateur thermique sur votre régulateur de tension, surtout si vous remarquez que l'unité chauffe à la tension choisie. Il n'est également jamais recommandé de laisser votre appareil sans surveillance. Veuillez être prudent et prendre toutes les précautions de sécurité nécessaires lors du test de votre installation.
    • OPTIONNEL : Connectez une batterie 4,5-12 V aux mêmes + et - (uniquement si vous construisez une unité portable ; n'ajoutez pas de batterie si vous intégrez l'appareil dans une installation existante, ou si vous utilisez une batterie, ne connectez pas le fil + de l'installation existante à votre appareil, connectez uniquement la masse GND -)
    • REMARQUE : Au minimum, D0, D1 et GND(-) doivent être connectés au lecteur pour un fonctionnement correct, quelle que soit la source d'alimentation.
  • Configurez les paramètres
    • Voir ci-dessous

Comprendre les données binaires

Claviers Format piste magnétique/ABA

Flasher le firmware

OPTION 1 : OTA via l'interface web :

  • Téléchargez l'une des dernières versions depuis
    • https://github.com/rfidtool/ESP-RFID-Tool/releases
  • Connectez-vous au panneau d'administration de l'appareil et mettez à niveau le firmware.

OPTION 2 : IDE Arduino :

  • Utilisez l'ESP Flasher R4 d'April Brother :
    • https://blog.aprbrother.com/product/esp-flasher-r4
  • Clonez/téléchargez le code source.
  • Ajoutez ces bibliothèques :
    • Bibliothèque ArduinoJson 5.13.1 par Benoit Blanchon
      • https://github.com/bblanchon/ArduinoJson
    • ESP8266FtpServer.h
      • https://github.com/exploitagency/esp8266FTPServer/tree/feature/bbx10_speedup
  • Choisissez la carte NodeMCU 1.0.
  • Téléversez.

Aide du logiciel

Accéder à l'interface web d'ESP-RFID-Tool

SSID : « ESP-RFID-Tool » URL : http://192.168.1.1

Configurer ESP-RFID-Tool

Identifiants par défaut pour accéder à la page de configuration :

  • Nom d'utilisateur : « admin »
  • Mot de passe : « rfidtool »

Identifiants par défaut pour le serveur FTP :

  • Nom d'utilisateur : « ftp-admin »
  • Mot de passe : « rfidtool »

Configuration WiFi :

Type de réseau :

  • Mode point d'accès : créer un point d'accès autonome (aucune connectivité Internet - nécessite une proximité étroite)
  • Rejoindre un réseau existant : rejoindre un réseau existant (connectivité Internet possible - l'appareil pourrait être utilisé à distance)

Masqué : choisissez d'utiliser ou non un SSID masqué lors de la création d'un point d'accès

SSID : SSID du point d'accès à créer ou du réseau que vous choisissez de rejoindre Mot de passe : mot de passe du point d'accès que vous souhaitez créer ou du réseau que vous choisissez de rejoindre Canal : canal du point d'accès que vous créez

IP : IP à définir pour l'appareil Passerelle : passerelle à utiliser ; définissez-la comme l'IP d'ESP-RFID-Tool s'il s'agit d'un point d'accès, ou comme celle du routeur si vous rejoignez un réseau Masque de sous-réseau : généralement défini sur 255.255.255.0

Paramètres d'administration de l'interface web :

Nom d'utilisateur : nom d'utilisateur pour configurer/mettre à niveau ESP-RFID-Tool Mot de passe : mot de passe pour configurer/mettre à niveau ESP-RFID-Tool

Paramètres du serveur FTP :

Remarque : seul le mode passif (PASV) est pris en charge !

  • Activé : activer le serveur FTP
  • Désactivé : désactiver le serveur FTP Nom d'utilisateur : nom d'utilisateur pour se connecter au serveur FTP Mot de passe : mot de passe pour se connecter au serveur FTP

LED d'alimentation :

  • Activé : allumer la LED d'alimentation
  • Désactivé : éteindre la LED d'alimentation

Journal de capture RFID :

Utile de modifier cette valeur pour différencier les installations lors de diverses évaluations de sécurité. Nom de fichier : nom du fichier dans lequel enregistrer les étiquettes RFID capturées pour l'évaluation de sécurité en cours.

Lister les données exfiltrées

Affiche tous les fichiers journaux contenant des captures d'étiquettes RFID.

Formater le système de fichiers

Cela effacera le contenu du système de fichiers SPIFFS, y compris TOUTES les captures d'étiquettes RFID. Le formatage peut prendre jusqu'à 90 secondes. Tous les paramètres actuels seront conservés, sauf si vous redémarrez votre appareil pendant ce processus.

Mettre à niveau le firmware d'ESP-RFID-Tool

Authentifiez-vous avec votre nom d'utilisateur et votre mot de passe définis dans la page de configuration.

Identifiants par défaut pour accéder à la page de mise à niveau du firmware :

  • Nom d'utilisateur : « admin »
  • Mot de passe : « rfidtool »

Sélectionnez « Browse », choisissez le nouveau firmware à téléverser, puis cliquez sur « Upgrade ».

Vous devrez réinitialiser manuellement l'appareil lorsque le navigateur vous indiquera que la mise à niveau a réussi.

Cavaliers

  • J1 : pondez pour réinitialiser la carte (votre FTDI n'a pas de bouton de réinitialisation ?)
  • J2 : coupez la piste pour désactiver la broche DTR après la programmation, puis utilisez-la comme E/S supplémentaire (continuez à mettre à jour le firmware via l'interface web)
  • J3 : pondez ceci lors d'un cycle d'alimentation pour restaurer la configuration par défaut sans perdre vos fichiers journaux.

Restaurer les paramètres par défaut

  • Option 1 : accédez aux paramètres dans l'interface web et choisissez restaurer la configuration par défaut.
  • Option 2 : pondez J3 avant de démarrer l'appareil (soit avant la mise sous tension, soit pondez-le et réinitialisez l'appareil).
  • Option 3 : connectez-vous via le port série (9600 bauds) et envoyez la commande « ResetDefaultConfig: » sans les guillemets.

Historique

J'ai publié la conception du prototype original sur GitHub en septembre 2016, bien que sous un dépôt différent. J'utilisais un Adafruit Feather Huzzah exécutant un code que j'avais modifié en portant le Tastic RFID Thief (par Fran Brown de Bishop Fox) sur la puce ESP12S. À l'époque, aucun enregistreur Wiegand offrant des capacités WiFi et fournissant une interface web facile à utiliser pour accéder aux fichiers journaux n'existait (je n'en ai trouvé aucun, alors je l'ai créé). Au cours de la deuxième évolution du projet, j'ai décidé de concevoir un matériel dédié et j'ai légèrement amélioré le logiciel. C'était du matériel open source, disponible sur GitHub, mais encore difficilement accessible au grand public. Tout le monde n'est pas à l'aise avec la soudure de composants montés en surface, et même pour moi, l'assemblage de cartes à usage personnel prenait du temps. C'est alors que j'ai réalisé qu'il était nécessaire qu'un appareil abordable comme le mien soit produit en masse, afin que toute personne ayant un besoin légitime puisse y avoir accès. Au cours de la troisième étape, j'ai redessiné à la fois le logiciel et le matériel et j'ai décidé de contacter April Brother pour voir s'ils pouvaient le fabriquer et le vendre à un prix raisonnable. C'est ainsi qu'est né ESP-RFID-Tool.

Informations sur la licence

Créé par Corey Harding https://github.com/rfidtool/ESP-RFID-Tool Le logiciel ESP-RFID-Tool est sous licence MIT

Bibliothèques/code emprunté utilisés

Bibliothèques principales Arduino et ESP8266
  • Typiquement : GNU LESSER GENERAL PUBLIC LICENSE Version 2.1
    • Divers auteurs
ArduinoJson.h
  • The MIT License (MIT)
    • Copyright (c) 2014-2017 Benoit BLANCHON
ESP8266FtpServer.h
  • GNU LESSER GENERAL PUBLIC LICENSE Version 2.1
    • À l'origine par nailbuster, modifié plus tard par bbx10 et apullin
WiegandNG.h
  • GNU LESSER GENERAL PUBLIC LICENSE Version 2.1
    • JP Liew
Code du calculateur de préambule Wiegand
  • Aucune licence spécifiée
    • Fran Brown de Bishop Fox
strrev.h
  • Licence personnalisée (voir fichier)
    • Copyright (c) 2007 Dmitry Xmelkov
aba-decode.py
  • Aucune licence spécifiée
    • Andrew MacPherson(andrewmohawk)
Télécharger l’outil