Intro

I did not create the software, nor am I developer, the software has always been publicly available at this github repository: https://github.com/ColdHeat/iclass. I am simply creating my own fork with more details and clarification since the original has been neglected for a while. Contributions are welcome. As always these types of programs are meant only to be used for education and/or security penetration purposes only. I highly recommend all vendors to upgrade to iClass SE (and use the SE card) since legacy card can be so easily be cloned as seen below

Installing iClassified

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. The preferred and tested reader is the HID OMNIKEY 5321 v2 Cli its fairly cheap at around $50. The model number does matter, as the HID OMINKEY 5321 Sam CL will not work with this program. Other have used an HID OMNIKEY 6321 CLi though I have never tested it. iClassifed will work on Windows XP or Windows 10 (32 bit only!!). I used Windows XP on VMware.

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.

Next, open the msys.bat file (located in the MinGW folder) to get a small shell environment. A new "home" folder should apprear. Now download the iClass folder, extract the zip, and copy all the files into the "home" folder Now that the files have been copied go back into the iclassified directory (type in "cd iclassified" or whatever its named; might be named your username; just go into wherever you copied the new files from Github) and type in make.

If everything runs well the files iclass.exe and iclassified.o should appear in your "home" folder. If you get the error "The application failed to initialize properly (0xc0150002)" then you may need to install Microsoft Visual C++ 2008 Redistributable Package (x86).

At this point you should plug in your OMNIKEY reader and install the following drivers.

Only the drivers from 2009 and below will work with iClassiified!

Installing the driver on Windows (work the same with Windows XP)

The following is shown using a 6321 cli reader, but the process is the same across the board.

First, you must install the driver provided in the repo.

In device manager, you should see your Omnikey listed under "Smart card readers" Right click on the Omnikey, then select "Properties"

In the properties for the Omnikey, click the "Drivers" tab

In the drivers page, click "Update Driver"

Click on "Browse my computer for driver software"

Click on "Let me pick from a list of available drivers on my computer"

Click on "Have Disk..."

Click on "Browse"

Click on "This PC" Then select you C:\ drive

Click on the folder entitled "OMNIKEY" (or where ever you installed the Omnikey driver)

Click on the folder entitled "5x21_V1_2_0_14"

Click on the folder entitled "W32"

Click on the file called "cxru0wdm" Click "Open"

Click "OK" in the "Install From Disk" window

Click "Next" in the update drivers window

Now if you go back into the properties of your Omnikey, you should see that the driver has been downgraded, so it should now work with the software provided in this repo!

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.

Reading and Writing Cards

After you compile the program using the "make" command you should have the iclass.exe program. This will now allow you to read and write the required data blocks (6,7,8,9) that you need to make a clone of the card. In order for the card to be cloned succesfully it is crucial that those 4 blocks are cloned.

To Read All the blocks in a card:

Use the "iclass.exe read" command to read the entire set of data blocks.

To Read a blocks in a card:

Use the "iclass read" command to read a data block (e.g. "iclass read 6")

To Write date to a block

Use the "iclass write" command to write each of the four blocks. (e.g. "iclass write 6 030303030003E017" to write block 6)

Troubleshooting

Can't find Omnikey Reader

Either you are using a newer driver or the wrong reader. Only the 5321 or 6321 v2 Cli works.

Could not connect retrieve smart card reader list

Your reader is not plugged in correctly

Authentication Failed

Your using a high security iClass card, iClassified can't read those card. Security secured:+1: