Mobile Network Assessment Tools

h2. 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":https://GSMmap.org

Also on the live system lives:

* "*SIMtester*":https://opensource.srlabs.de/projects/simtester/wiki

Finds configuration bugs in SIM cards

A public mailing list for discussions and occasional announcements is found "here":https://lists.srlabs.de/cgi-bin/mailman/listinfo/gsmmap

*****

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

h3. Instructions

# Download TODO

# unpack TODO

# run:  <pre>sudo ./xgoldscanner.sh -n [telephone number, e.g. +491234567]</pre>

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)

h3. Advanced usage

Use Tobias Engel's "xgoldmon":https://github.com/2b-as/xgoldmon tool to analyze the trace log files.

h3. Mailing list

A public mailing list for discussions is found "here":https://lists.srlabs.de/cgi-bin/mailman/listinfo/gsmmap

*****

h2. CatcherCatcher

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

h3. Requirements

* Osmocom phone

* Osmocom cable

* Linux computer

h3. Download:

* Source Code TODO

* Live System TODO

h3. Instructions

# Download TODO

# unpack TODO

# run: TODO call

* TODO command line parameters

h3. Mailing list

A public mailing list discussion is "here":https://lists.srlabs.de/cgi-bin/mailman/listinfo/catchercatcher

*****

h2. GSMmap-apk

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

h3. Requirements:

* Samsung Galaxy S2 / S3 phone

h3. Download:

* Pre-compiled .apk TODO

* Source Code TODO

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

h3. Instructions

# Install application from Google Play app store TODO

# Run

h3. Mailing list

A public mailing list for discussions is "here":https://lists.srlabs.de/cgi-bin/mailman/listinfo/gsmmap

*****

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

h3. Requirements

* Computer capable of running 64bit Linus

* For each test: Requirements listed in the respective tool wiki pages

h3. Download

* Live system image TODO

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

h3. Instructions

# Download TODO

# Unpack: <pre>tar xvzf gsmmap-live.img.tar.gz</pre>

# Write to stick <pre>dd if=gsmmap-live.img of=/dev/[USB-stick] [bs=1M]</pre>

# Boot from stick

h3. Mailing list

A public mailing list for discussions is "here":https://lists.srlabs.de/cgi-bin/mailman/listinfo/gsmmap

Please file bugs and support requests through the "issue tracker":https://opensource.srlabs.de/projects/mobile-network-assessment-tools/issues/new as they may be of little relevance to the majority of the mailing list subscribers.