Passer à la navigation principale
@capgo/capacitor-est-racine Auth & Sécurité Open source

Is Root plugin Capacitor

Détecter les appareils Android rootés ou iOS jailbreakés pour améliorer la sécurité de l'application

Installer

bun add @capgo/capacitor-is-root bunx cap sync
npm, pnpm ou yarn
  • npm install @capgo/capacitor-is-root
  • pnpm add @capgo/capacitor-is-root
  • yarn add @capgo/capacitor-is-root

Guide

How to use Is Root dans Capacitor

Test sur appareil

Téléchargez l'application Capgo, puis scannez le QR code.

Prévisualisation du QR code du plugin Is Root

Utilisation de @capgo/capacitor-is-root

Plugin Is Root de Capacitor pour détecter les appareils rootés (Android) ou jailbreakés (iOS).

Installer

bun add @capgo/capacitor-is-root
bunx cap sync

bunx cap sync copie le code natif du plugin dans vos projets natifs. Exécutez-l’à nouveau après chaque mise à jour du plugin.

Importer

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

API en un coup d'œil

Méthode Description
isRooted Exécute les vérifications de détection par défaut.
isRootedWithBusyBox Étend la détection par défaut avec des vérifications spécifiques à BusyBox (seulement Android).
detectRootManagementApps Détermine si des applications de gestion de root connues sont présentes (seulement Android).
detectPotentiallyDangerousApps Détermine les applications potentiellement dangereuses couramment trouvées sur des appareils rootés (seulement Android).
detectTestKeys Détection de balises de build de débogage/test (seulement Android).
checkForBusyBoxBinary Vérifie si un fichier BusyBox existe sur le dispositif (seulement Android).
checkForSuBinary Vérifie si un su Un binaire est présent (seulement sur Android).
checkSuExists Détermine si le su Un binaire peut être exécuté (seulement sur Android).
checkForRWPaths Détermine les chemins système mondialement accessibles (seulement Android).
checkForDangerousProps Détermine les propriétés système dangereuses (seulement sur Android).
checkForRootNative Exécute les vérifications natives de RootBeer (seulement sur Android).
detectRootCloakingApps Détermine les applications qui peuvent cacher la racine (seulement sur Android).
isSelinuxFlagInEnabled Vérifie l'état d'exécution de SELinux (seulement Android).
isExistBuildTags Détection de balises de build de test sur l'image d'OS (seulement Android).
doesSuperuserApkExist Détermine si des APK superutilisateur sont installés (seulement sur Android).
isExistSUPath Vérifie les emplacements su Un binaire (seulement sur Android).
checkDirPermissions Détecte les répertoires écritures qui doivent être protégés (seulement Android).
checkExecutingCommands Executes which su Détecte les packages d'installation suspects (seulement Android).
checkInstalledPackages Détecte les certificats OTA altérés (seulement Android).
checkforOverTheAirCertificates Détection de certificats OTA altérés (seulement Android).
isRunningOnEmulator Effectue une vérification d'émulateur légère (seulement Android).
simpleCheckEmulator Détecte les empreintes digitales des émulateurs x86 (seulement Android).
simpleCheckSDKBF86 Détection des empreintes de simulateurs x86 (seulement Android).
simpleCheckQRREFPH Détecte les anomalies de l'hôte de build (seulement Android).
simpleCheckBuild Detects build host anomalies (Android only).
checkGenymotion Détecte les empreintes digitales des émulateurs génériques (seulement Android).
checkGeneric Détecte les empreintes digitales des émulateurs Android (seulement Android).
checkGoogleSDK Détection des empreintes de simulateur Google SDK (seulement Android).
togetDeviceInfo Renvoie les informations de l'appareil collectées lors de la détection.
isRootedWithEmulator Étend la détection par défaut avec des heuristiques de simulateur (seulement Android).
isRootedWithBusyBoxWithEmulator Étend la détection de BusyBox avec des heuristiques de simulateur (seulement Android).

Exemples

isRooted()

Effectue les vérifications de détection par défaut de root/jailbreak.

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

const { result } = await IsRoot.isRooted();
if (result) {
  console.log('Device is rooted/jailbroken');
} else {
  console.log('Device is not rooted/jailbroken');
}

isRootedWithBusyBox()

Étend la détection par défaut avec des vérifications spécifiques à BusyBox (seulement Android).

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

const result = await IsRoot.isRootedWithBusyBox();
console.log(result);

detectRootManagementApps()

Détection de l'existence d'applications de gestion de racine connues (seulement Android).

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

const result = await IsRoot.detectRootManagementApps();
console.log(result);

detectPotentiallyDangerousApps()

Détection d'applications potentiellement dangereuses couramment trouvées sur des appareils rootés (seulement Android).

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

const result = await IsRoot.detectPotentiallyDangerousApps();
console.log(result);

detectTestKeys()

Détection de balises de build de débogage/test (seulement Android).

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

const result = await IsRoot.detectTestKeys();
console.log(result);

checkForBusyBoxBinary()

Vérifie si un fichier BusyBox existe sur l'appareil (seulement Android).

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

const result = await IsRoot.checkForBusyBoxBinary();
console.log(result);

La table ci-dessus liste les 31 méthodes de base. Les aides aux écouteurs et aux versions, ainsi que la pleine convention de chaque méthode, sont documentés dans le GitHub dépôt.

Référence complète

Continuez à partir de l'utilisation de @capgo/capacitor-is-root

Si vous utilisez L'utilisation de @capgo/capacitor-is-root pour planifier le travail du plugin natif, connectez-l’avec @capgo/capacitor-is-root pour les détails d'implémentation dans @capgo/capacitor-is-root Prise en main Dans le détail de l'implémentation dans Getting Started, Répertoire de plugin Capgo Dans le flux de travail du produit dans Capgo Répertoire de plugin, Capacitor Plugins par Capgo Dans le détail de l'implémentation dans Capacitor Plugins par Capgo, et Ajouter ou Mettre à Jour les Plugins Pour les détails d'implémentation dans l'ajout ou la mise à jour d'extensions.

FAQ

FAQ du plugin Is Root

Comment installez-vous le plugin Is Root dans une application Capacitor?

Exécutez « bun add @capgo/capacitor-is-root » (ou « npm install @capgo/capacitor-is-root »), puis exécutez « bunx cap sync » afin que les projets iOS et Android prennent en charge le code natif. Importez-l’à partir de « @capgo/capacitor-is-root » dans votre application code.

Le plugin @capgo/capacitor-is-root fonctionne-t-il avec React, Vue et Angular?

Oui. Is Root est un paquet Capacitor, il fonctionne donc avec tout framework web qui s'exécute à l'intérieur de Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript simple.

Quelle version de Capacitor est prise en charge par @capgo/capacitor-is-root?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple, plugin v8 avec Capacitor 8). La table de compatibilité dans le README du GitHub liste les versions maintenues.

Est-ce que @capgo/capacitor-is-root est gratuit et open source ?

Oui. La source code est publique sur GitHub à https://github.com/Cap-go/capacitor-is-root/ et le package est gratuit pour l'installation depuis npm. Les rapports de bogues et les demandes de tirage sont les bienvenus.

Puis-je mettre à jour code sans passer par une revue de l'App Store ?

L'installation ou la mise à niveau du plugin modifie la native code, elle nécessite donc une nouvelle construction de l'application. Après cela, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être envoyées instantanément avec les mises à jour Capgo.

Envoyer les modifications de Is Root sans attendre la revue de l'application

Une fois le plugin est dans votre magasin de build, les mises à jour en direct Capgo poussent vos modifications de JavaScript, HTML et CSS vers les utilisateurs en minutes.

Démarrer avec Capgo