@capgo/capacitor-is-root

Ringkasan

Plugin Capacitor Is Root menyediakan deteksi root dan jailbreak yang komprehensif untuk perangkat Android dan deteksi emulator. Plugin ini membantu meningkatkan keamanan aplikasi dengan mengidentifikasi perangkat yang disusupi dan lingkungan teremulasi yang mungkin menimbulkan risiko keamanan.

Deteksi root

Deteksi root Android lanjutan dengan berbagai metode 🔒

Deteksi emulator

Identifikasi lingkungan teremulasi dan framework pengujian 🛡️

Validasi keamanan

Berbagai teknik deteksi untuk akurasi yang ditingkatkan ✅

Fokus Android

Deteksi khusus untuk penilaian keamanan Android 🤖

Instalasi

npm install @capgo/capacitor-is-root
npx cap sync

Metode API Inti

Deteksi Root

• isRooted() - Melakukan deteksi root komprehensif menggunakan metode default
• isRootedWithBusyBox() - Deteksi diperluas termasuk pemeriksaan BusyBox
• detectRootManagementApps() - Mengidentifikasi aplikasi manajemen root yang terinstal
• checkForSuBinary() - Memeriksa keberadaan binary su di jalur sistem

Deteksi Emulator

• isRunningOnEmulator() - Mendeteksi sidik jari emulator Android umum

Teknik Deteksi

Plugin menggunakan beberapa metode deteksi:

Deteksi Root

• Memeriksa aplikasi manajemen root (SuperSU, Magisk, dll.)
• Memindai properti sistem yang mencurigakan
• Mengidentifikasi tag build tes dan flag debug
• Memvalidasi lokasi binary yang berbahaya
• Memeriksa izin jalur sistem

Deteksi Emulator

• Analisis sidik jari hardware
• Inspeksi properti build
• Karakteristik khusus emulator
• Indikator lingkungan virtual

Contoh Penggunaan

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

// Deteksi root dasar
const rootResult = await IsRoot.isRooted();
if (rootResult.isRooted) {
  console.log('Perangkat di-root');
  // Tangani perangkat yang di-root dengan tepat
}

// Deteksi root diperluas dengan BusyBox
const extendedResult = await IsRoot.isRootedWithBusyBox();
if (extendedResult.isRooted) {
  console.log('Perangkat di-root (pemeriksaan diperluas)');
}

// Periksa emulator
const emulatorResult = await IsRoot.isRunningOnEmulator();
if (emulatorResult.isEmulator) {
  console.log('Berjalan di emulator');
}

// Deteksi aplikasi manajemen root
const rootAppsResult = await IsRoot.detectRootManagementApps();
if (rootAppsResult.hasRootApps) {
  console.log('Aplikasi manajemen root terdeteksi');
}

Pertimbangan Keamanan

• Gunakan beberapa metode deteksi untuk akurasi lebih tinggi
• Implementasikan degradasi yang anggun untuk lingkungan yang terdeteksi
• Pertimbangkan privasi pengguna saat menerapkan langkah-langkah keamanan
• Pembaruan rutin direkomendasikan karena metode deteksi berkembang

Dokumentasi

Periksa dokumentasi lengkap untuk panduan implementasi terperinci dan pola keamanan lanjutan.