Project

General

Profile

Wiki » History » Revision 49

Revision 48 (Luca, 07/26/2017 06:24 PM) → Revision 49/67 (Luca, 10/20/2017 12:43 PM)

h1. SnoopSnitch 

 SnoopSnitch is an Android app that collects and analyzes mobile radio data to make you aware of your mobile network security and to warn you about threats like fake base stations (IMSI catchers), user tracking and over-the-air updates. With SnoopSnitch you can use the data collected in the GSM Security Map at gsmmap.org and contribute your own data to GSM Map. 

 !{width: 10%;}sc_dashboard.png!    !{width: 10%;}sc_map_overview.png! !{width: 10%;}sc_catcher_hour.png! !{width: 10%;}sc_map_details.png! 

 This application currently only works on Android phones with a Qualcomm chipset and a stock Android ROM (or a suitable custom ROM with Qualcomm DIAG driver). It requires root priviliges to capture mobile network data. 

 h3. Documentation 

 For details on SnoopSnitch please refer to the [[FAQ]]. 
 Learn about SnoopSnitch's [[IMSI Catcher Score| IMSI catcher metric]]. 
 See which [[Android application permissions]] are required to run SnoopSnitch. 

 h3. Requirements: 

 * Qualcomm-based Android phone (see [[DeviceList|device list]]) 
 * *Stock* Android ROM, version 4.1 or later 
 Note: Custom Android ROMs like CyanogenMod may or may not work, depending on the availability of a Qualcomm DIAG kernel driver (DIAG_CHAR). 
 * *Root privileges* on phone 

 h3. Incompatible Devices: 

 The following devices have been found to be incompatible and can *not* be used with SnoopSnitch: 

 * *Unsupported.* Devices with custom ROM such as CyanogenMod which lacks the Qualcomm DIAG kernel driver (DIAG_CHAR) 
 * *Unsupported.* Every device without Qualcomm chipset 
 * *Unsupported.* Samsung Galaxy S2 & S3 
 * *Unsupported.* Nexus 5 with stock Android 
 * *Unsupported.* Huawei Ascend Y300 

 h3. Download: 

 * "Pre-compiled .apk":https://opensource.srlabs.de/attachments/download/136/SnoopSnitch-1.0.3.apk .apk":https://opensource.srlabs.de/attachments/download/135/SnoopSnitch-1.0.2.apk (SHA1: 221444eb1c63498bf045b5504d729023def51396) b2e710235231861d5825051946580fd2f9d44083) 
 * "Pre-compiled .apk from Google Play Store":https://play.google.com/store/apps/details?id=de.srlabs.snoopsnitch 
 * "Pre-compiled .apk from F-Droid":https://f-droid.org/repository/browse/?fdid=de.srlabs.snoopsnitch 
 * Source Code: <pre>git clone --recursive https://opensource.srlabs.de/git/snoopsnitch.git</pre> 

 SnoopSnitch is released under the GPL v3 license (cf. source:COPYING). The app is known to built under Linux and OS X, see source:README for build instructions. 

 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 to an invalid number. In some cases, we saw operators charging for these kind of transactions transactions. Hence, please have an eye on your phone bill when performing active tests using SnoopSnitch. To control for involuntary charges, we strongly advise the use of a dedicated pre-paid SIM card for these tests. 

 Furthermore, our call server will call your phone and send test SMS during the active test. To avoid unnecessary costs on our side, *DO NOT PICK UP OR REJECT AUTOMATIC CALLS FROM OUR SERVER*. If you pick up a call or have a mailbox or auto-answer feature configured that picks up the call automatically you may get blacklisted and cannot use our service anymore. Please see our [[Banned]] wiki page for details. 

 h3. Instructions 

 # Make sure you have rooted the phone 
 # Install application from "Google Play app store":https://play.google.com/store/apps/details?id=de.srlabs.snoopsnitch or below 
 # Run the app, execute active tests, upload security events and suspicious activity 

 h3. Mailing list 

 A public mailing list for discussions is "here":https://lists.srlabs.de/cgi-bin/mailman/listinfo/gsmmap 
 For specific questions to the snoopsnitch-team that do not require or permit public discussion, please contact us directly at *snoopsnitch [you know what to put here] srlabs.de* 

 h3. Version history 

 Version 1.0.2 

 * Improved compatibility with newer Android versions and devices 
 * Configurable notifications 

 Version 1.0.1 

 * Android 5 and 6 support 
 * Improved reliability of active test 
 * Better support for LG phones 

 Version 1.0.0 

 * Wireshark/pcap export 
 * Improved IMSI catcher metric 
 * Lower battery impact 
 * Autonomous upload option 
 * Daily measurement option 

 Version 0.9.8 

 * Improved catcher detection 
 * Reduced memory consumption 
 * 4G data collection and basic analysis 
 * Various enhancements and bug fixes  

 Version 0.9.7 

 * Improve detection of type 1 catchers and silent calls 
 * Reduce false positive rate 
 * Upload anonymized metadata additionally to radio traces 
 * Various enhancements and bug fixes 

 Version 0.9.5 

 * Make detection run automatically on boot 
 * Support LTE active tests 
 * Improve detection of 2G/3G catchers 
 * Detect empty WAP pushes 

 Version 0.9.4 

 * Improve type 1 catcher and silent SMS detection 
 * Implement network info screen 
 * Detect malfunctioning baseband interface 
 * Various enhancements and bug fixes 

 Version 0.9.3 

 * Support Android 5 
 * Fix initialization issue on newer devices 
 * Translation to German and Dutch 

 Version 0.9.2 

 * Fixed app lock-up issues 
 * Improved device compatibility check 
 * Handled unsupported LTE gracefully 

 Version 0.9.1 

 * Fix problem where SnoopSnitch would leave the phone muted after a test 
 * Remove issue with disappearing (Skype) dialing dialogs 
 * Resolved performance issue in analysis 

 Version 0.9.0 

 * Initial public release 

 h1. Training Material 

 As a primer to the snoopsnitch detection approach, we have prepared a set of hands-on "training material":https://opensource.srlabs.de/attachments/download/114/snoopsnitch_training_material.zip. 
 It contains network traces of IMSI catcher attacks and silent SMS and an analysis guide.