@capgo/capacitor-is-root

Aperçu

Le plugin Capacitor Is Root fournit une détection complète de root et de jailbreak pour les appareils Android et une détection d’émulateur. Ce plugin contribue à améliorer la sécurité des applications en identifiant les appareils compromis et les environnements émulés qui peuvent présenter des risques de sécurité.

Détection de racine

Détection avancée de racine Android avec plusieurs méthodes 🔒

Détection d'émulateur

Identifiez les environnements émulés et les frameworks de test 🛡️

Validation de sécurité

Plusieurs techniques de détection pour une précision accrue ✅

Android concentré

Détection spécialisée pour l’évaluation de sécurité Android 🤖

##Installation

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

Méthodes principales API

Détection de racine

• isRooted() - Effectue une détection complète des racines à l’aide des méthodes par défaut
• isRootedWithBusyBox() - Détection étendue incluant les contrôles BusyBox
• detectRootManagementApps() - Identifie les applications de gestion racine installées
• checkForSuBinary() - Vérifie la présence binaire su dans les chemins système

Détection de l’émulateur

• isRunningOnEmulator() - Détecte les empreintes digitales courantes de l’émulateur Android

Techniques de détection

Le plugin utilise plusieurs méthodes de détection :

Détection de racine

• Vérifie les applications de gestion racine (SuperSU, Magisk, etc.)
• Analyse les propriétés système suspectes
• Identifie les balises de build de test et les indicateurs de débogage
• Valide les emplacements binaires dangereux
• Examine les autorisations de chemin du système

Détection de l’émulateur

• Analyse des empreintes matérielles
• Inspection de la propriété du bâtiment
• Caractéristiques spécifiques à l’émulateur
• Indicateurs d’environnement virtuel

Exemple d’utilisation

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');
}

Considérations de sécurité

• Utilisez plusieurs méthodes de détection pour une plus grande précision
• Implémenter une dégradation gracieuse pour les environnements détectés
• Tenir compte de la confidentialité des utilisateurs lors de la mise en œuvre de mesures de sécurité
• Mises à jour régulières recommandées à mesure que les méthodes de détection évoluent

##Documents

Consultez la documentation complète pour obtenir des guides de mise en œuvre détaillés et des modèles de sécurité avancés.