@capgo/capacitor-is-root

Aperçu

The Capacitor Is Root plugin provides comprehensive root and jailbreak detection for Android Appareils and emulator detection. This plugin helps enhance Application Sécurité by identifying compromised Appareils and emulated environments that may pose Sécurité risks.

Root detection

Advanced Android root detection with multiple methods 🔒

Emulator detection

Identify emulated environments and Test frameworks 🛡️

Security validation

Multiple detection techniques for enhanced accuracy ✅

Android focused

Specialized detection for Android Sécurité assessment 🤖

Installation

npm install @capgo/capacitor-is-root
npx cap sync

Core API Methods

Root Detection

• isRooted() - Performs comprehensive root detection using default methods
• isRootedWithBusyBox() - Extended detection including BusyBox checks
• detectRootManagementApps() - Identifies installed root management applications
• checkForSuBinary() - Checks for su binary presence in system paths

Emulator Detection

• isRunningOnEmulator() - Detects common Android emulator fingerprints

Detection Techniques

The plugin employs multiple detection methods:

Root Detection

• Checks for root management applications (SuperSU, Magisk, etc.)
• Scans for suspicious system properties
• Identifies Test Construction tags and Débogage flags
• Validates dangerous binary locations
• Examines system path permissions

Emulator Detection

• Hardware fingerprint analysis
• Construction property inspection
• Emulator-specific characteristics
• Virtual environment indicators

Utilisation Exemple

import { IsRoot } from '@capgo/capacitor-is-root';

// Basic root detection
const rootResult = await IsRoot.isRooted();
if (rootResult.isRooted) {
  console.log('Device is rooted');
  // Handle rooted device appropriately
}

// Extended root detection with BusyBox
const extendedResult = await IsRoot.isRootedWithBusyBox();
if (extendedResult.isRooted) {
  console.log('Device is rooted (extended check)');
}

// Check for emulator
const emulatorResult = await IsRoot.isRunningOnEmulator();
if (emulatorResult.isEmulator) {
  console.log('Running on emulator');
}

// Detect root management apps
const rootAppsResult = await IsRoot.detectRootManagementApps();
if (rootAppsResult.hasRootApps) {
  console.log('Root management apps detected');
}

Sécurité Considerations

• Use multiple detection methods for higher accuracy
• Implement graceful degradation for detected environments
• Consider Utilisateur privacy when implementing Sécurité measures
• Regular Mises à jour recommended as detection methods evolve

Documentation

Vérifier the Terminé Documentation for detailed implementation guides and advanced Sécurité patterns.