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 QR del plugin Is Root code

Uso de @capgo/capacitor-is-root

El plugin Capacitor Is Root sirve 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 detección de root/jailbreak por defecto.
isRootedWithBusyBox Extiende la detección por defecto con comprobaciones específicas de BusyBox (solo Android).
detectRootManagementApps Detecta si hay aplicaciones de gestión de root conocidas (solo Android).
detectPotentiallyDangerousApps Detecta aplicaciones potencialmente peligrosas habituales en dispositivos con root (solo Android).
detectTestKeys Detecta etiquetas de build de debug/test (solo Android).
checkForBusyBoxBinary Comprueba si existe un binario de BusyBox en el dispositivo (solo Android).
checkForSuBinary Comprueba si existe un su el binario está presente (solo Android).
checkSuExists Detecta si el su binario se puede ejecutar (solo Android).
checkForRWPaths Detects world writable system paths (Android only).
checkForDangerousProps Detecta propiedades peligrosas del sistema (solo Android).
checkForRootNative Ejecuta comprobaciones nativas de RootBeer (solo Android).
detectRootCloakingApps Detecta aplicaciones que pueden ocultar el root (solo Android).
isSelinuxFlagInEnabled Comprueba si SELinux está en modo enforcing (solo Android).
isExistBuildTags Detecta etiquetas de build de prueba en la imagen del SO (solo Android).
doesSuperuserApkExist Detecta si hay APKs de superusuario instaladas (solo Android).
isExistSUPath Busca ubicaciones de su binarios conocidos (solo Android).
checkDirPermissions Detecta directorios escribibles que deberían protegerse (solo Android).
checkExecutingCommands Ejecuta which su Comandos de estilo 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 del emulador Genymotion (solo Android).
checkGeneric Detecta huellas de emuladores genéricos (solo Android).
checkGoogleSDK Detecta huellas del emulador de Google SDK (solo Android).
togetDeviceInfo Devuelve la información del dispositivo recopilada durante la detección.
isRootedWithEmulator Extiende la detección por defecto con heurísticas de emuladores (solo Android).
isRootedWithBusyBoxWithEmulator Extiende la detección de BusyBox con heurísticas de emuladores (solo Android).

Ejemplos

isRooted()

Realiza las comprobaciones de detección 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 por defecto con comprobaciones específicas 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 aplicaciones potencialmente peligrosas habituales en dispositivos con root (solo Android).

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

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

detectTestKeys()

Detecta etiquetas 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 recoge los 31 métodos principales. Los helpers de listener y de versión, y el contrato completo de cada método, están documentados en la repositorio GitHub.

Referencia completa

Continuar desde Usando @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 el detalle de la 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

Preguntas frecuentes del plugin Is Root

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

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

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

Sí. Is Root es un paquete de 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 soporta @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 code está publicado en GitHub en https://github.com/Cap-go/capacitor-is-root/ y el paquete se puede instalar gratis desde npm. Se aceptan informes de errores y pull requests.

¿Puedo actualizar code que usa Is Root sin una 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.

Publica 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