Repository navigation
es 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 es un módulo de Zygisk: una pequeña biblioteca nativa (libspoof.so) que el loader
de Zygisk inyecta en el zygote y, desde ahí, en los procesos de las apps. Todo lo que hace es
presentar una identidad de dispositivo elegida a los procesos que seleccionas. No hay app y,
aparte de la obtención opcional del perfil, no hay red.
-
Arranque de zygote. Cuando el zygote arranca, el loader llama a la función
onLoaddel módulo. Lee/data/adb/COPG-VD/COPG-VD.jsonuna vez: la configuración de alcance y el perfil. -
Fork de app. Para cada app que el zygote forkea, el módulo decide en
preAppSpecializesi este proceso está en el alcance:-
en el alcance principal (
playstore/global/whitelist/blacklist), o -
en el alcance de DRM (listado en
drm_targets). Si no es ninguno, el módulo se desacopla de ese proceso (dlclose) y no deja rastro en él.
-
en el alcance principal (
-
Specialize. Para un proceso que se queda, los motores se aplican en
postAppSpecialize, mientras el proceso todavía tiene privilegios.
Como los forks heredan la copia copy-on-write de la memoria del zygote, cada app arranca a
partir de la configuración leída en el arranque. El módulo relee el archivo por proceso
objetivo solo cuando realmente ha cambiado, de modo que una app recién iniciada o reabierta
toma un perfil editado: pero la decisión de alcance en sí se toma en el arranque de zygote,
así que cambiar el alcance, los motores o drm_targets requiere un reinicio.
Cada uno es independiente y conmutable.
-
Campos Build (
motor_jni). Reescribeandroid.os.Build.*(yBuild.VERSION.*) en el proceso objetivo mediante JNI, de modo que el código Java lee los valores falsificados. -
Hook de propiedades (
motor_prop_hook). Presenta al proceso las propiedades del sistema falsificadas mediante un remapeo clean-room, por proceso, del área de propiedades (prop_virtualizer). Es un remapeo de memoria, no un hook de función, así que no hay huella de función hookeada. - resetprop (en todo el dispositivo). Escribe las propiedades del sistema por grupo - identidad, versión, estado de arranque, SELinux, adb/usb, anti-emulador, más una pasada de limpieza. Los scripts de arranque lo ejecutan. En un modo con alcance acotado, los grupos de identidad y versión quedan fuera (Zygisk los entrega por proceso); los grupos de arranque, bloqueo y SELinux permanecen globales para que el dispositivo sea coherente.
-
DRM / Widevine (
motor_drm). Hookea los métodos deMediaDrmque informan del nivel de seguridad Widevine (getSecurityLevel,getPropertyString) y devuelve el nivel configurado. Los hooks tienen comprobación de null, de modo que un perfil malformado se degrada con elegancia en lugar de hacer caer la app.drm_targetspermite que este motor se ejecute en su propia lista de apps, desacoplado del alcance principal.
El proceso inyectado se ejecuta en el dominio SELinux del zygote, que de forma predeterminada
no puede alcanzar /data/adb. El módulo incluye su propio sepolicy.rule para permitirlo y,
como alternativa, puede leer la configuración a través de su directorio de módulo abierto
(getModuleDir), de modo que sigue funcionando aunque un build de Zygisk deje de conceder la
ruta. El archivo se parsea con un pequeño parser JSON embebido (jsmn); un archivo que no se
parsea significa que el módulo no falsifica nada.
fingerprint-update.sh refresca los campos build desde la imagen de fábrica de Google más
reciente, desde la WebUI o una vez por arranque. Usa el propio descargador incluido del
módulo (no un curl/wget del PATH), valida cada valor antes de usarlo, nunca retrocede y
rechaza un perfil que falsifica un dispositivo distinto. android.os.Build se escribe en el
arranque de zygote, así que los nuevos valores llegan a las apps en el siguiente reinicio.
Consulta USER-GUIDE.md para el lado del usuario y
CONFIGURATION.md para los campos.
Subir SDK_INT / ANDROID_VERSION por encima de lo que realmente es el framework de la ROM
hace que las apps llamen a APIs que no existen, lo que hace caer las apps de Google y
reinicia el teléfono en un softloop. Por eso el grupo de versión está desactivado de forma
predeterminada y protegido tras spoof_version. El módulo lee la versión real de
/system/build.prop, nunca de getprop, porque getprop es justo lo que falsifica.
Consulta la trampa en USER-GUIDE.md.
Esta documentación se generó con Claude (Anthropic) y la mantiene VD171. Las correcciones y mejoras son bienvenidas; consulta CONTRIBUTING.md.