Repository navigation
nl 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 is een Zygisk-module: een kleine native library (libspoof.so) die de Zygisk-loader
in de zygote injecteert en, vandaaruit, in app-processen. Het enige wat het doet is een
gekozen apparaatidentiteit presenteren aan de processen die je beoogt. Er is geen app en, afgezien van
de optionele profielophaling, geen netwerk.
-
Zygote-start. Wanneer de zygote boot, roept de loader de
onLoadvan de module aan. Het leest/data/adb/COPG-VD/COPG-VD.jsoneenmaal: de scope-configuratie en het profiel. -
App-fork. Voor elke app die de zygote forkt, beslist de module in
preAppSpecializeof dit proces binnen de scope valt:-
in de hoofdscope (
playstore/global/whitelist/blacklist), of -
in de DRM-scope (vermeld in
drm_targets). Als het geen van beide is, koppelt de module zich los van dat proces (dlclose) en laat geen spoor erin achter.
-
in de hoofdscope (
-
Specialize. Voor een proces dat blijft, worden de engines toegepast in
postAppSpecialize, terwijl het proces nog geprivilegieerd is.
Omdat forks de geheugenkopie van de zygote copy-on-write erven, start elke app vanaf de config die
bij het booten is gelezen. De module herleest het bestand per beoogd proces alleen wanneer het
daadwerkelijk is gewijzigd, dus een net gestarte of heropende app pikt een bewerkt profiel op: maar de
scope-beslissing zelf wordt genomen bij de zygote-start, dus het wijzigen van de scope, de engines of
drm_targets vereist een herstart.
Elk is onafhankelijk en schakelbaar.
-
Build-velden (
motor_jni). Herschrijftandroid.os.Build.*(enBuild.VERSION.*) in het beoogde proces via JNI, zodat Java-code de gespoofte waarden leest. -
Property-hook (
motor_prop_hook). Presenteert de gespoofte systeemproperties aan het proces via een clean-room remap per proces van het property-gebied (prop_virtualizer). Het is een geheugen-remap, geen functie-hook, dus er is geen voetafdruk van een gehookte functie. - resetprop (apparaatbreed). Schrijft systeemproperties per groep: identiteit, versie, boot-status, SELinux, adb/usb, anti-emulator, plus een opschoonronde. De boot-scripts draaien het. In een scoped modus worden de identiteit- en versiegroepen weggelaten (Zygisk levert ze per proces); de boot-, lock- en SELinux-groepen blijven globaal zodat het apparaat coherent is.
-
DRM / Widevine (
motor_drm). Hookt deMediaDrm-methoden die het Widevine- beveiligingsniveau rapporteren (getSecurityLevel,getPropertyString) en geeft het geconfigureerde niveau terug. De hooks zijn null-gecheckt, zodat een misvormd profiel netjes degradeert in plaats van de app te laten crashen.drm_targetslaat deze engine op zijn eigen app-lijst draaien, losgekoppeld van de hoofdscope.
Het geïnjecteerde proces draait in het zygote SELinux-domein, dat standaard /data/adb niet kan
bereiken. De module levert zijn eigen sepolicy.rule mee om het toe te staan, en kan, als fallback,
de config lezen via zijn geopende moduledirectory (getModuleDir), zodat het blijft
werken, zelfs als een Zygisk-build het pad niet langer verleent. Het bestand wordt geparseerd met een kleine
ingebedde JSON-parser (jsmn); een bestand dat niet parseert betekent dat de module niets spooft.
fingerprint-update.sh ververst de build-velden vanaf de nieuwste Google factory image,
vanuit de WebUI of eenmaal per boot. Het gebruikt de eigen meegeleverde downloader van de module (geen PATH-
curl/wget), valideert elke waarde voor gebruik, gaat nooit achteruit, en weigert een
profiel dat een ander apparaat spooft. android.os.Build wordt geschreven bij de zygote-start, zodat
nieuwe waarden de apps bij de volgende herstart bereiken. Zie USER-GUIDE.md voor de gebruikers-
kant en CONFIGURATION.md voor de velden.
SDK_INT / ANDROID_VERSION verhogen boven wat het framework van de ROM werkelijk is, laat apps
API's aanroepen die niet bestaan, wat Google's apps laat crashen en de telefoon in een softloop laat
herstarten. De versiegroep is daarom standaard uit en afgeschermd achter
spoof_version. De module leest de echte versie uit /system/build.prop, nooit uit
getprop, omdat getprop precies is wat het vervalst. Zie de valkuil in
USER-GUIDE.md.
Deze documentatie is gegenereerd met Claude (Anthropic) en wordt onderhouden door VD171. Correcties en verbeteringen zijn welkom; zie CONTRIBUTING.md.