Project

General

Profile

Actions

Wiki » History » Revision 20

« Previous | Revision 20/29 (diff) | Next »
Peter, 10/01/2014 06:45 PM


SIMtester

The provided tools assess SIM card security in two dimensions:

  • Cryptanalytic attack surface. Collect cryptographic signatures and encryptions of known plaintexts
  • Application attack surface. Generate a list of all application identifiers (TAR) and find "unprotected" (MSL=0) applications

Requirements

  • Java 1.7 (code can be easily tweaked to compile under Java 1.6 or even lower if needed)
  • PC/SC reader (via pcsc daemon) –or–
  • Osmocom phone (via libosmosim)

Download

  1. Pre-compiled .jar with libraries
  2. Live-System
  3. "Source code"
     git clone https://opensource.srlabs.de:/git/SIMtester.git

Instructions

Running SIMTester on LiveISO

Choose "Run Test" -> "SIM" from main menu, follow instructions.

Running SIMTester by hand

SIMTester is a Java application (JAR archive), both sources and binaries are accessible under SIMTester.

 git clone https://opensource.srlabs.de:/git/SIMtester.git

Unpack:

 unzip SIMTester_v1.5.zip

You can either compile your own JAR from sources or run the pre-compiled JAR in "binaries/" directory like this:

java -jar SIMTester.jar <arguments>
General options
command line option description
-vp, --verify-pin <pin> verifies the PIN, works for CHV1
-sp, --skip-pin skips verification of a PIN and ignore permission errors (may produce incomplete results!)
-dp, --disable-pin <pin> disables PIN, works for CHV1 (ideal for testing cards so no PIN database in needed)
-tf, --terminal-factory <PCSC/OsmocomBB> what are you using as SIM card reader
-ri, --reader-index <index of a reader> multiple PC/SC readers can be connected, first is 0
-gsmmap, --gsmmap Automatically contribute data to gsmmap.org
SIMTester contains 3 main functionalities:
Fuzzer
Has its own intelligent logic, fuzzes ~120 chosen TARs, is divided into 3 modes:
  • Full fuzzing (default) - all 15 keysets with all 16 fuzzing mechanisms
  • Quick fuzzing (-qf option) - keysets 1 to 6, only 4 most successful fuzzing mechanisms
  • Poke the card (-poke option) - same as quick fuzzing but only fuzzes 3 most common TARs (000000, B00001, B00010)

Custom keysets and TARs can be specified via -t and -k parameters (space being a delimiter between multiple values).

TAR Scanner
Scans for valid TAR values by sending messages to them, has 2 modes:
  • Full scan (-st option) - scans for all possible TAR values (0x000000 - 0xFFFFFF) - may take a few hours or several days depending on your SIM card speed
  • Ranged scan (-str option) - scans for valid TAR values in pre-specified ranges to optimise the scanning duration

A starting value for Full scan can be specified using -t option.
A keyset used for sending messages can be specified using -k option (for both Full and Ranged scans).

Tip: run fuzzer first, see what keysets seem responsive (give answers other than none) and use one of those for TAR scanning, because if you use an inactive keyset it's very probable the card will NOT answer even on a valid TAR which makes TAR scanning non-functional.

APDU Scanner
Scans for valid APDU values (think of APDUs as of commands to the card) on TARs without any public APDU reference, it has 2 modes:
  • LEVEL 1 scan (performed automatically after Fuzzer finishes and has found unprotected TARs with responses) - only scans for valid CLA 0x00 - 0xFF - it is performed via OTA messages.
  • LEVEL 2 scan (-sa option) - scans for both CLA 0x00 - 0xFF and INS 0x00 - 0xFF - it is performed locally on card I/O on initially selected application
Using OsmocomBB phone as a SIM reader

This requires a patched firmware and a libosmosim.so library. Patched sources can be found in luca/libosmosim branch in OsmocomBB git tree:

git clone git://git.osmocom.org/osmocom-bb.git
cd osmocom-bb/
git checkout luca/libosmosim

once compiled use the layer1.compalram.bin firmware and copy libosmosim.so (layer23/src/libosmosim/.libs/) to your java.library.path folder (usually /usr/lib/jni/ on Linux).

then just use -tf OsmocomBB to turn your Osmocom phone into a SIM card reader for SIMTester.

Contribution to gsmmap.org

a new option -gsmmap has been introduced in version 1.5 in order to provide upload functionality to gsmmap.org even for users not using the Live-System

Tor can be also used by specifying:

java -jar SIMTester.jar -gsmmap -socksProxyHost=127.0.0.1 -socksProxyPort=<tor_port> ... other options ...

If you already have scanned your cards without -gsmmap option, you can use the web form here: http://gsmmap.org/upload.html to upload your CSV results SIMTester provided.

Dependencies

Software uses several libraries, if compiled from source the following libraries are needed:

Mailing list

A public mailing list for announcements and discussion can be found here
Feel free to post your questions, observations or results.

Updated by Peter almost 7 years ago · 20 revisions