Repository navigation
pl 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 to moduł Zygisk: mała natywna biblioteka (libspoof.so), którą loader Zygisk
wstrzykuje do zygote, a stamtąd do procesów aplikacji. Wszystko, co robi, to prezentowanie
wybranej tożsamości urządzenia procesom, które wskażesz. Nie ma aplikacji i, poza
opcjonalnym pobieraniem profilu, nie ma sieci.
-
Start zygote. Gdy zygote się uruchamia, loader wywołuje
onLoadmodułu. Odczytuje/data/adb/COPG-VD/COPG-VD.jsonraz: konfigurację zakresu i profil. -
Fork aplikacji. Dla każdej aplikacji, którą zygote forkuje, moduł decyduje w
preAppSpecialize, czy ten proces jest w zakresie:-
w głównym zakresie (
playstore/global/whitelist/blacklist), lub -
w zakresie DRM (wymieniony w
drm_targets). Jeśli nie jest w żadnym, moduł odłącza się od tego procesu (dlclose) i nie pozostawia w nim śladu.
-
w głównym zakresie (
-
Specialize. Dla procesu, który pozostaje, silniki stosują się w
postAppSpecialize, dopóki proces jest nadal uprzywilejowany.
Ponieważ forki dziedziczą kopię pamięci zygote w trybie copy-on-write, każda aplikacja startuje z konfiguracji
odczytanej przy rozruchu. Moduł ponownie odczytuje plik per docelowy proces tylko wtedy, gdy faktycznie
się zmienił, więc nowo uruchomiona lub ponownie otwarta aplikacja podchwytuje edytowany profil: ale sama
decyzja o zakresie jest podejmowana przy starcie zygote, więc zmiana zakresu, silników lub
drm_targets wymaga ponownego uruchomienia.
Każdy jest niezależny i przełączalny.
-
Pola Build (
motor_jni). Przepisujeandroid.os.Build.*(orazBuild.VERSION.*) w docelowym procesie poprzez JNI, więc kod Java odczytuje sfałszowane wartości. -
Hak właściwości (
motor_prop_hook). Prezentuje sfałszowane właściwości systemowe procesowi poprzez czyste (clean-room), per proces remapowanie obszaru właściwości (prop_virtualizer). To remapowanie pamięci, nie hak na funkcję, więc nie ma śladu po zahaczonej funkcji. - resetprop (na poziomie całego urządzenia). Zapisuje właściwości systemowe grupami: tożsamość, wersja, stan rozruchu, SELinux, adb/usb, anty-emulator, plus przebieg porządkujący. Uruchamiają go skrypty rozruchowe. W trybie z zakresem grupy tożsamości i wersji są pomijane (Zygisk dostarcza je per proces); grupy boot, lock i SELinux pozostają globalne, aby urządzenie było spójne.
-
DRM / Widevine (
motor_drm). Hakuje metodyMediaDrm, które zgłaszają poziom bezpieczeństwa Widevine (getSecurityLevel,getPropertyString) i zwraca skonfigurowany poziom. Haki mają sprawdzanie null, więc wadliwy profil degraduje się łagodnie zamiast zawieszać aplikację.drm_targetspozwala temu silnikowi działać na własnej liście aplikacji, odłączonej od głównego zakresu.
Wstrzyknięty proces działa w domenie SELinux zygote, która domyślnie nie może sięgnąć
/data/adb. Moduł dostarcza własną sepolicy.rule, aby na to pozwolić, oraz, jako fallback,
może odczytać konfigurację poprzez swój otwarty katalog modułu (getModuleDir), więc działa dalej
nawet jeśli jakiś build Zygisk przestanie przyznawać tę ścieżkę. Plik jest parsowany małym
wbudowanym parserem JSON (jsmn); plik, który się nie parsuje, oznacza, że moduł nie fałszuje niczego.
fingerprint-update.sh odświeża pola build z najnowszego fabrycznego obrazu Google,
z WebUI lub raz na rozruch. Używa własnego dołączonego downloadera modułu (nie curl/wget
z PATH), waliduje każdą wartość przed użyciem, nigdy się nie cofa i odrzuca
profil, który fałszuje inne urządzenie. android.os.Build jest zapisywane przy starcie zygote, więc
nowe wartości docierają do aplikacji przy następnym ponownym uruchomieniu. Zobacz USER-GUIDE.md po stronę
użytkownika i CONFIGURATION.md po pola.
Podniesienie SDK_INT / ANDROID_VERSION powyżej tego, czym naprawdę jest framework ROM-u, sprawia, że aplikacje
wywołują API, które nie istnieje, co zawiesza aplikacje Google i wprowadza telefon w
softloop. Grupa wersji jest zatem domyślnie wyłączona i strzeżona przez
spoof_version. Moduł odczytuje prawdziwą wersję z /system/build.prop, nigdy z
getprop, ponieważ getprop jest dokładnie tym, co fałszuje. Zobacz pułapkę w
USER-GUIDE.md.
Ta dokumentacja została wygenerowana za pomocą Claude (Anthropic) i jest utrzymywana przez VD171. Poprawki i ulepszenia są mile widziane; zobacz CONTRIBUTING.md.