🤖 A tool for analysing Android APKs and extracting root, integrity, and tamper detection checks 📱
DIS{integrity} is a tool for analyzing Android APKs, focusing on identifying root, integrity, and tamper detection checks inside of the APK. It uses APKTool to break down APK files and extracts data from Android manifests, smali code, and other resources to identify these security checks. The tool generates an easy-to-understand HTML report, helping offensive security researchers identify root and tamper detection checks in APKs for patching, hooking, and mitigating.
➡️ Getting Started
Installation
Getting started with DIS{integrity} is easy! Follow these steps:
1) Clone the repository to your local machine.
2) Install the dependencies manually or via the included requirements file using the following command:
pip install -r REQUIREMENTS.txt
3) Download APKTool for your system from their website. and make sure it's installed and available in your PATH.
DIS{integrity} has been tested on Windows 11.
Running
DIS{integrity} takes the following arguments. -apk is required.
Detect root checks in Android APK files
arguments:
-h, --help show this help message and exit
-apk APK_FILE_PATH, --apk_file_path APK_FILE_PATH the path to the APK file to analyze
-o OUTPUT_DIR, --output-dir OUTPUT_DIR the output directory to store the analysis results
--apktool APKTOOL the path to the apktool executable if not on PATH
Then run DIS{integrity} as follows. Afterwhich a HTML output file will be created.
python DISintegrity.py -apk <path to apk>
🔎 Behind The Scenes
DIS{Integrity} performs string pattern matching against symbols found in files inside of the APK. When these are matched against strings inside of SMALI files, they are listed in the output with a code block of the SMALI, while when found as a string in another (i.e. .so or .bin file), the file location is displayed. Due to this, DIS{Integrity} will not work on heavily obfuscated APKs. If you find yourself working on such an APK first try out some other tools for deobfuscation: Obfu[DE]scate, TinySmaliEmulator, simplify, and deoptfuscator.
The strings used for this matching can be seen below:
```
[("SafetyNet", "Google Play SafetyNet"), # Google Play SafetyNet API for checking device integrity
("safetynet", "Google Play SafetyNet"), # Same as above, but with lowercase
("Safety Detect", "Huawei Safety Detect"), # Huawei's safety detection API for detecting rooted devices
("safetydetect", "Huawei Safety Detect"), # Same as above, but with lowercase
("RootBeer", "RootBeer"), # RootBeer library for detecting rooted devices
("rootbeer", "RootBeer"), # Same as above, but with lowercase
("isDeviceRooted", "Proprietary"), # Custom code to check if device is rooted
("isRooted", "Proprietary"), # Same as above, but shorter
("RootChecker", "Proprietary"), # Custom code for checking if device is rooted
("checkRoot", "Proprietary"), # Same as above, but shorter
("detectRoot", "Proprietary"), # Custom code for detecting rooted devices
("detectTamper", "Proprietary"), # Custom code for detecting if app has been tampered with
("tamperDetection", "Proprietary"), # Custom code for detecting if app has been tampered with
("detectEmulator", "Proprietary"), # Custom code for detecting if app is running on an emulator
("checkEmulator", "Proprietary"), # Same as above, but shorter
("isEmulator", "Proprietary"), # Same as above, but shorter
("rootCheck", "Proprietary"), # Custom code for checking if device is rooted
("rootDetection", "Proprietary"), # Custom code for detecting rooted devices
("rootedDevice", "Proprietary"), # Custom code for checking if device is rooted
("isDeviceCompromised", "Proprietary"), # Custom code for checking if device is compromised
("rootConfirmation", "Proprietary"), # Custom code for confirming if device is rooted
("rootStatus", "Proprietary"), # Custom code for checking root status
("isDeviceJailbroken", "Proprietary"), # Custom code for checking if device is jailbroken. While jailbroken isn't often used when referring to Android. This is here as a catch all.
("jailbreakDetection", "Proprietary"), # Custom code for detecting jailbroken devices
("checkJailbreak", "Proprietary"), # Same as above, but shorter
("detectJailbreak", "Proprietary"), # Same as above, but shorter
("isDeviceSecure", "Proprietary"), # Custom code for checking device security
("deviceIntegrity", "Proprietary"), # Custom code for checking device integrity
("integrityCheck", "Proprietary"), # Custom code for checking device integrity
("systemIntegrity", "Proprietary"), # Custom code for checking system integrity
("suBinary", "Proprietary"), # Custom code for checking if su binary is installed
("superuser", "Proprietary"), # Custom code for checking if Superuser app is installed
("magisk", "Magisk"), # Magisk root management tool
("MagiskHide", "Magisk"), # Magisk feature for hiding root from apps
("magiskhide", "Magisk"), # Magisk feature for hiding root from apps
("deviceRootStatus", "Proprietary"), # Custom code for checking device root status
("rootScanner", "Proprietary"), # Custom code for scanning device for root
("rootAnalyzer", "Proprietary"), # Custom code for analyzing device for root
("rootAssessment", "Proprietary"), # Custom code for assessing device for root
("rootGuard", "Proprietary"), # Custom code for guarding against root access
("rootValidator", "Proprietary"), # Custom code for validating root status
("jailbreakStatus", "Proprietary"), # Custom code for checking jailbreak status
("jailbreakCheck", "Proprietary"), # Custom code for checking if device is jailbroken
("jailbreakScanner", "Proprietary"), # Custom code for scanning device for jailbreak
("jailbreakGuard", "Proprietary"), # Custom code for guarding against jailbreak
("isRootPresent", "Proprietary"), # Custom code for checking if root is present
("rootPresence", "Proprietary"), # Custom code for checking root presence
("rootVerifier", "Proprietary"), # Custom code for verifying root status
("jailbreakVerifier", "Proprietary"), # Custom code for verifying jailbreak status
("rootRisk", "Proprietary"), # Custom code for assessing risk of root access
("jailbreakRisk", "Proprietary"), # Custom code for assessing risk of jailbreak
("rootProber", "Proprietary"), # Custom code for probing device for root
("rootTest", "Proprietary"), # Custom code for testing if device is rooted
("jailbreakTest", "Proprietary"), # Custom code for testing if device is jailbroken
("rootDetectionCheck", "Proprietary"), # Custom code for checking if root is detected
("rootcloak", "Proprietary"), # Custom code for cloaking root from apps
("rootcloakplus", "Proprietary"), # Custom code for cloaking root from apps
("daemonsu", "Proprietary"), # Custom code for managing su binary
("jailbreakDetectionCheck", "Proprietary"), # Custom code for checking if jailbreak is detected
]
```
🙏 Contributions
DIS{integrity} is an open-source project and welcomes contributions from the community. If you would like to contribute to DIS{integrity}, please follow these guidelines:
- Fork the repository to your own GitHub account.
- Create a new branch with a descriptive name for your contribution.
- Make your changes and test them thoroughly.
- Submit a pull request to the main repository, including a detailed description of your changes and any relevant documentation.
- Wait for feedback from the maintainers and address any comments or suggestions (if any).
- Once your changes have been reviewed and approved, they will be merged into the main repository.
⚖️ Code of Conduct
DIS{integrity} follows the Contributor Covenant Code of Conduct. Please make sure to review. and adhere to this code of conduct when contributing to DIS{integrity}.
🐛 Bug Reports and Feature Requests
If you encounter a bug or have a suggestion for a new feature, please open an issue in the GitHub repository. Please provide as much detail as possible, including steps to reproduce the issue or a clear description of the proposed feature. Your feedback is valuable and will help improve DIS{integrity} for everyone.
💛 Thanks
This tool wouldn't work without APKTool!
📜 License
GNU General Public License v3.0