https://github.com/coldheat/iclass
Tool to read and write iclass cards without the master key
https://github.com/coldheat/iclass
Last synced: about 1 month ago
JSON representation
Tool to read and write iclass cards without the master key
- Host: GitHub
- URL: https://github.com/coldheat/iclass
- Owner: ColdHeat
- Created: 2016-06-12T03:27:21.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2019-06-02T20:22:21.000Z (almost 6 years ago)
- Last Synced: 2025-03-29T05:03:41.196Z (about 2 months ago)
- Language: C
- Homepage: https://blog.kchung.co/reverse-engineering-hid-iclass-master-keys/
- Size: 1.19 MB
- Stars: 105
- Watchers: 11
- Forks: 37
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# iclass
In order to read and write to cards, you will, at the minimum, need a reader/writer. The simplest way to get one is to get a reader/writer from the HID OMNIKEY line. Either the HID OMNIKEY 5321 or 6321 will work and both are fairly cheap at around $50. The model number does not matter very much, contrary to what you may think. I used an HID OMNIKEY 6321 CLi and an HID OMNIKEY 5321 v2 CLi. It is unverified but you may need to use Windows XP in order to use the drivers. I used Windows XP.
To build the software you want to start off by downloading the [MinGW installer assistant](https://sourceforge.net/projects/mingw/files/Installer/mingw-get-setup.exe/download). Install it and select:
* mingw-developer-toolkit
* mingw32-gcc-g++
* msys-base
It should look something like this:
Then go to `Installation > Apply Changes` on the menu bar to install part of your build environment.
Now go to `C:\MinGW\msys\1.0` and copy everything over to `C:\MinGW`.
Open the `msys.bat` file to get a small shell environment. Clone the provided source code into the home folder, go into the `iclassified` directory, and run `make`.
If everything runs well you should get `iclass.exe` and `iclassified.o`
At this point you should plug in your OMNIKEY reader and follow the instructions provided alongside [the drivers](http://www.proxmark.org/files/Various%20Hardware/OMNIKEY%205x21/OMNIKESY5x21_V1_2_0_14.exe) to get the reader setup.
If all goes well you should be able to execute `iclass.exe read` to read a card and `iclass.exe write` to write to a card.
