Repository navigation
cs 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 je modul Zygisk: malá nativní knihovna (libspoof.so), kterou loader Zygisku
injektuje do zygote a odtud do procesů aplikací. Vše, co dělá, je předložit zvolenou
identitu zařízení procesům, které cílíte. Neexistuje žádná aplikace a kromě volitelného
stažení profilu žádná síť.
-
Start zygote. Když zygote nabootuje, loader volá modulovou funkci
onLoad. Jednou přečte/data/adb/COPG-VD/COPG-VD.json: konfiguraci rozsahu a profil. -
Fork aplikace. Pro každou aplikaci, kterou zygote forkne, modul v
preAppSpecializerozhodne, zda je tento proces v rozsahu:-
v hlavním rozsahu (
playstore/global/whitelist/blacklist), nebo -
v DRM rozsahu (uveden v
drm_targets). Pokud není ani jedno, modul se od tohoto procesu odpojí (dlclose) a nezanechá v něm žádnou stopu.
-
v hlavním rozsahu (
-
Specialize. U procesu, který zůstává, se enginy aplikují v
postAppSpecialize, zatímco je proces stále privilegovaný.
Protože forky dědí copy-on-write kopii paměti zygote, každá aplikace startuje z
konfigurace přečtené při bootu. Modul čte soubor znovu per cílený proces pouze tehdy, když
se skutečně změnil, takže nově spuštěná nebo znovu otevřená aplikace zachytí upravený
profil: ale samotné rozhodnutí o rozsahu se dělá při startu zygote, takže změna
rozsahu, enginů nebo drm_targets vyžaduje restart.
Každý je nezávislý a přepínatelný.
-
Pole Build (
motor_jni). Přepisujeandroid.os.Build.*(aBuild.VERSION.*) v cíleném procesu přes JNI, takže Java kód čte podvržené hodnoty. -
Hook vlastností (
motor_prop_hook). Předkládá procesu podvržené systémové vlastnosti pomocí clean-room přemapování oblasti vlastností per proces (prop_virtualizer). Je to přemapování paměti, ne hook funkce, takže neexistuje stopa po hooknuté funkci. - resetprop (napříč zařízením). Zapisuje systémové vlastnosti po skupinách: identita, verze, stav bootu, SELinux, adb/usb, anti-emulátor, plus čisticí průchod. Spouštějí jej boot skripty. V rozsahovém režimu jsou skupiny identity a verze vynechány (Zygisk je doručuje per proces); skupiny bootu, zámku a SELinuxu zůstávají globální, aby bylo zařízení koherentní.
-
DRM / Widevine (
motor_drm). Hookuje metodyMediaDrm, které hlásí bezpečnostní úroveň Widevine (getSecurityLevel,getPropertyString), a vrací nakonfigurovanou úroveň. Hooky mají kontrolu na null, takže poškozený profil elegantně degraduje místo pádu aplikace.drm_targetsumožňuje tomuto enginu běžet na vlastním seznamu aplikací, odpojeně od hlavního rozsahu.
Injektovaný proces běží v SELinux doméně zygote, která ve výchozím stavu nemůže dosáhnout
na /data/adb. Modul přichází s vlastním sepolicy.rule, aby to umožnil, a jako záloha
může číst konfiguraci přes svůj otevřený adresář modulu (getModuleDir), takže funguje
dál, i kdyby build Zygisku přestal udělovat cestu. Soubor je parsován malým vestavěným JSON
parserem (jsmn); soubor, který se neparsuje, znamená, že modul nic nepodvrhuje.
fingerprint-update.sh obnovuje pole build z nejnovějšího továrního obrazu Google, z WebUI
nebo jednou za boot. Používá vlastní přibalený downloader modulu (ne curl/wget z
PATH), validuje každou hodnotu před použitím, nikdy nejde zpět a odmítá profil, který
podvrhuje jiné zařízení. android.os.Build se zapisuje při startu zygote, takže nové
hodnoty dorazí k aplikacím při příštím restartu. Viz USER-GUIDE.md pro
uživatelskou stranu a CONFIGURATION.md pro pole.
Zvýšení SDK_INT / ANDROID_VERSION nad to, co framework ROM ve skutečnosti je, přiměje
aplikace volat API, která neexistují, což shodí aplikace Google a restartuje telefon do
softloopu. Skupina verze je proto ve výchozím stavu vypnuta a uzamčena za spoof_version.
Modul čte skutečnou verzi z /system/build.prop, nikdy z getprop, protože getprop je
přesně to, co falšuje. Viz past v USER-GUIDE.md.
Tato dokumentace byla vytvořena pomocí Claude (Anthropic) a spravuje ji VD171. Opravy a vylepšení jsou vítány; viz CONTRIBUTING.md.