gunkpunk / iclass

Tool to read and write iclass cards without the master key

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. 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 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.