Ein Werkzeug zum Protokollieren von Daten und Testen von Geräten mit Wiegand-Schnittstelle. Kann verwendet werden, um einen tragbaren RFID-Leser zu bauen oder direkt in eine bestehende Installation integriert zu werden. Bietet Zugriff auf eine webbasierte Oberfläche über WLAN im AP- oder Client-Modus. Funktioniert mit nahezu allen Geräten, die über eine standardmäßige 5-V-Wiegand-Schnittstelle verfügen. Die primäre Zielgruppe sind 26-37-Bit-HID-Karten. Ähnlich wie Tastic RFID Thief, Blekey und ESPKey.
Von Corey Harding
Offizielle Website:
April Brother stellt diese Hardware derzeit her und sie kann direkt aus China gekauft werden bei ihrem
Drittanbieter:
Video-Demos zum Erfassen von Zugangsdaten mit verschiedenen Technologien, die eine Wiegand-Schnittstelle nutzen:
Firmware:
Ein universeller Datenlogger, der die rohen binären Daten von einer standardmäßigen 5V-Wiegand-Schnittstelle erfasst. Das Gerät ist in der Lage, die Zugangsdaten für Zutrittskontrollsysteme oder nahezu jedes Gerät, das eine Wiegand-Schnittstelle nutzt, zu protokollieren – wie RFID-Kartenleser, Tastenfelder, Magnetstreifensysteme, Barcode und sogar einige biometrische Leser. Wiegand-Schnittstellen müssen auch nicht auf Zutrittskontrollsysteme beschränkt sein. Die Hauptzielgruppe für dieses Gerät sind 26-37-Bit-HID-Karten. Bei bekannten Kartentypen werden sowohl die binären als auch die hexadezimalen Daten direkt in der Protokolldatei angezeigt, um eine einfache Ausweisidentifikation zu ermöglichen und auch für den Fall, dass ein Klon einer Karte benötigt wird. Bei unbekannten Kartentypen werden nur die rohen binären Daten angezeigt.
Das Gerät kann direkt in ein bestehendes System installiert werden und seine Stromversorgung aus der vorhandenen Verkabelung beziehen, oder es kann verwendet werden, um einen Leser mit hinzugefügtem Akku in ein eigenständiges tragbares Gerät zur Datenerfassung zu verwandeln. Die Verkabelung ist einfach und besteht aus 4 Drähten: (+), (–), D0 (Grün) und D1 (Weiß). Das Gerät kann mit Spannungen von etwa 4,5 V bis maximal 12 V betrieben werden. Häufig vorkommende Spannungen sind 12 V und 5 V. **(Siehe Installationshinweise unten)
Der Zugriff auf die Protokolldateien und verschiedene Einstellungen erfolgt über eine webbasierte Oberfläche. Das Gerät verfügt über WLAN-Fähigkeiten und kann so eingerichtet werden, dass es einen eigenen Zugangspunkt erstellt oder sich mit einem bestehenden Netzwerk verbindet. Falls Sie aus der Weboberfläche ausgesperrt werden, können Sie den J3-Jumper beim Einschalten oder während des Zurücksetzens des Geräts überbrücken, um wieder Zugriff zu erhalten, ohne Ihre Protokolldateien zu verlieren.
Die Hardware basiert auf einem ESP12-WLAN-Chip mit vollständigem TCP/IP-Stack und Mikrocontroller-Einheit. Die Software ist Open Source unter der MIT-Lizenz lizenziert und wird am Tag des Produktstarts veröffentlicht. Die Software wird in diesem GitHub-Repo liegen, damit sie von der Community überprüft werden kann. Wir akzeptieren nach Prüfung verschiedene Pull-Requests von der Community, wenn sie den Wert des Geräts für andere verbessern. Die Software wurde in der Arduino-IDE geschrieben, sodass sowohl Hobbyisten als auch Profis keine Probleme haben werden, den Code zu modifizieren, wenn sie dies wünschen. Eine Wiegand-Schnittstelle arbeitet mit 3 Drähten: einer Masse, Data0 und Data1. Eine Null wird gesendet, wenn D0 auf Low geht, und eine Eins wird gesendet, wenn D1 auf Low geht; die andere Leitung bleibt während dieser Zeit High. Das Timing beträgt 40 µs von Low auf High auf einer Leitung mit 2 ms zwischen den Bits. Die Software protokolliert diese binäre Ausgabe in einer Datei, und wenn das Gerät glaubt, dass es sich um ein bekanntes Kartenformat handelt, wird die Präambel erraten (nicht vom Kartenleser gesendet, aber sie ist für alle Karten eines bestimmten Formats gleich; unser primäres Ziel sind 26-37-Bit-HID-Karten) und sowohl die rohen binären als auch die hexadezimalen Daten werden protokolliert. Bei unbekannten Kartenformaten wird nur die rohe binäre Ausgabe protokolliert, ohne eine Vermutung über die Präambel und ohne die Daten im hexadezimalen Format anzuzeigen, um Verwirrung zu vermeiden. Wenn Sie wissen, welche Art von Karte erfasst wurde, schlagen Sie einfach die Präambel nach, fügen Sie sie am Anfang der Binärdaten hinzu und konvertieren Sie sie dann typischerweise in das hexadezimale Format, um einen Klon einer Karte zu erstellen. Es ist möglich, dass die Karte tatsächlich ein unbekanntes Format hat und die Präambel falsch erraten wurde, weil das Gerät dachte, es sei ein bekanntes Kartenformat (die Vermutung basiert auf der vom Leser ausgegebenen Bitzahl). Wenn dies der Fall ist, gibt es in der Protokolldatei ein wörtliches Leerzeichen in den Binärdaten zwischen der Präambel und den Kartendaten; ignorieren Sie einfach die Präambel. Beim Wiedergeben einer erfassten Zugangsdaten*(siehe Hinweis unten) fügen Sie die Präambel nicht hinzu, da diese nicht vom Kartenleser ausgegeben wird; stattdessen geben Sie nur die tatsächlichen Kartendaten*(siehe Hinweis unten) so wieder, wie sie vom Leser ausgegeben werden. Sie müssen sich nur um die Präambel kümmern, wenn Sie einen Klon einer Karte erstellen. Die Hauptfunktion dieses Geräts besteht darin, die rohen binären Daten, die von einer Wiegand-Schnittstelle ausgegeben werden, zu protokollieren. Sie können von 1 Bit bis zu 4.096 Bits lesen. Die Standard-Puffereinstellung erlaubt nur 52 Bits und muss manuell über die über die Weboberfläche erreichbare Einstellungsseite erhöht werden.
Das Gerät wurde mit minimaler Hardware gebaut, um die Kosten extrem niedrig zu halten und es für Hobbyisten erschwinglich zu machen, und damit Sicherheitsexperten mehrere Einheiten kaufen und nutzen können, ohne Angst vor dem Verlust einer Einheit haben zu müssen. Allerdings befinden sich keine Pegelumsetzer auf der Platine. (Es ist möglich, dass in Zukunft eine PRO-Version veröffentlicht wird.) Das bedeutet, dass das Gerät mit der aktuellen Hardware sowohl mit einer 3V3-Wiegand-Schnittstelle als auch mit einer 5V-Wiegand-Schnittstelle arbeiten kann, da die Hardware mit 3V3 arbeitet und auch 5V-tolerant ist. Der Nachteil davon ist, dass nicht alle 5V-Wiegand-Controller beim Wiedergeben oder Fuzzing von Daten garantiert ausgelöst werden, da das Gerät nur 3V3 ausgibt. Es besteht auch ein Risiko, wenn sich das Gerät im TX-Modus befindet und der Ausgang für 40 µs auf Low geht: Wenn das Gerät während dieser Zeit auch Daten empfangen würde, entsteht ein Kurzschluss. Aus diesem Grund stellen Sie sicher, dass absolut keine Karten gescannt werden, während sich das Gerät im TX-Modus befindet. Das Gerät wechselt erst dann in den TX-Modus, wenn Sie eine Formular-Senden-Schaltfläche drücken, und sobald die Daten übertragen wurden, wechselt es zurück in den Empfangsmodus. Aus den oben genannten Gründen ist der TX-Modus nur für experimentelle Zwecke gedacht und wurde in erster Linie entwickelt, um die Software bei Änderungen einfach debuggen zu können. (Zwei Einheiten waren zusammengeschlossen.)
Die Verwendung des Übertragungsmodus erfolgt auf eigenes Risiko; er wird nicht offiziell unterstützt. Betrachten Sie ihn als Bonus in der Software.
Klicken Sie hier für Verdrahtungspläne
Klicken Sie hier für Anschlussoptionen
Tastenfelder
Magnetstreifen-/ABA-Format
OPTION 1: OTA über die Weboberfläche:
OPTION 2: Arduino-IDE:
SSID: "ESP-RFID-Tool"
URL: http://192.168.1.1
Netzwerktyp:
Versteckt: Wählen Sie, ob beim Erstellen eines Zugangspunkts eine versteckte SSID verwendet werden soll oder nicht.
SSID: SSID des Zugangspunkts, den Sie erstellen möchten, oder des Netzwerks, dem Sie beitreten möchten.
Passwort: Passwort des Zugangspunkts, den Sie erstellen möchten, oder des Netzwerks, dem Sie beitreten möchten.
Kanal: Kanal des Zugangspunkts, den Sie erstellen.
IP: IP-Adresse, die für das Gerät festgelegt werden soll.
Gateway: Zu verwendendes Gateway; setzen Sie es auf die IP-Adresse des ESP-RFID-Tool, wenn es sich um einen Zugangspunkt handelt, oder auf die des Routers, wenn Sie einem Netzwerk beitreten.
Subnetz: Normalerweise auf 255.255.255.0 gesetzt.
Benutzername: Benutzername zum Konfigurieren/Aktualisieren des ESP-RFID-Tool.
Passwort: Passwort zum Konfigurieren/Aktualisieren des ESP-RFID-Tool.
FTP-Server-Einstellungen:
Hinweis: Unterstützt nur den passiven (PASV) Modus!
Betriebs-LED:
RFID-Erfassungsprotokoll:
Es ist nützlich, diesen Wert zu ändern, um bei verschiedenen Sicherheitsbewertungen zwischen Einrichtungen zu unterscheiden.
Dateiname: Dateiname, unter dem erfasste RFID-Tags für die aktuelle Sicherheitsbewertung gespeichert werden sollen.
Zeigt alle Protokolldateien mit erfassten RFID-Tags an.
Dies löscht den Inhalt des SPIFFS-Dateisystems, einschließlich ALLER erfassten RFID-Tags.
Das Formatieren kann bis zu 90 Sekunden dauern.
Alle aktuellen Einstellungen bleiben erhalten, es sei denn, Sie starten Ihr Gerät während dieses Vorgangs neu.
Authentifizieren Sie sich mit Ihrem in der Konfigurationsseite festgelegten Benutzernamen und Passwort.
Standard-Anmeldedaten für den Zugriff auf die Firmware-Aktualisierungsseite:
Wählen Sie "Durchsuchen", wählen Sie die neue hochzuladende Firmware aus und klicken Sie dann auf "Aktualisieren".
Sie müssen das Gerät manuell zurücksetzen, sobald der Browser Sie benachrichtigt, dass die Aktualisierung erfolgreich war.
Ich habe das Design des ursprünglichen Prototyps im September 2016 auf GitHub veröffentlicht, wenn auch in einem anderen Repo. Ich verwendete einen Adafruit Feather Huzzah, auf dem Code lief, den ich modifiziert hatte, um den Tastic RFID Thief (von Fran Brown von Bishop Fox) auf den ESP12S-Chip zu portieren. Damals gab es keine Art von Wiegand-Logger mit WLAN-Fähigkeiten und einer benutzerfreundlichen Weboberfläche für den Zugriff auf die Protokolldateien. (Ich konnte keinen finden, also habe ich ihn erstellt.) Während der zweiten Entwicklungsstufe des Projekts beschloss ich, dedizierte Hardware zu entwerfen, und ich habe die Software leicht verbessert. Es handelte sich um Open-Source-Hardware, die auf GitHub verfügbar war, aber für die breite Masse immer noch nicht leicht zugänglich war. Nicht jeder traut sich SMD-Lötarbeiten zu, und selbst für mich war das Zusammenbauen von Boards für den persönlichen Gebrauch zeitaufwendig. Da wurde mir klar, dass es einen Bedarf für ein erschwingliches Gerät wie meines gibt, das massenproduziert werden kann, damit jeder, der einen legitimen Bedarf dafür hat, Zugang dazu haben kann. In der dritten Stufe habe ich sowohl die Software als auch die Hardware neu gestaltet und beschlossen, April Brother zu kontaktieren, um zu sehen, ob sie es herstellen und zu einem fairen Preis verkaufen können. Da wurde ESP-RFID-Tool geboren.
Erstellt von Corey Harding
https://github.com/rfidtool/ESP-RFID-Tool
Die ESP-RFID-Tool-Software ist unter der MIT-Lizenz lizenziert.
