https://github.com/kauemurakami/flutter_tamper_detector
[Package Flutter] Flutter Tamper Detector is a security plugin for Flutter that detects and prevents tampering. It identifies if the device is rooted, if hooking tools like Frida, Xposed, or Cydia Substrate are present, or if the device is an emulator. It can automatically close the app to protect integrity and security.
https://github.com/kauemurakami/flutter_tamper_detector
cydia dart flutter flutter-hooks flutter-package flutter-platform-channel flutter-root flutter-security frida kotlin platform-channels security security-app xposed
Last synced: 3 months ago
JSON representation
[Package Flutter] Flutter Tamper Detector is a security plugin for Flutter that detects and prevents tampering. It identifies if the device is rooted, if hooking tools like Frida, Xposed, or Cydia Substrate are present, or if the device is an emulator. It can automatically close the app to protect integrity and security.
- Host: GitHub
- URL: https://github.com/kauemurakami/flutter_tamper_detector
- Owner: kauemurakami
- License: mit
- Created: 2025-03-11T17:18:30.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-03-11T21:53:53.000Z (3 months ago)
- Last Synced: 2025-03-11T22:25:12.225Z (3 months ago)
- Topics: cydia, dart, flutter, flutter-hooks, flutter-package, flutter-platform-channel, flutter-root, flutter-security, frida, kotlin, platform-channels, security, security-app, xposed
- Language: Kotlin
- Homepage:
- Size: 24.4 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/kauemurakami/flutter_tamper_detector)
# flutter_tamper_detector
flutter_tamper_detector is a Flutter security plugin designed to detect and prevent application tampering. It checks if the device is rooted, if tools like Frida, Xposed, or Cydia Substrate are being used, or if the app is running on an emulator. With this information, you can implement security measures in your Flutter app, such as terminating the application or blocking execution.
## Getting Started
```
$ flutter pub add flutter_tamper_detector
```
or add in your dependencies
```
dependencies:
flutter_tamper_detector:
```
## Usage
Simple and easy to use!
```dart
import 'package:flutter_tamper_detector/flutter_tamper_detector.dart';
```
Now just use the functions directly with our main class `FlutterTamperDetector`:
```dart
bool isEmulator = await FlutterTamperDetector.isEmulator();
bool isRooted = await FlutterTamperDetector.isRooted();
bool isHooked = await FlutterTamperDetector.isHooked();
```
Then you can make some decision in your app according to your needs, for example, the app if it is running on a rooted device.
```dart
Future checkIfRooted() async {
bool isRooted = await FlutterTamperDetector.isRooted();
if (isRooted) {
print('Device is rooted, exiting the app...');
// TODO: your logic here
} else {
print('Device is not rooted.');
}
}
```
Or, if you want to automatically terminate the app process when any of the functions are true, you can use the `exitProcessIfTrue: true` parameter.
This way, the application will terminate the process immediately without the need for a decision structure in your Flutter code.
```dart
bool isEmulator = await FlutterTamperDetector.isEmulator(exitProcessIfTrue: true);
bool isRooted = await FlutterTamperDetector.isRooted(exitProcessIfTrue: true);
bool isHooked = await FlutterTamperDetector.isHooked(exitProcessIfTrue: true);
```
See more details in the example section
## Use native
If you want to stop the process before even entering the Flutter engine, I will provide an example using the same classes here in the package for you to implement directly in the `onCreate` of our `MainActivity.kt`, this way we close the application and end the process before even entering the Flutter engine. Suggestion received via Linkedin from: *Adrian Kohls*
Acesse -> [native_tamper_detector](https://github.com/kauemurakami/native_tamper_detector)
## How test
1 - Run on a emulator
2 - Run on a device rooted (ex with [magisk](https://github.com/topjohnwu/Magisk))
3 - Run on a device that has frida on it, for example, you can test this by following the [official frida documentation](https://frida.re/docs/android/), after completing the steps described there, run the application.
Don't worry, after that you will be able to remove Frida from your device.