Skip to content

An Android NFC-App for reading, writing, analysing, etc. Mifare Classic RFID-Tags.

License

Notifications You must be signed in to change notification settings

mjiujiang/MifareClassicTool

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MifareClassicTool

An Android NFC-App for reading, writing, analyzing, etc. Mifare Classic RFID-Tags.

Features

  • Read Mifare Classic tags
  • Save, edit and share the tag data you read
  • Write to Mifare Classic tags (block-wise)
  • Clone Mifare Classic tags
    (Write dump of a tag to another tag; write 'dump-wise')
  • Key management based on dictionary-attack
    (Write the keys you know in a file (dictionary).
    MCT will try to authenticate with these
    keys against all sectors and read as much as possible.
    See chapter Getting Started.)
  • Format a tag back to the factory/delivery state
  • Write the manufacturer block of special Mifare Classic tags
  • Create, edit, save and share key files (dictionaries)
  • Decode & Encode Mifare Classic Value Blocks
  • Decode & Encode Mifare Classic Access Conditions
  • Display generic tag information
  • Display the tag data as highlighted hex
  • Display the tag data as 7-Bit US-ASCII
  • Display the Mifare Classic Access Conditions as a table
  • Display Mifare Classic Value Blocks as integer
  • In-App (offline) help and information
  • It's open source. ;)

General Information

This tool provides several features to interact with (and only with) Mifare Classic RFID-Tags. It is designed for users who have at least basic familiarity with the Mifare Classic technology. You also need an understanding of the hexadecimal number system, because all data input and output is in hexadecimal.

Some important things are:

  • The features this tool provides are very basic. There are no such fancy things like saving a URL to an RFID-Tag with a nice looking graphical user interface. If you want so save things on a tag, you have to input the raw hexadecimal data.
  • This App can not crack/hack any Mifare Classic keys. If you want to read/write an RFID-Tag, you first need keys for this specific tag. For additional information please read/see chapter Getting Started.
  • There will be no "brute-force" attack capability in this application. It is way too slow due to the protocol.
  • This app will not work on the following devices because their hardware (NFC-controller) does not support Mifare Classic (read more). This list may be incomplete.
    • Google Nexus 4
    • Google Nexus 5
    • Google Nexus 7 (2013)
    • Google Nexus 10
    • Samsung Galaxy S4
    • Samsung Galaxy Ace 3
    • Samsung Galaxy Express 2
    • Samsung Galaxy Mega
    • Samsung Galaxy Note 3
    • LG G2
    • LG Optimus L7 II
    • Motorola Moto X

For further information about Mifare Classic check Wikipedia, do some Google searches or read the Mifare Classic (1k) 'Datasheet' (PDF) from NXP.

Getting Started

First of all, you need the keys for the tag you want to read. Due to some weaknesses in Mifare Classic, you can retrieve all the keys (A and B) of a tag with tools like the Proxmark3 or normal RFID-Readers and some special software (mfcuk, mfoc).

The application comes with standard key files called std.keys and extended-std.keys, which contains the well known keys and some standard keys from a short Google search. You can try to read a tag with this key file using "Read Tag" from main menu.

Once you know some keys, you cam to put them into a simple text file (one key per line). You can do this on your PC and transfer the file to the MifareClassicTool/key-files/ directory (on external storage), or you can create a new key file via "Edit or Add Key File" from main menu. If you are finished setting up your key file, you can read a tag using "Read Tag" from main menu.

Advantages of the Key Files Concept:

  • You don't have to worry about which key is for which sector.
    The application tries to authenticate with all keys from the key
  • You don't have to know all the keys.
    If neither key A nor key B for a specific sector is found in the key file (dictionary), the application will skip reading said sector.

This dictionary-attack based mapping process (keys <-> sectors) makes it easy for you to read as much as possible with the keys you know!

License

This application was originally developed by Gerhard Klostermeier in cooperation with SySS GmbH (www.syss.de) and Aalen University (www.htw-aalen.de) in 2012/2013. It is free software and licensed under the GNU General Public License v3.0 (GPLv3)

Icons used in this application:

MIFARE is a registered trademark of NXP Semiconductors.

Import Code into Eclipse (with Android SDK)

  • File > New > Project... > Android > Android Project from Existing Code
  • Select (browse to) the Mifare Classic Tool folder from the git-repository
  • Click Finish
  • If there are issues with the project properties: right-click on the MifareClassicTool project > Android Tools > Fix Project Properties

About

An Android NFC-App for reading, writing, analysing, etc. Mifare Classic RFID-Tags.

Resources

License

Stars

Watchers

Forks

Packages

No packages published