Zum Hauptinhalt springen
@capgo/capacitor-is-root Authentifizierung & Sicherheit Open Source

Ist Root Capacitor Plugin

Rooted Android- oder jailbroken iOS-Geräte erkennen, um die App-Sicherheit zu erhöhen

Installieren

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

Anleitung

Is Root in Capacitor nutzen

Auf dem Gerät testen

Lade die Capgo App herunter und scanne den QR code.

QR-Link zur Is Root Plugin-Vorschau code

Mit @capgo/capacitor-is-root

Capacitor ist das Is Root Plugin zum Erkennen von gerooteten (Android) oder gejailbreakten (iOS) Geräten.

Installieren

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

bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.

Importieren

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

API auf einen Blick

Methode Beschreibung
isRooted Führt die Standard-Checks zur Root-/Jailbreak-Erkennung durch.
isRootedWithBusyBox Erweitert die Standard-Erkennung um BusyBox-spezifische Checks (nur Android).
detectRootManagementApps Erkennt, ob bekannte Root-Management-Apps installiert sind (nur Android).
detectPotentiallyDangerousApps Erkennt potenziell gefährliche Apps, die häufig auf gerooteten Geräten vorkommen (nur Android).
detectTestKeys Erkennt Debug-/Test-Build-Tags (nur Android).
checkForBusyBoxBinary Prüft, ob eine BusyBox-Binary auf dem Gerät existiert (nur Android).
checkForSuBinary Prüft, ob eine su Binary vorhanden ist (nur Android).
checkSuExists Erkennt, ob die su Binary ausgeführt werden kann (nur Android).
checkForRWPaths Erkennt systemweite beschreibbare Pfade (nur Android).
checkForDangerousProps Erkennt gefährliche Systemeigenschaften (nur Android).
checkForRootNative Führt RootBeer native Checks aus (nur Android).
detectRootCloakingApps Erkennt Apps, die Root verbergen können (nur Android).
isSelinuxFlagInEnabled Prüft den SELinux Enforcement-Status (nur Android).
isExistBuildTags Erkennt Test-Build-Tags auf dem OS-Image (nur Android).
doesSuperuserApkExist Erkennt installierte Superuser-APKs (nur Android).
isExistSUPath Prüft auf bekannte su Binary-Locations (nur Android).
checkDirPermissions Erkennt beschreibbare Verzeichnisse, die geschützt sein sollten (nur Android).
checkExecutingCommands Führt which su Shell-Commands zur Root-Erkennung aus (nur Android).
checkInstalledPackages Erkennt verdächtige installierte Pakete (nur Android).
checkforOverTheAirCertificates Erkennt manipulierte OTA-Zertifikate (nur Android).
isRunningOnEmulator Erkennt gängige Emulator-Fingerprints (nur Android).
simpleCheckEmulator Führt einen leichtgewichtigen Emulator-Check durch (nur Android).
simpleCheckSDKBF86 Erkennt x86-Emulator-Fingerprints (nur Android).
simpleCheckQRREFPH Erkennt QC-Referenz-Phone-Builds (nur Android).
simpleCheckBuild Erkennt Anomalien beim Build-Host (nur Android).
checkGenymotion Erkennt Genymotion-Emulator-Fingerprints (nur Android).
checkGeneric Erkennt generische Emulator-Fingerprints (nur Android).
checkGoogleSDK Erkennt Google SDK Emulator-Fingerprints (nur Android).
togetDeviceInfo Gibt die während der Erkennung gesammelten Geräteinfos zurück.
isRootedWithEmulator Erweitert die Standard-Erkennung um Emulator-Heuristiken (nur Android).
isRootedWithBusyBoxWithEmulator Erweitert die BusyBox-Erkennung um Emulator-Heuristiken (nur Android).

Beispiele

isRooted()

Führt die Standard-Checks zur Root-/Jailbreak-Erkennung durch.

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

Erweitert die Standard-Erkennung um BusyBox-spezifische Checks (nur Android).

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

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

detectRootManagementApps()

Erkennt, ob bekannte Root-Management-Apps installiert sind (nur Android).

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

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

detectPotentiallyDangerousApps()

Erkennt potenziell gefährliche Apps, die häufig auf gerooteten Geräten vorkommen (nur Android).

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

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

detectTestKeys()

Erkennt Debug-/Test-Build-Tags (nur Android).

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

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

checkForBusyBoxBinary()

Prüft, ob eine BusyBox-Binary auf dem Gerät existiert (nur Android).

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

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

Die obige Tabelle listet die 31 Core-Methoden auf. Listener- und Version-Helper sowie der vollständige Contract jeder Methode sind in der GitHub Repository.

Vollständige Referenz

Weiter mit der Nutzung von @capgo/capacitor-is-root

Wenn du es nutzt Nutzung von @capgo/capacitor-is-root Um die Arbeit an nativen Plugins zu planen, verbinde sie mit @capgo/capacitor-is-root für die Implementierungsdetails in @capgo/capacitor-is-root, Erste Schritte für die Implementierungsdetails in Erste Schritte, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, und Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren.

FAQ

Is Root Plugin FAQ

Wie installiere ich das Is Root Plugin in einer Capacitor App?

Führe "bun add @capgo/capacitor-is-root" (oder "npm install @capgo/capacitor-is-root") aus und danach "bunx cap sync", damit die iOS- und Android-Projekte die nativen code übernehmen. Importiere es in deiner App code aus "@capgo/capacitor-is-root".

Funktioniert @capgo/capacitor-is-root mit React, Vue und Angular?

Ja. Is Root ist ein Capacitor Package und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Capacitor Version wird von @capgo/capacitor-is-root unterstützt?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-is-root kostenlos und Open Source?

Ja. Der code Code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-is-root/ einsehbar und das Package kann kostenlos via npm installiert werden. Bug-Reports und Pull Requests sind willkommen.

Kann ich code mit Is Root aktualisieren, ohne ein App Store Review abzuwarten?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

Veröffentliche Is Root Änderungen, ohne auf den App Review zu warten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo