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

So nutzt man Is Root in Capacitor

Auf dem Gerät testen

Lade die Capgo App herunter und scanne den QR code.

Is Root Plugin-Vorschau-QR code

Mit @capgo/capacitor-is-root

Das Capacitor Is Root Plugin erkennt gerootete (Android) oder gejailbreakte (iOS) Geräte.

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 vorhanden 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 für alle beschreibbare Systempfade (nur Android).
checkForDangerousProps Erkennt gefährliche Systemeigenschaften (nur Android).
checkForRootNative Führt native RootBeer-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 im OS-Image (nur Android).
doesSuperuserApkExist Erkennt installierte Superuser-APKs (nur Android).
isExistSUPath Prüft auf bekannte su Binärpfade (nur Android).
checkDirPermissions Erkennt beschreibbare Verzeichnisse, die geschützt werden sollten (nur Android).
checkExecutingCommands Führt which su entsprechende Befehle aus, um Root zu erkennen (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 vorhanden 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 Kernmethoden 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

FAQ zum Is Root Plugin

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 code-App 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 unterstützt @capgo/capacitor-is-root?

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?

Der code-Code ist auf GitHub unter https://github.com/Cap-go/capacitor-is-root/ öffentlich einsehbar, und das Package lässt sich kostenlos über npm installieren. Bug-Reports und Pull Requests sind willkommen.

Kann ich code, das Is Root verwendet, ohne App Store Review aktualisieren?

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