Overview¶

This is a collection of tools for the assessment of mobile network security.
It includes:

• GSMmap-apk
  Android application that collects 2G and 3G network traces from Samsung Galaxy phones

• xgoldscanner
  Linux application that collects 2G and 3G network traces from Samsung Galaxy phones

• CatcherCatcher
  Collect evidence of 2G fake base station activity (requires Osmocom phone)

The tools are included in the GSMmap-live system, which auto-submits data for analysis at GSMmap.org
Also on the live system lives:

• *SIMtester*
  Finds configuration bugs in SIM cards

A public mailing list for discussions and occasional announcements is found here

---

xgoldscanner¶

This script collects 2G and 3G traces using Samsung Android phones.
The trace log files can be analyzed with Tobias Engel's xgoldmon tool, which heavily inspired the development of xgoldscanner.

Requirements¶

• Samsung Galaxy S2 / S3 phone
• Micro-USB cable
• Linux computer

Download¶

TODO:

• Source Code (bash)
• Live System

Disclaimer¶

The tests include an active part. First, your phone will place outgoing calls to a dedicated number. This number will always be busy and never answer in order to rule out voice charges as best as we can.

Second, your phone will send SMS short messages via an invalid SMS-C to an invalid number.

During our tests (in Europe) we have not encounter any network that would charge for these transactions. However, we can not rule out that you may be charged in specific settings.

To control for involuntary charges, we strongly advise the use of a dedicated pre-paid SIM card for these tests.

Instructions¶

1. Download TODO
2. unpack TODO
3. run:

   sudo ./xgoldscanner.sh -n [telephone number, e.g. +491234567]

   
   Optional parameters:
• -g conduct GPRS test
• -d display debug messages
• -o offline mode [skip log upload for manual submission]
• -3 conduct 3G tests only [skip 2G tests]
• -y assume "yes" to questions and confirmation dialogues [for automated testing]
• -i <n> repeat each test <n> times (default is 5)

Advanced usage¶

Use Tobias Engel's xgoldmon tool to analyze the trace log files.

Mailing list¶

A public mailing list for discussions is found here

---

CatcherCatcher¶

The CatcherCatcher tool detects mobile network irregularities hinting at fake base station activity.

Requirements¶

• Osmocom phone
• Osmocom cable
• Linux computer

Download:¶

• Source Code TODO
• Live System TODO

Instructions¶

1. Download TODO
2. unpack TODO
3. run: TODO call
• TODO command line parameters

Mailing list¶

A public mailing list discussion is here

---

GSMmap-apk¶

Actively collect 2G and 3G traces using Samsung Android phones.

Requirements:¶

• Samsung Galaxy S2 / S3 phone

Download:¶

• Pre-compiled .apk TODO
• Source Code TODO

Disclaimer¶

The tests include an active part. First, your phone will place outgoing calls to a dedicated number. This number will always be busy and never answer in order to rule out voice charges as best as we can.

Second, your phone will send SMS short messages via an invalid SMS-C to an invalid number.

During our tests (in Europe) we have not encounter any network that would charge for these transactions. However, we can not rule out that you may be charged in specific settings.

To control for involuntary charges, we strongly advise the use of a dedicated pre-paid SIM card for these tests.

Instructions¶

1. Install application from Google Play app store TODO
2. Run

Mailing list¶

A public mailing list for discussions is here

---

GSMmap-live¶

This live Linux system is equipped with all the assessment tools listed above. It furthermore includes TODO
The live system facilitates their use and automatically uploads logs to GSMmap.org.

Requirements¶

• Computer capable of running 64bit Linus
• For each test: Requirements listed in the respective tool wiki pages

Download¶

• Live system image TODO

Disclaimer¶

The tests include an active part. First, your phone will place outgoing calls to a dedicated number. This number will always be busy and never answer in order to rule out voice charges as best as we can.

Second, your phone will send SMS short messages via an invalid SMS-C to an invalid number.

During our tests (in Europe) we have not encounter any network that would charge for these transactions. However, we can not rule out that you may be charged in specific settings.

To control for involuntary charges, we strongly advise the use of a dedicated pre-paid SIM card for these tests.

Instructions¶

1. Download TODO
2. Unpack:

   tar xvzf gsmmap-live.img.tar.gz

3. Write to stick

   dd if=gsmmap-live.img of=/dev/[USB-stick] [bs=1M]

4. Boot from stick

Mailing list¶

A public mailing list for discussions is here

Please file bugs and support requests through the issue tracker as they may be of little relevance to the majority of the mailing list subscribers.