メインコンテンツへスキップ
@capgo/capacitor-is-root 認証とセキュリティ オープンソース

Root 判定 Capacitor プラグイン

Android の Root 化や iOS の脱獄を検出し、アプリのセキュリティを強化します

インストール

bun add @capgo/capacitor-is-root bunx cap sync
npm、pnpm、または yarn
  • npm install @capgo/capacitor-is-root
  • pnpm add @capgo/capacitor-is-root
  • yarn add @capgo/capacitor-is-root

ガイド

Capacitor で Is Root を使う方法

実機でテストする

Capgo アプリをダウンロードして、QR code をスキャンしてください。

Is Root プラグインのプレビューQR code

@capgo/capacitor-is-root の使用

Capacitor は、root化されたAndroidデバイスや脱獄されたiOSデバイスを検出するIs Rootプラグインです。

インストール

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

bunx cap sync プラグインのネイティブcodeをネイティブプロジェクトにコピーします。プラグインをアップグレードするたびに再度実行してください。

インポート

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

API の概要

メソッド 説明
isRooted デフォルトのルート/脱獄検知チェックを実行します。
isRootedWithBusyBox デフォルトの検知をBusyBox固有のチェックで拡張します(Androidのみ)。
detectRootManagementApps 既知のルート管理アプリが存在するか検出します(Android のみ)。
detectPotentiallyDangerousApps ルート済みデバイスに存在する可能性のある危険なアプリを検出します(Android のみ)。
detectTestKeys デバッグ/テストビルドタグを検出します(Android のみ)。
checkForBusyBoxBinary デバイスに BusyBox バイナリが存在するか確認します(Android のみ)。
checkForSuBinary が su バイナリが存在するか確認します(Android のみ)。
checkSuExists が su バイナリが実行可能かどうかを確認します(Android のみ)。
checkForRWPaths 全ユーザーが書き込み可能なシステムパスを検出します(Android のみ)。
checkForDangerousProps 危険なシステムプロパティを検出します(Android のみ)。
checkForRootNative RootBeer のネイティブチェックを実行します(Android のみ)。
detectRootCloakingApps root を隠蔽できるアプリを検出します(Android のみ)。
isSelinuxFlagInEnabled SELinux の強制状態を確認します(Android のみ)。
isExistBuildTags OS イメージのテストビルドタグを検出します(Android のみ)。
doesSuperuserApkExist スーパーユーザー APK がインストールされているか検出します(Android のみ)。
isExistSUPath 既知の su バイナリの配置場所を確認します(Android のみ)。
checkDirPermissions 保護対象の書き込み可能ディレクトリを検出します(Android のみ)。
checkExecutingCommands 実行します which su style コマンドで root 化を検知します(Android のみ)。
checkInstalledPackages 不審なインストール済みパッケージを検知します(Android のみ)。
checkforOverTheAirCertificates 改ざんされた OTA 証明書を検知します(Android のみ)。
isRunningOnEmulator 一般的なエミュレータのフィンガープリントを検知します(Android のみ)。
simpleCheckEmulator 軽量なエミュレータチェックを実行します(Androidのみ)。
simpleCheckSDKBF86 x86エミュレータのフィンガープリントを検出します(Androidのみ)。
simpleCheckQRREFPH QCリファレンス端末のビルドを検出します(Androidのみ)。
simpleCheckBuild ビルドホストの異常を検出します(Androidのみ)。
checkGenymotion Genymotion エミュレータのフィンガープリントを検出します(Android のみ)。
checkGeneric 一般的なエミュレータのフィンガープリントを検出します(Android のみ)。
checkGoogleSDK Google SDK エミュレータのフィンガープリントを検出します(Android のみ)。
togetDeviceInfo 検出時に収集されたデバイス情報を返します。
isRootedWithEmulator エミュレータのヒューリスティックでデフォルトの検知を拡張します(Androidのみ)。
isRootedWithBusyBoxWithEmulator BusyBox検知をエミュレータのヒューリスティックで拡張します(Androidのみ)。

例

isRooted()

デフォルトのルート/脱獄検知チェックを実行します。

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

デフォルトの検知をBusyBox固有のチェックで拡張します(Androidのみ)。

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

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

detectRootManagementApps()

既知のルート管理アプリが存在するか検出します(Android のみ)。

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

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

detectPotentiallyDangerousApps()

ルート化されたデバイスでよく見られる、危険な可能性があるアプリを検出します(Android のみ)。

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

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

detectTestKeys()

デバッグ/テストビルドタグを検出します(Android のみ)。

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

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

checkForBusyBoxBinary()

デバイス上に BusyBox バイナリが存在するか確認します(Android のみ)。

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

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

上記の表には 31 個のコアメソッドが記載されています。リスナーとバージョンヘルパー、各メソッドの完全な仕様については、 GitHub リポジトリ.

完全なリファレンス

「@capgo/capacitor-is-root の使用」から続ける

使用している場合 @capgo/capacitor-is-root の使用 ネイティブプラグインの作業を計画するには、次と連携してください: @capgo/capacitor-is-root @capgo/capacitor-is-root の実装詳細については、 スタートガイド スタートガイドの実装詳細については、 Capgo プラグインディレクトリ Capgo プラグインディレクトリのプロダクトワークフローについては、 Capgo による Capacitor プラグイン Capgo による Capacitor Plugins の実装詳細、および プラグインの追加または更新 プラグインの追加または更新に関する実装詳細についてはこちら。

よくある質問

Is Root プラグイン FAQ

Capacitor アプリに Is Root プラグインをインストールするには?

「bun add @capgo/capacitor-is-root」(または「npm install @capgo/capacitor-is-root」)を実行し、次に「bunx cap sync」を実行して、iOS と Android プロジェクトがネイティブ code を認識するようにします。アプリの code から「@capgo/capacitor-is-root」をインポートします。

@capgo/capacitor-is-root は React、Vue、Angular で動作しますか?

はい。Is Root は Capacitor パッケージであるため、Ionic、React、Vue、Angular、Svelte、プレーン JavaScript を含む、Capacitor 内で動作するすべての Web フレームワークで動作します。

@capgo/capacitor-is-root はどの Capacitor バージョンをサポートしていますか?

Capgo プラグインは Capacitor のメジャーバージョンに合わせています。使用している Capacitor のメジャーバージョンに一致するプラグインのメジャーバージョンを使ってください (例: Capacitor 8 ならプラグイン v8)。GitHub の README にある互換性テーブルに、メンテナンス中のバージョンが記載されています。

@capgo/capacitor-is-root は無料かつオープンソースですか?

はい。ソース code は https://github.com/Cap-go/capacitor-is-root/ の GitHub で公開されており、npm から無料でインストールできます。バグ報告やプルリクエストをお待ちしています。

Is Root を使用している code を、App Store のレビューなしで更新できますか?

プラグインのインストールやアップグレードはネイティブの code を変更するため、新しいストアビルドが必要です。その後は、プラグインを呼び出す JavaScript、HTML、CSS の変更を Capgo Live Updates で即座に配信できます。

アプリの審査を待たずに Is Root の変更をリリース

プラグインをストア用ビルドに組み込めば、Capgo live updates で JavaScript、HTML、CSS の変更を数分でユーザーに配信できます

Capgo から始める