A small example package
Project description
# BLECryptracer # These scripts require Python v3+ and have been tested with Androguard v3.3.5. These (and all dependencies) should be installed on your system.
In order to install dependencies you can
` pip install -r requirements.txt `
In order to analyse an APK you will need to type the following ` python BLECryptracer.py -i APK_FILE_TO_ANALYSE [-o OUTPUT_FILE_IN_JSON] `
If no output file is provided, the result will be saved in a file named output.json.
During execution several files and folders may be created. Those will be deleted after exectuion.
The output JSON file contains the following: ` FILENAME - The name of the APK file PACKAGE - The package name (e.g., com.test.app) XETVALUE_CALL - True if the APK makes calls to one of the android.BluetoothGattCharacteristic setValue or getValue methods. The scripts stop processing an APK if this is False. CRYPTO_USE - True if the APK contains *any* calls to the javax.crypto or java.security methods. The scripts stop processing an APK if this is False. CRYPTO_IN_XETVALUE - True if cryptographically-processed BLE data was identified. False otherwise CONFIDENCE_LEVEL_XETVALUE - One of High, Medium or Low, depending on how certain we are of the result. Only relevant when CRYPTO_IN_XETVALUE is True NET_USE - True if the APK contains any calls to java.net.URLConnection, java.net.HttpURLConnection or javax.net.ssl.HttpsURLConnection. Only present in the output of the setvalue script. LOCATION_XETVALUE - The last processed method (that calls setValue or getValue) LOCATION_CRYPTO_XETVALUE - The method that calls the crypto-library (linked to the BLE data) NUM_XETVALUE_METHODS - The total number of calls to setValue/getValue. Note that the scripts stop processing at the first instance where crypto is identified. ALL_XETVALUE_METHODS - A list of all methods that call setValue/getValue TIME_TAKEN_XETVALUE - The time taken to process an APK BLE_UUIDS - UUIDs that have been extracted with BLE functionality. These can be of several kinds depending on how they were extracted. CLASSIC_UUIDS - UUIDs that belong to Classic Bluetooth. These are not relevant at the moment. `
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for BLECryptracer_BLEMAP-0.0.7.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 977abe8e338370ad78247d636f6f0d7b22461e459cd33da4e491fa7760a17c54 |
|
MD5 | ae71d29e8155e6e4f2c805f38e30a719 |
|
BLAKE2b-256 | 3b881682f7fa927fbb18764a3a89cba44d29f7bd717460132c92ea3a8dfe4241 |