Repository navigation
it ARCHITECTURE
Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文
COPG-VD è un modulo Zygisk: una piccola libreria nativa (libspoof.so) che il loader Zygisk
inietta nello zygote e, da lì, nei processi delle app. Tutto ciò che fa è presentare
un'identità di dispositivo scelta ai processi che prendi di mira. Non c'è alcuna app e, a parte
il fetch opzionale del profilo, nessuna rete.
-
Avvio dello zygote. Quando lo zygote si avvia, il loader chiama l'
onLoaddel modulo. Esso legge/data/adb/COPG-VD/COPG-VD.jsonuna volta: la configurazione dello scope e il profilo. -
Fork dell'app. Per ogni app che lo zygote forka, il modulo decide in
preAppSpecializese questo processo è nello scope:-
nello scope principale (
playstore/global/whitelist/blacklist), oppure -
nello scope DRM (elencato in
drm_targets). Se non è in nessuno dei due, il modulo si stacca da quel processo (dlclose) e non lascia alcuna traccia in esso.
-
nello scope principale (
-
Specialize. Per un processo che resta, i motori si applicano in
postAppSpecialize, mentre il processo è ancora privilegiato.
Poiché i fork ereditano la copia della memoria dello zygote in copy-on-write, ogni app parte dalla config
letta al boot. Il modulo rilegge il file per processo interessato solo quando esso è effettivamente
cambiato, così un'app appena avviata o riaperta raccoglie un profilo modificato: ma la decisione
sullo scope stessa viene presa all'avvio dello zygote, quindi cambiare lo scope, i motori o
drm_targets richiede un riavvio.
Ognuno è indipendente e commutabile.
-
Campi Build (
motor_jni). Riscriveandroid.os.Build.*(eBuild.VERSION.*) nel processo interessato tramite JNI, così il codice Java legge i valori falsificati. -
Hook delle proprietà (
motor_prop_hook). Presenta le proprietà di sistema falsificate al processo tramite un remap clean-room, per processo, dell'area delle proprietà (prop_virtualizer). È un remap di memoria, non un hook di funzione, quindi non c'è footprint di funzione hookata. - resetprop (device-wide). Scrive le proprietà di sistema per gruppo: identità, versione, stato di boot, SELinux, adb/usb, anti-emulatore, più una passata di pulizia. Lo eseguono gli script di boot. In una modalità scoped i gruppi identità e versione vengono lasciati fuori (Zygisk li consegna per processo); i gruppi boot, lock e SELinux restano globali così il dispositivo è coerente.
-
DRM / Widevine (
motor_drm). Hooka i metodiMediaDrmche riportano il livello di sicurezza Widevine (getSecurityLevel,getPropertyString) e restituisce il livello configurato. Gli hook sono null-checked, così un profilo malformato degrada con grazia invece di far crashare l'app.drm_targetspermette a questo motore di girare sulla propria lista di app, disaccoppiata dallo scope principale.
Il processo iniettato gira nel dominio SELinux dello zygote, che di default non può raggiungere
/data/adb. Il modulo include il proprio sepolicy.rule per permetterlo e, come fallback,
può leggere la config tramite la propria directory di modulo aperta (getModuleDir), così continua a
funzionare anche se una build Zygisk smette di concedere il path. Il file viene parsato con un piccolo
parser JSON incorporato (jsmn); un file che non viene parsato significa che il modulo non falsifica niente.
fingerprint-update.sh aggiorna i campi Build dalla factory image Google più recente,
dalla WebUI o una volta per boot. Usa il downloader incluso proprio del modulo (non un curl/wget dal
PATH), valida ogni valore prima dell'uso, non torna mai indietro, e rifiuta un
profilo che falsifica un dispositivo diverso. android.os.Build viene scritto all'avvio dello zygote, così
i nuovi valori raggiungono le app al riavvio successivo. Vedi USER-GUIDE.md per il lato
utente e CONFIGURATION.md per i campi.
Alzare SDK_INT / ANDROID_VERSION oltre ciò che il framework della ROM è realmente fa sì che le app
chiamino API che non esistono, il che fa crashare le app di Google e riavvia il telefono in un
softloop. Il gruppo versione è quindi disattivato di default e protetto dietro
spoof_version. Il modulo legge la versione reale da /system/build.prop, mai da
getprop, perché getprop è esattamente ciò che falsifica. Vedi la trappola in
USER-GUIDE.md.
Questa documentazione è stata generata con Claude (Anthropic) ed è gestita da VD171. Correzioni e miglioramenti sono benvenuti; vedi CONTRIBUTING.md.