m0bilesecurity/RMS-Runtime-Mobile-Security
Runtime Mobile Security (RMS) is a powerful web interface that helps you to manipulate Android Java Classes and Methods at Runtime
repo name | m0bilesecurity/RMS-Runtime-Mobile-Security |
repo link | https://github.com/m0bilesecurity/RMS-Runtime-Mobile-Security |
homepage | https://twitter.com/mobilesecurity_ |
language | Python |
size (curr.) | 19776 kB |
stars (curr.) | 191 |
created | 2020-03-27 |
license | |
Runtime Mobile Security
Runtime Mobile Security (RMS), powered by FRIDA, is a powerful web interface that helps you to manipulate Android Java Classes and Methods at Runtime.
You can easily dump all the loaded classes and relative methods, hook everything on the fly, trace methods args and return value, load custom scripts and many other useful stuff.
General Info
Runtime Mobile Security (RMS) is currently supporting Android devices only.
It has been tested on MacOS and with the following devices:
- AVD emulator
- Genymotion emulator
- Amazon Fire Stick 4K
It should also work well on Windows and Linux but some minor adjustments may be needed.
Do not connect more than one device at the same time. RMS is not so smart at the moment 😉
Prerequisites
FRIDA server up and running on the target device
Refer to the official FRIDA guide for the installation: https://frida.re/docs/android/
Known issues
- Sometime RMS fails to load complex methods. Use a filter when this happens or feel free to improve the algo (default.js).
- Code is not optimized
Improvements
- iOS support
- Feel free to send me your best JS sript via a Pull request. I’ll be happy to bundle all the best as default scripts in the next RMS release.
e.g.
- root detection bypass
- ssl pinning bypass
- reflection detection
- etc…
Installation
- (optional) Create a python virtual environment
pip3 install -r requirements.txt
python3 mobilesecurity.py
Usage
1. Run your favorite app by simply inserting its package name
NOTE RMS attachs a persistence process called com.android.systemui to get the list of all the classes that are already loaded in memory before the launch of the target app. If you have an issue with it, try to find a different package that works well on your device. You can set another default package by simply editing the config.json file.
2. Check which Classes and Methods have been loaded in memory
3. Hook on the fly Classes/Methods and trace their args and return values
4. Select a Class and generate on the fly an Hook template for all its methods
5. Easily detect new classes that have been loaded in memory
6. Inject your favorite FRIDA CUSTOM SCRIPTS on the fly
Just add your .js files inside the custom_script folder and they will be automatically loaded by the web interface ready to be executed.
Acknowledgements
Special thanks to the following Open Source projects for the inspiration:
RootBeer Sample is the DEMO app used to show how RMS works. RootBeer is an amazing root detection library. I decided to use the Sample app as DEMO just to show that, as every client-side only check, its root detection logic can be easily bypassed if not combined with a server-side validation.
License
RMS is licensed under a GNU General Public v3 License.