Panduan Teknis

Simulasi Profil Perangkat

Mekanisme simulasi profil perangkat Android dan verifikasi kepatuhan Play Integrity di mode Recovery.

Simulasi Profil Perangkat & Pengujian Sistem

Dokumen ini menjelaskan mekanisme simulasi profil perangkat (device profile simulation) dan evaluasi kepatuhan Play Integrity yang dilakukan secara offline oleh KuyFox.


πŸ’‘ Konsep Kerja: Pengujian Berbasis Partisi Offline

Berbeda dengan modul Magisk, KernelSU, atau LSPosed yang memodifikasi profil secara in-memory pada OS yang sedang aktif, KuyFox beroperasi langsung pada partisi penyimpanan secara offline di mode Recovery.

Keunggulan Metode Offline Ini:

  1. Lingkungan Pengujian Murni: Tidak meninggalkan daemon atau modifikasi runtime pada OS aktif, memastikan pengujian aplikasi berjalan dalam kondisi sistem yang standar.
  2. Konsisten Antar Siklus Pengujian: Konfigurasi tersimpan stabil di partisi untuk pengujian jangka panjang, dan dapat dipulihkan sewaktu-waktu ke baseline awal.
  3. Pengujian Play Integrity Terstandarisasi: Parameter boot terverifikasi (green), verity mode (enforcing), dan flag enkripsi tersinkronisasi rapi sesuai standar sertifikasi perangkat.

🧩 Komponen Profil yang Disimulasikan

1. File Properti Sistem (build.prop Multi-Partisi & DLKM)

KuyFox membaca dan memodifikasi file build.prop di seluruh partisi terkait:

  • /system/build.prop (Partisi Utama)
  • /vendor/build.prop (Spesifikasi Hardware Vendor)
  • /product/build.prop (Kustomisasi Produk)
  • /system_ext/build.prop (Ekstensi Sistem)
  • /odm/etc/build.prop (Original Device Manufacturer)
  • /system/system_dlkm/etc/build.prop (System DLKM - Android 13+ GKI)
  • /vendor/odm_dlkm/etc/build.prop (ODM DLKM)
  • /vendor/vendor_dlkm/etc/build.prop (Vendor DLKM)

!NOTEPengecekan Aman (Safe Skip): Jika HP target tidak memiliki partisi DLKM, KuyFox secara otomatis melewatinya tanpa error atau gangguan pada partisi lain.

Data yang disinkronkan meliputi:

  • Brand & Model: Contoh: samsung SM-S928B (Galaxy S24 Ultra) atau google Pixel 8 Pro.
  • Build Fingerprint Resmi: Sidik jari rilis resmi yang terdaftar di database sertifikasi Google Play.
  • Versi Rilis Android: Konfigurasi dinamis dari Android 10 hingga Android 17.
  • Patch Keamanan (Security Patch Date): Tanggal rilis update keamanan yang disesuaikan secara logis dengan versi Android target.
  • Timestamp & Builder Host: Waktu kompilasi sistem dan nama komputer pembuat build diacak realistis.
  • Kepatuhan State Boot & Integritas Sistem (Verified Boot Compliance):
    ro.boot.verifiedbootstate=green
    ro.boot.flash.locked=1
    ro.boot.veritymode=enforcing
    ro.boot.warranty_bit=0
    

2. Identitas Penyimpanan Data (/data)

  • Android ID: Menuliskan 16-digit heksadesimal acak baru langsung ke dalam settings_secure.xml.
  • SSAID (Per-App Unique ID): Mereset tabel settings_ssaid.xml sehingga setiap aplikasi yang dibuka pertama kali akan mendapatkan ID pengujian unik baru yang terisolasi dari sesi sebelumnya.
  • Nama Perangkat & Bluetooth: Memperbarui nama perangkat komersial di settings_global.xml dan konfigurasi Bluetooth bt_config.conf.
  • Wi-Fi SoftAP SSID: Menyesuaikan nama hotspot nirkabel HP agar sinkron dengan profil perangkat pengujian.

3. Nomor Serial Hardware (Kernel Level)

  • Nomor serial acak standar KUY (KUYxxxxxxxx) ditulis ke /system/etc/kuy_serial.
  • Custom kernel yang membaca file ini akan otomatis menampilkan nomor serial hardware yang baru pada menu About Phone maupun tool diagnostik seperti AIDA64.

4. Reset Cache & Lingkungan Pengujian Bersih (Clean Test Environment)

Setiap kali menerapkan profil pengujian komprehensif, KuyFox dapat membersihkan state sesi sebelumnya:

  • Google Services Framework (GSF): Mereset token pendaftaran Google Play Service dan database akun lokal (accounts.db, accounts_ce.db).
  • Cache Widevine DRM: Menghapus cache DRM lama agar pengujian media dan lisensi tidak mengalami bentrok identitas.
  • Dalvik / ART Cache: Menghapus cache kompilasi DEX aplikasi agar sistem runtime meregenerasi cache sesuai profil pengujian baru.

πŸš€ Cara Menerapkan Profil Pengujian

Metode 1: Menu Interaktif Terminal (TUI)

  1. Buka Terminal di Recovery, lalu ketik kuyfox.
  2. Pilihan 2 Random Test Profile (Direkomendasikan):
    • KuyFox akan memilih profil perangkat resmi secara acak dari database 19 brand terpercaya.
    • Mengacak Android ID, SSAID, serial hardware, dan konfigurasi build.prop.
    • Melakukan reset cache dan state telemetri sekaligus.
    • Sangat cocok untuk one-click fast profiling.
  3. Pilihan 3 Select Device Profile:
    • Anda dapat memilih brand yang diinginkan (misal: Samsung, Google, Xiaomi, Motorola, Sony, OnePlus, dll).
    • Memilih tipe/model perangkat spesifik dari daftar yang tersedia untuk uji kompatibilitas model tertentu.

Metode 2: Perintah Cepat CLI (Tanpa Menu)

Anda dapat menjalankan perintah langsung melalui terminal shell:

Terminal
# Penerapan profil lengkap (build.prop + Android ID + SSAID + Reset State)
kuyfox --bypass

# Cari dan pasang profil perangkat tertentu (contoh: Pixel 8)
kuyfox -m "Pixel 8"

# Hanya menyinkronkan properti build.prop (tanpa reset data)
kuyfox --props

# Hanya membersihkan cache dan me-reset lingkungan pengujian
kuyfox --wipe

πŸ”„ Cara Mengembalikan ke Identitas Asli (Restore Baseline)

KuyFox memiliki sistem keamanan Dual-Layer Protection:

  1. Saat pertama kali dijalankan, file build.prop asli pabrik Anda otomatis dicadangkan ke:
    • Partisi lokal: /system/build.prop.kuyfox.bak
    • Folder penyimpanan: /sdcard/KuyFox/backup_prop/
  2. File backup ini dikunci secara permanen (read-only protection) dan tidak akan pernah tertimpa oleh sesi pengujian berikutnya.

Langkah Mengembalikan ke Asli:

  • Lewat Menu TUI: Buka menu [5] Backup & Restore Original build.prop -> Pilih [2] Restore Original.
  • Lewat Perintah CLI:
    Terminal
    kuyfox --restore
    

KuyFox akan merestore seluruh partisi, file hosts, dan menghapus serial kernel override kembali ke kondisi awal 100%.

Copyright Β© 2026