Saltar al contenido principal
@capgo/capacitor-is-root Auth y Seguridad Código abierto

¿Es Root? plugin Capacitor

Detecta dispositivos Android con root o iOS con jailbreak para mejorar la seguridad

Instalar

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

Guía

Cómo usar Is Root en Capacitor

Probar en el dispositivo

Descarga la app Capgo y escanea el QR code.

Vista previa del plugin Is Root por QR code

Usando @capgo/capacitor-is-root

Capacitor es el plugin Is Root para detectar dispositivos con root (Android) o jailbreak (iOS).

Instalar

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

bunx cap sync copia el code nativo del plugin en tus proyectos nativos. Ejecútalo de nuevo tras cada actualización del plugin.

Importar

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

API de un vistazo

Método Descripción
isRooted Realiza las comprobaciones de root/jailbreak por defecto.
isRootedWithBusyBox Extiende la detección con checks específicos de BusyBox (solo Android).
detectRootManagementApps Detecta si hay apps de gestión de root conocidas (solo Android).
detectPotentiallyDangerousApps Detecta apps potencialmente peligrosas en dispositivos con root (solo Android).
detectTestKeys Detecta tags de build de debug/test (solo Android).
checkForBusyBoxBinary Comprueba si existe un binario de BusyBox en el dispositivo (solo Android).
checkForSuBinary Comprueba si un su binario está presente (solo Android).
checkSuExists Detecta si el su binario se puede ejecutar (solo Android).
checkForRWPaths Detecta rutas del sistema con permisos de escritura global (solo Android).
checkForDangerousProps Detecta propiedades del sistema peligrosas (solo Android).
checkForRootNative Ejecuta comprobaciones nativas de RootBeer (solo Android).
detectRootCloakingApps Detecta aplicaciones que pueden ocultar el root (solo Android).
isSelinuxFlagInEnabled Comprueba el estado de SELinux enforcement (solo Android).
isExistBuildTags Detecta etiquetas de build de prueba en la imagen del OS (solo Android).
doesSuperuserApkExist Detecta si hay APKs de superusuario instalados (solo Android).
isExistSUPath Busca ubicaciones de su binarios conocidos (solo Android).
checkDirPermissions Detecta directorios con permisos de escritura que deberían estar protegidos (solo Android).
checkExecutingCommands Ejecuta which su comandos de shell para detectar root (solo Android).
checkInstalledPackages Detecta paquetes instalados sospechosos (solo Android).
checkforOverTheAirCertificates Detecta certificados OTA manipulados (solo Android).
isRunningOnEmulator Detecta huellas de emuladores comunes (solo Android).
simpleCheckEmulator Realiza un chequeo ligero de emuladores (solo Android).
simpleCheckSDKBF86 Detecta huellas de emuladores x86 (solo Android).
simpleCheckQRREFPH Detecta builds de teléfonos de referencia QC (solo Android).
simpleCheckBuild Detecta anomalías en el host de build (solo Android).
checkGenymotion Detecta huellas de emuladores Genymotion (solo Android).
checkGeneric Detecta huellas de emuladores genéricos (solo Android).
checkGoogleSDK Detecta huellas de emuladores Google SDK (solo Android).
togetDeviceInfo Devuelve la info del dispositivo recogida al detectar.
isRootedWithEmulator Extiende la detección por defecto con heurística de emuladores (solo Android).
isRootedWithBusyBoxWithEmulator Extiende la detección de BusyBox con heurística de emuladores (solo Android).

Ejemplos

isRooted()

Realiza las comprobaciones de root/jailbreak por defecto.

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()

Extiende la detección con checks específicos de BusyBox (solo Android).

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

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

detectRootManagementApps()

Detecta si hay aplicaciones de gestión de root conocidas (solo Android).

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

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

detectPotentiallyDangerousApps()

Detecta apps potencialmente peligrosas comunes en dispositivos con root (solo Android).

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

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

detectTestKeys()

Detecta tags de build de debug/test (solo Android).

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

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

checkForBusyBoxBinary()

Comprueba si existe un binario de BusyBox en el dispositivo (solo Android).

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

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

La tabla anterior lista los 31 métodos principales. Los helpers de Listener y versión, y el contrato completo de cada método, están documentados en la repositorio GitHub.

Referencia completa

Continuar desde Uso de @capgo/capacitor-is-root

Si estás usando Uso de @capgo/capacitor-is-root para planificar el trabajo con plugins nativos, conéctalo con @capgo/capacitor-is-root para los detalles de implementación en @capgo/capacitor-is-root, Primeros pasos para los detalles de implementación en Primeros pasos, Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para los detalles de implementación en Capacitor Plugins de Capgo, y Añadir o actualizar plugins para los detalles de implementación al añadir o actualizar plugins.

FAQ

FAQ del plugin Is Root

¿Cómo instalo el plugin Is Root en una app Capacitor?

Ejecuta "bun add @capgo/capacitor-is-root" (o "npm install @capgo/capacitor-is-root"), luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android reconozcan el code nativo. Impórtalo desde "@capgo/capacitor-is-root" en el code de tu app.

¿Es compatible @capgo/capacitor-is-root con React, Vue y Angular?

Sí. Is Root es un paquete Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor es compatible con @capgo/capacitor-is-root?

Los plugins de Capgo siguen la versión mayor de Capacitor: usa la versión mayor del plugin que coincida con la versión mayor de tu Capacitor (por ejemplo, el plugin v8 con Capacitor 8). La tabla de compatibilidad del README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-is-root gratuito y de código abierto?

Sí. El código fuente de code es público en GitHub en https://github.com/Cap-go/capacitor-is-root/ y el paquete es gratuito para instalar desde npm. Los reportes de bugs y pull requests son bienvenidos.

¿Puedo actualizar code que usa Is Root sin pasar por la revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Lanza cambios de Is Root sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo