Esquemas de firma v1, v2, v3, v3.1 y v3.2
Antes conviene leer «Contenedor ZIP» · se lee en paralelo con «APK Signing Block»
1. Qué es y por qué existe
Android no tiene una tienda única obligatoria ni una autoridad de certificación. Un APK puede
llegar al dispositivo por Play, por F-Droid, por un adb install o por un fichero copiado a mano.
Lo único que el sistema puede exigir en todos esos caminos es que el paquete venga firmado, y esa
firma sostiene tres reglas del modelo de seguridad:
- Una actualización solo puede sustituir a una aplicación firmada con la misma clave. Es la propiedad que impide que otra persona publique una «actualización» de tu aplicación.
- Los permisos de nivel
signaturese conceden entre aplicaciones firmadas con la misma clave. Es lo que permite que un paquete hable con otro sin pedir permiso al usuario. - El
sharedUserIdy los datos de la instalación previa están atados a la clave.
La primera regla tiene una consecuencia que se nota al cambiar de tienda: la misma aplicación
puede venir firmada con claves distintas según de dónde la bajes, y entonces una copia no puede
sustituir a la otra. Pasa más de lo que parece. De los 480 paquetes que están a la vez en F-Droid
y en IzzyOnDroid, unos dos tercios llevan el mismo certificado (en 262 son incluso el mismo
fichero). En los otros 150, casi uno de cada tres, el certificado cambia. En 148 de ellos, F-Droid
compila la aplicación y la firma con una clave suya, mientras IzzyOnDroid reparte el APK con
otra, casi siempre la del autor a juzgar por el nombre del certificado (una pista, no una prueba).
Así que si tienes instalada una de las dos copias, no puedes actualizarla con la otra. Ejemplos:
fr.smarquis.sleeptimer(versión 16300): la copia de F-Droid va firmada con la clave que genera F-Droid, y la de IzzyOnDroid, que es la misma versión, con otro certificado.com.martinmimigames.tinymusicplayer(versión 4): el mismo fichero está en las dos tiendas.
Entre Google Play y las demás tiendas solo coinciden 6 paquetes, muy pocos para sacar una proporción. Qué tiendas hay y quién firma en cada una está en «El mapa del ecosistema».
Conviene separar dos cosas que se confunden todo el tiempo:
- Integridad del contenido. ¿Han cambiado los bytes desde que se firmó? Esto la firma lo responde de forma dura y verificable.
- Autenticidad de origen. ¿Quién firmó? Esto la firma no lo responde en Android. El certificado es autofirmado: sujeto y emisor son la misma entidad, no hay cadena hasta una CA y nadie ha validado que «CN=FDroid» sea F-Droid. Lo que el sistema comprueba es continuidad: que la clave sea la misma que la de la instalación previa. Para Android, una aplicación es el hash de su certificado, no su nombre.
Y en la práctica el certificado es autofirmado casi siempre. No hay ni uno con emisor distinto del
sujeto en F-Droid, IzzyOnDroid, el sorteo de Google Play, el mercado chino ni las webs de los
autores. La excepción está en las apps más instaladas de Google Play: 23 apps de 658 (184 piezas,
en torno al 2 %). Llevan un certificado emitido por una autoridad de certificación (CA) propia de
la empresa: «Amazon Self-Sign CA», «Microsoft Android Play App PCA»,
«Common MotoBLUR 2-1» (Motorola) o «Meta Android Code Signing Intermediate CA 2024-11». Son
cadenas privadas, no una autoridad pública. Dos ejemplos, ambos la pieza base.apk de su
contenedor .apkm:
com.amazon.dee.app(Alexa, versión 2.2.724579.0): certificado emitido porCN=Amazon Self-Sign CA.com.microsoft.office.outlook(Outlook, versión 5.2641.1): certificado emitido porCN=Microsoft Android Play App PCA.
Lo que se compara sigue siendo el certificado del firmante: continuidad, no identidad.
En Google Play, además, muchas aplicaciones no van firmadas con la clave del autor. Con Play App
Signing, el autor sube el paquete firmado con una clave de subida y Google lo firma de nuevo
con la clave de firma de la app, que guarda él (ver Fuentes). Esa clave se reconoce por el nombre
del certificado: CN=Android, OU=Android, O=Google Inc., L=Mountain View, ST=California, C=US.
Ojo: es una pista, no una prueba, porque cualquiera puede escribir ese nombre.
Mirando el firmante de v3.1 si lo hay, ese nombre aparece en una de cada cinco apps de las más instaladas de Google Play (131 de 658) y en dos de cada tres de las del sorteo (245 de 369). Fuera de Play casi no existe: ninguna en F-Droid ni en el mercado chino, 4 de más de 1.400 en IzzyOnDroid. Y es un mínimo, porque muchas apps que Google Play entrega con PairIP (una protección que añade al entregar la app) no lo llevan. Con PairIP lo llevan 15 de 45 en las más instaladas y 86 de 99 en el sorteo. Ejemplos:
com.vexostudio.win786›base.apk: certificado de v2 y v3 con ese nombre y RSA de 4.096 bits.com.google.android.keep(Keep 5.26.411.03.97) ›base.apk: firmante de v3.1 con ese nombre (más abajo, en las secciones «5.2» y «10.1»).
Hay un cuarto punto que se malinterpreta con la misma frecuencia: una firma válida no dice nada
sobre lo que hace la aplicación. Un APK con malware firmado correctamente verifica igual de
bien que uno legítimo. La firma acota quién puede sustituirlo, no qué contiene.
Esta página cubre los esquemas que viven dentro del APK: v1 en META-INF/ y v2, v3, v3.1 y
v3.2 en el «APK Signing Block». El esquema v4, que vive fuera del
fichero, y el algoritmo completo de verificación están en
«Firma v4 y verificación».
Endianness: todas las estructuras binarias descritas aquí son little-endian. Los ficheros de v1 son de texto y se tratan como tales.
2. La línea del tiempo
| Esquema | Introducido en | Dónde vive | Qué añade |
|---|---|---|---|
| v1 (JAR signing) | Android 1.0 | META-INF/MANIFEST.MF, *.SF, *.RSA |
Firma por entrada |
| v2 | Android 7.0 (API 24) | Bloque 0x7109871a |
Firma del fichero completo |
| v3 | Android 9 (API 28) | Bloque 0xf05368c0 |
Rango de SDK y rotación de clave |
| v3.1 | Android 13 (API 33) | Bloque 0x1b93ad61 |
Segmentación de la rotación por SDK |
| v3.2 | Android 17 (API 37) | Bloque 0x70e1c89f |
Firma híbrida: un firmante clásico y otro poscuántico |
| v4 | Android 11 (API 30) | Fichero .idsig aparte |
Árbol de Merkle para instalación incremental |
Los umbrales son constantes de V3SchemeConstants.java de apksig, definidas con los niveles de
AndroidSdkVersion.java: MIN_SDK_WITH_V3_SUPPORT = AndroidSdkVersion.P (28),
MIN_SDK_WITH_V31_SUPPORT = AndroidSdkVersion.T (33) y
MIN_SDK_WITH_V32_SUPPORT = AndroidSdkVersion.C (37). v3.2, la firma híbrida de Android 17, está
en la «sección 7 · v3.2: la firma híbrida». En el muestrario, el firmante de v3.1 empieza en el nivel 33 en 1.092 de las 1.093
piezas que llevan ese bloque (la otra, com.oplus.games, empieza en el 37), y el de v3.2 empieza
en el 37 en las 34 que lo llevan.
3. v1: JAR signing
El esquema v1 es el de los ficheros JAR de Java, adoptado tal cual. Firma entradas del ZIP,
no el fichero. Son tres artefactos encadenados dentro de META-INF/.
El nombre CERT es una convención, no una regla: se llama como el firmante quiera, y cada tienda
tiene su costumbre. En F-Droid, 4 de cada 5 apps con v1 usan como nombre del .SF un alias de
ocho cifras hexadecimales, como 84D3000E en Termux; CIARANG, el nombre del propio cliente de
F-Droid, solo lo llevan 2. En IzzyOnDroid manda CERT (unas 7 de cada 10). En Google Play manda
BNDLTOOL, el nombre que pone bundletool (la herramienta de Google que genera las piezas de una
app dividida): lo llevan 105 de 240 apps de las más instaladas y 98 de 136 del sorteo. En el
mercado chino casi todos los nombres son propios.
Los contenedores .apkm de APKMirror llevan además, todos, una firma v1 propia en su raíz:
META-INF/APKMIRRO.SF y APKMIRRO.RSA. Esa firma cubre las piezas del contenedor como ficheros,
no la app; ninguna pieza de dentro se llama APKMIRRO. Los .xapk no llevan firma en la raíz.
Ejemplos:
org.fdroid.fdroid(versión 2000052):CIARANG.SFyCIARANG.RSA.com.termux(versión 1022):84D3000E.SFy84D3000E.RSA.com.vexostudio.win786›base.apk:BNDLTOOL.SFyBNDLTOOL.RSA.moe.henry_zhr.kill_domain_verification(versión 4, de IzzyOnDroid):CERT.SF, firmada con el plugin de Gradle de Android.- El
.apkmde Keep (5.26.411.03.97):APKMIRRO.SFyAPKMIRRO.RSAen la raíz del contenedor.
3.1 META-INF/MANIFEST.MF
Fichero de texto con la sintaxis de manifiesto de JAR: una sección principal y luego una sección individual por entrada firmada, separadas por línea en blanco. La especificación de Oracle lo fija así:
«A JAR file manifest consists of a main section followed by a list of sections for individual JAR file entries, each separated by a newline. […] Each section must start with an attribute with the name as
Name, and the value must be a relative path to the file».
Extracto real del APK del cliente de F-Droid (org.fdroid.fdroid, versión 2000052): las dos
primeras secciones y, más abajo, la primera línea partida, que es la línea 54 del fichero.
Manifest-Version: 1.0
Name: AndroidManifest.xml
SHA-256-Digest: aqhylM/52uV54sQpmBXxWmEtuWplKDAdauZWh7iqDnY=
Name: DebugProbesKt.bin
SHA-256-Digest: BlvXkrhSd2TzMUcYgwKvW/niqNpA/eCDDcERrSba5A4=
…
Name: META-INF/androidx.compose.material3.adaptive_adaptive-layout.ver
sion
SHA-256-Digest: 8hTqONVND0pqa9s8sXPVBR7dUu03TJ+rB9s6iZawMME=
Tres detalles que un parser tiene que respetar:
- El digest es del contenido descomprimido de la entrada, en Base64. El nombre del atributo
dice el algoritmo:
SHA-256-Digesten la mayoría de las apps ySHA1-Digesten una de cada cinco de F-Droid (736 de 3.663 apps con v1).apksignerusa SHA-1 cuandominSdkVersiones menor que 18: las 605 apps de F-Droid, las 127 de IzzyOnDroid y las demás con eseminSdkVersionllevanSHA1-Digest. Con 18 o más hay excepciones: 131 apps de F-Droid, por ejemplo Briar (org.briarproject.briar.android, versión 10522,minSdkVersion21). No sabemos por qué, y no nos atrevemos a dar una causa. - Ninguna línea puede pasar de 72 bytes en su forma UTF-8, y la continuación se marca con un
espacio inicial. En el ejemplo,
…layout.verysionson una sola línea lógica:META-INF/androidx.compose.material3.adaptive_adaptive-layout.version. Un parser que corte por\nsin volver a unir las continuaciones lee mal el nombre. - El propio
MANIFEST.MFno se lista, y no todas las entradas tienen por qué estarlo. En el cliente de F-Droid, el ZIP tiene 973 entradas y el manifiesto no lista las tres del propio v1 (MANIFEST.MF,CIARANG.SFyCIARANG.RSA). Las entradas que no son deMETA-INF/están todas:apksignerno ha dado ni un error de entrada sin digest («No digest for…») en las 8.109 piezas cuya v1 comprueba por tenerminSdkVersionmenor que 24. El contenedor.apkmde Keep lista 30 entradas y deja fuera los mismos tres ficheros deMETA-INF/.
Ese fichero mide unos 100 KB en un APK de 12 MB, y todo es texto que hay que leer, parsear y
comparar entrada por entrada. No es un caso raro: en las apps grandes de Google Play o del mercado
chino, el MANIFEST.MF típico pasa de varios cientos de KB.
3.2 META-INF/CERT.SF
Mismo formato, un nivel por encima. Su sección principal lleva el digest del manifiesto completo, y sus secciones individuales el digest de la sección correspondiente del manifiesto, no del fichero.
Signature-Version: 1.0
Created-By: 1.0 (Android)
SHA-256-Digest-Manifest: 0BeGr7+gSMKU6tz3NuyXFDe6y4M+hx5L7+LAC8PZMXI=
X-Android-APK-Signed: 2, 3
Name: AndroidManifest.xml
SHA-256-Digest: wU+eEm0qtlYBI0M0LMfydO1kKw+pzxdDESCd59Hyk/c=
Es el META-INF/CIARANG.SF del mismo APK de la «sección 3.1 · META-INF/MANIFEST.MF». Created-By dice con qué programa se
firmó la v1. 1.0 (Android) es apksigner: lo llevan 4 de cada 5 apps de F-Droid con v1.
| Atributo | Sección | Sobre qué se calcula |
|---|---|---|
x-Digest-Manifest |
principal | El fichero MANIFEST.MF entero |
x-Digest-Manifest-Main-Attributes |
principal | Solo la sección principal del manifiesto |
x-Digest |
individual | La sección del manifiesto con ese Name, bytes incluidos |
X-Android-APK-Signed |
principal | Extensión de Android, no de Oracle |
Los dos primeros existen para validar rápido: si x-Digest-Manifest cuadra, el verificador se
ahorra recorrer las secciones una a una. Si no cuadra (porque alguien añadió una entrada al
manifiesto sin firmarla), cae a la comprobación sección a sección. Eso es lo que permite que un
JAR firmado admita entradas nuevas sin invalidar la firma.
En Java esa tolerancia es deliberada; en Android queda recortada. Añadir una entrada normal sí
se detecta, porque toda entrada fuera de META-INF/ tiene que estar en el manifiesto y en el .SF
de un firmante (segunda fila de la tabla de la «sección 3.4 · Las debilidades estructurales de v1»). Queda abierto lo que ninguna sección
individual cubre. Por un lado, la sección principal de MANIFEST.MF: solo la protegería
x-Digest-Manifest-Main-Attributes, que apksigner no escribe, y con el digest del manifiesto
entero roto ni apksig ni StrictJarVerifier la comprueban. Por otro, las entradas de META-INF/
de la «sección 3.4 · Las debilidades estructurales de v1».
X-Android-APK-Signed es la protección contra el downgrade. Su valor es la lista de esquemas
superiores con los que también se firmó el APK. Lo ves en el cliente de F-Droid
(X-Android-APK-Signed: 2, 3, v1+v2+v3) y en Briar (X-Android-APK-Signed: 2; v1+v2, con el .SF
llamado CERTIFIC.SF). Funciona porque está firmada. Si un atacante quita el APK Signing Block
para que el sistema caiga a v1, esta línea sigue ahí, el verificador la ve y rechaza el fichero.
La «sección 10.4 · Ver los ficheros de v1» enseña esa línea en un .SF real, y la 10.3 demuestra el mismo mecanismo un piso
más arriba, con el atributo del bloque v2.
En la práctica, el valor cuadra con los bloques que lleva el APK en casi todas las apps con v1,
en todas las fuentes. Las que no lo llevan son, casi siempre, las que no tienen APK Signing Block: no hay nada que proteger. Solo dos apps con v1 y con bloque no llevan el atributo, una de
Google Play y una del mercado chino (com.tencent.tgclub, versión 2026081227).
El atributo -Digest-Manifest-Main-Attributes sirve de pista para saber con qué se firmó la v1.
La especificación de Oracle dice que «its nonexistence does not affect JAR file verification», y
cada herramienta hace lo suyo. jarsigner (la de Java) lo escribe: lo llevan los 5 .SF leídos
de apps firmadas con él, y también el APKMIRRO.SF de los contenedores .apkm. No lo escriben
apksigner (0 de 8 .SF leídos), ni el plugin de Gradle (0 de 5), ni SignApk (0 de 5). Es una muestra, no un censo: de cada herramienta leímos los .SF de las 5
piezas sueltas más pequeñas (28 en total, con los ejemplos con nombre). Ejemplos:
pro.rudloff.lineageos_updater_shortcut(versión 2):jarsigner, conSHA1-Digest-Manifest-Main-Attributes.tk.al54.dev.badpixels(versión 4):jarsigner, igual.com.netflix.ninja13.2.1-27207: otra herramienta, conSHA-256-Digest-Manifest-Main-Attributes.- El
APKMIRRO.SFdel contenedor de Keep (el mismo.apkmde la «sección 3 · v1: JAR signing»):Created-By: 21.0.12.1 (N/A)ySHA1-Digest-Manifest-Main-Attributes.
Qué herramienta firmó. Solo la v1 lo dice: el Created-By del .SF nombra la herramienta
(1.0 (Android) es apksigner; Android Gradle 9.2.1, el plugin de Gradle; 1.8.0_252 (Private Build), jarsigner; 1.0 (Android SignApk), la firma de la plataforma de un fabricante). Si
falta la v1, ninguna otra parte de la firma dice con qué herramienta se firmó. El nombre del .SF
también ayuda: BNDLTOOL delata a bundletool.
apksigner es lo más común en F-Droid y en las más instaladas de Google Play; en IzzyOnDroid manda
el plugin de Gradle. SignApk aparece casi solo en piezas de fabricantes de Google Play, por
ejemplo com.samsung.android.spdclient 6.1.01, y jarsigner firma una de cada diez apps de
F-Droid.
3.3 META-INF/CERT.RSA
Un mensaje SignedData de CMS (RFC 5652), en DER, con la firma sobre los bytes del .SF y el
certificado del firmante. La extensión depende del algoritmo de la clave: .RSA para RSA, .DSA
para DSA y .EC —PKCS#7 con ECDSA— para EC. La especificación de Oracle admite además RSASSA-PSS
en .RSA y EdDSA en .EC, pero en un APK no sirven: el v1 de apksig solo reconoce RSA, DSA y
ECDSA, y el PKCS7 de libcore en el que se apoya StrictJarVerifier, el verificador v1 de la
plataforma, no reconoce EdDSA.
En la práctica casi todo es .RSA; .DSA y .EC son rarezas de unas pocas apps. En todas, la
extensión coincide con la clave del certificado. Por ejemplo, com.netvor.settings.database.provider (versión 2, de IzzyOnDroid) lleva
un .DSA con clave DSA de 2.048 bits, y org.axpos.lovelaceav (versión 31614, también de
IzzyOnDroid) un .EC con clave EC P-521. Ninguna pieza que hemos medido lleva RSASSA-PSS ni EdDSA
en .EC.
SCR=/tmp/scratch # copia de trabajo, ver sección 10
openssl asn1parse -inform DER -in $SCR/v1/META-INF/CIARANG.RSA | head -12
openssl pkcs7 -inform DER -in $SCR/v1/META-INF/CIARANG.RSA -print_certs -noout
0:d=0 hl=4 l=1346 cons: SEQUENCE
4:d=1 hl=2 l= 9 prim: OBJECT :pkcs7-signedData
15:d=1 hl=4 l=1331 cons: cont [ 0 ]
19:d=2 hl=4 l=1327 cons: SEQUENCE
23:d=3 hl=2 l= 1 prim: INTEGER :01
26:d=3 hl=2 l= 15 cons: SET
28:d=4 hl=2 l= 13 cons: SEQUENCE
30:d=5 hl=2 l= 9 prim: OBJECT :sha256
…
subject=C=UK, ST=Unknown, L=Wetherby, O=Unknown, OU=Unknown, CN=Ciaran Gultnieks
issuer=C=UK, ST=Unknown, L=Wetherby, O=Unknown, OU=Unknown, CN=Ciaran Gultnieks
subject e issuer idénticos: el certificado es autofirmado, como anunciamos en la «sección 1 · Qué es y por qué existe».
El fichero completo mide 1.350 bytes. El certificado es una clave RSA de 2.048 bits firmada con
SHA-1. La salida es la del APK del cliente de F-Droid, extraído en la «sección 10.4 · Ver los ficheros de v1».
3.4 Las debilidades estructurales de v1
No son bugs de implementación: son consecuencias del modelo «firmar entradas».
| Debilidad | Consecuencia |
|---|---|
| No cubre el fichero, cubre entradas | Todo lo que no sea contenido de una entrada queda fuera: los bytes antes del primer Local File Header, los extra field, el Central Directory, el EOCD y el comentario final |
Solo ignora las entradas no listadas de META-INF/ |
Añadir una entrada normal sí se detecta: apksigner responde No digest for res/evil.png in META-INF/MANIFEST.MF. Pero isJarEntryDigestNeededInManifest exime a todo lo que empiece por META-INF/ o acabe en /: las entradas de META-INF/ que no estén en el manifiesto no están protegidas, se pueden añadir sin tocar la firma, y apksigner avisa de cada una |
| El orden y la ambigüedad del ZIP quedan fuera | Nombres duplicados, cabeceras discrepantes, offsets: el ZIP los permite y v1 no los ve |
| Es lento de verificar | Hay que descomprimir cada entrada, calcular su digest y compararlo contra el texto del manifiesto. En un APK de 678 entradas, la mediana de las apps de F-Droid con v1, son 678 descompresiones. La mediana es de unas 3.200 entradas en las más instaladas de Google Play y de unas 9.400 en el mercado chino |
La segunda fila produce los avisos que saca apksigner cuando comprueba v1, es decir, con un
minSdkVersion menor que 24 o en un APK que solo lleva v1. Si estás en ese caso, cuenta con
verlos: salen en 9 de cada 10 apps de todas las fuentes. Cada fichero de META-INF/ que no es de
la firma da un aviso, aunque el manifiesto lo liste. Con minSdkVersion 24 o más y v2 o v3,
apksigner no comprueba v1 y no avisa. Un ejemplo de aviso:
WARNING: META-INF/services/kotlinx.coroutines.CoroutineExceptionHandler not protected by
signature. Unauthorized modifications to this JAR entry will not be detected. Delete or
move the entry outside of META-INF/.
Briar (org.briarproject.briar.android, versión 10522) acumula 68 avisos de esos, uno por cada
fichero de META-INF/ que no es de la firma. No son un fallo del APK: son la descripción exacta
de lo que v1 no cubre. Los que más avisos dan son los *.version de AndroidX (56 de los 68 de
Briar), que llevan casi todas las apps.
La primera fila es la que se explotó de verdad. Janus (CVE-2017-13156) anteponía un DEX
malicioso al APK completo: las entradas del ZIP quedaban intactas, v1 las validaba una a una, y
el runtime cargaba el DEX del principio del fichero. El detalle histórico está en la «sección 12
de Contenedor ZIP · Nota histórica: Master Key y Janus». v2 lo cierra por construcción, y
ese es exactamente su motivo de existir.
Ojo: tener bytes por delante de la primera entrada no es, por sí mismo, un ataque. Hay piezas
legítimas que los llevan (casi siempre 132 bytes) y verifican sin problema con apksigner. Un ejemplo es moe.henry_zhr.kill_domain_verification
(versión 4). Lo que Janus añade es un DEX válido en ese hueco, y v2 lo detecta porque cubre esos
bytes. El análisis completo está en
«Qué rechaza cada lector».
Los canales de distribución. Las tiendas chinas aprovechan los dos huecos de esta sección.
Escriben el nombre del canal como un fichero dentro de META-INF/ (ninguna sección lo cubre) o
como un bloque propio en el APK Signing Block (0x71777777, de Walle, o 0x881155ff, de
VasDolly; v2 no lo cubre, «sección 4.1 · Las dos exclusiones y por qué son necesarias»). Lo habitual es el bloque: aparece en casi un tercio de
las apps del mercado chino y prácticamente en ninguna otra fuente, mientras que el fichero en
META-INF/ es raro. El mercado chino también firma distinto: más de la mitad de sus apps llevan
v1+v2 sin v3, frente a 1 de cada 16 en F-Droid. Los ejemplos son cn.ninegame.gamemanager
(versión 80506001), con un bloque de canal Walle, y com.suning.mobile.ebuy (versión 596), con un
fichero de canal en META-INF/. La presencia no dice quién escribió el canal ni si la tienda lo
reescribe en cada descarga. Más sobre los bloques en «APK Signing Block».
3.5 Qué claves y certificados se usan de verdad
El certificado de una app es casi siempre una clave RSA. Lo que cambia entre tiendas es el tamaño de la clave y la edad de la firma. La tabla da el porcentaje de apps que usa cada clave en su firmante de v3 (el que ven Android 9 a 12L; si no hay v3, el de v2 o el de v1).
| Firmante | F-Droid | IzzyOnDroid | Google Play (más instaladas) | Google Play (sorteo) | Mercado chino |
|---|---|---|---|---|---|
| RSA 2.048 | 91 % | 92 % | 49 % | 24 % | 42 % |
| RSA 4.096 | 8 % | 5 % | 17 % | 66 % | 1 % |
| RSA de menos de 2.048 bits | <1 % | 2 % | 30 % | 9 % | 55 % |
| Certificado firmado con SHA-1 | 3 % | 3 % | 53 % | 14 % | 58 % |
Fuera de RSA quedan unas pocas apps con DSA de 1.024 bits o con EC (P-256, P-384 o P-521). En las más instaladas de Google Play, el 30 % de RSA corto incluye firmas heredadas con rotación («sección 6.3 · La rotación en la práctica»). Si hablas de Android 13 o posterior, el firmante que cuenta es el de v3.1 y las cifras cambian algo.
Fíjate en que apksigner no mira la longitud de la clave ni el algoritmo del certificado.
Verifica las piezas con RSA de menos de 2.048 bits, y también a Keep, cuyo certificado de v3 está
firmado con MD5 (MD5withRSA). Esas claves heredadas no se pueden cambiar sin rotación, que es el
motivo de la «sección 5.2 · El lineage de rotación». Tampoco le importa la fecha: los certificados caducados antes del 19 de
octubre de 2026, primer día de descarga, verifican igual. Hay unas pocas apps firmadas con la clave
de depuración (CN=Android Debug), ninguna con la clave de prueba de AOSP, y bastantes con una
validez de 100 años o más. No afirmamos nada sobre cómo trata Android un certificado caducado ni
una clave corta. Ejemplos:
cn.ninegame.gamemanager(versión 80506001): RSA de 512 bits.org.axpos.lovelaceav(versión 31614, de IzzyOnDroid): EC P-521 conSHA512withECDSA.com.icesu.kinnaid(versión 567): clave de depuración.zatrit.skinbread(versión 6): certificado caducado.moe.henry_zhr.force_dark(versión 2, de IzzyOnDroid): validez de 100 años o más.
4. v2: firma del fichero completo
v2 abandona el modelo de entradas. Divide el APK en cuatro tramos y firma un digest calculado
sobre los bytes, no sobre el contenido lógico:
┌──────────────────────────────────────────────────┐
│ 1. contenido de las entradas ZIP │ ◄── cubierto
│ (offset 0 hasta el inicio del Signing Block) │
├══════════════════════════════════════════════════┤
│ 2. APK Signing Block │ ◄── NO cubierto
├──────────────────────────────────────────────────┤
│ 3. ZIP Central Directory │ ◄── cubierto
├──────────────────────────────────────────────────┤
│ 4. ZIP End of Central Directory │ ◄── cubierto, con excepción
└──────────────────────────────────────────────────┘
La especificación lo formula así: «APK signature scheme v2 protects the integrity of sections
1, 3, 4, and the signed data blocks of the APK signature scheme v2 block».
4.1 Las dos exclusiones y por qué son necesarias
El tramo 2 no se cubre por la razón obvia: el digest vive dentro de él. Lo que sí se protege es
el signed data de cada firmante, que va firmado aparte con su propia clave; el resto del bloque
(otros pares ID-valor, el relleno) queda fuera. La consecuencia práctica es que se pueden añadir
bloques nuevos al APK Signing Block sin invalidar v2.
Es justo lo que hacen el source stamp (el sello de origen), el frosting de Google Play y el
bloque de información de dependencias (0x504b4453). El sello y el frosting están en la mayoría
de las apps de Google Play con bloque y en ninguna de F-Droid. La información de dependencias, en
cambio, no es propia de Google Play: aparece en todas las fuentes, y más en IzzyOnDroid que en
Google Play. No hemos medido quién escribe ese bloque ni por qué. Un ejemplo con sello y frosting es
com.vexostudio.win786 › base.apk; el cliente de F-Droid solo lleva v2, v3 y relleno. Más sobre
cada bloque en «APK Signing Block → §4 · Identificadores de bloque conocidos».
Del tramo 4 se excluye un campo: offset of start of central directory, en el offset 0x10
del EOCD. Es inevitable. Ese campo apunta al Central Directory, y al meter el APK Signing Block delante el valor cambia. Si estuviese cubierto, firmar sería imposible: el digest
dependería de un campo que la propia inserción del digest modifica.
La solución no es ignorar el campo, sino normalizarlo: al calcular y al verificar, se sustituye
por el offset donde empieza el APK Signing Block. ApkSigningBlockUtils.java lo hace así antes
de digerir:
// For the purposes of verifying integrity, ZIP End of Central Directory (EoCD) must be
// treated as though its Central Directory offset points to the start of APK Signing Block.
ZipUtils.setZipEocdCentralDirectoryOffset(modifiedEocd, beforeApkSigningBlock.size());
Así el valor queda determinado por el tamaño del tramo 1, que sí está cubierto, y no hay grado de libertad que explotar. Un verificador que se limite a «saltar 4 bytes» en vez de normalizarlos deja pasar cualquier valor en ese campo.
4.2 Qué gana y qué cuesta
| v1 | v2 | |
|---|---|---|
| Qué cubre | Contenido de las entradas listadas | Todos los bytes salvo la exclusión de 4.1 |
| Añadir una entrada | Posible sin romper la firma | Imposible |
| Prefijo arbitrario (Janus) | Posible | Imposible |
| Coste de verificar | Una descompresión por entrada | Un recorrido lineal del fichero |
| Reempaquetar sin resignar | A veces funciona | Nunca funciona |
Esa última fila es la que hace que la «sección 4 de Alineación y zipalign · El orden importa: alinear ANTES de firmar» exista: con v2, mover un solo byte invalida la firma, y por tanto alinear después de firmar es un error garantizado.
Hay una segunda alineación que también se hace antes de firmar: la de las bibliotecas nativas
(.so) sin comprimir, que en los dispositivos con páginas de memoria de 16 KB tienen que empezar
en un múltiplo de 16.384 bytes. Se explica en «Alineación y zipalign».
La mayoría de las apps con bibliotecas nativas para arm64 ya cumple: con la definición de la guía
de Android, el 82 % en F-Droid y el 86 % en las más instaladas de Google Play. Ojo, que la cifra
depende de la definición: con la del cargador de Android 17, en F-Droid baja al 78 %.
4.3 La protección contra el stripping, desde el otro lado
El bloque v2 lleva un atributo STRIPPING_PROTECTION_ATTR_ID = 0xbeeff00d cuyo valor es el número
del esquema superior con el que también se firmó. Lo hemos medido sobre el base.apk de Google
Keep 5.26.411.03.97 (pieza base.apk de su .apkm) y sobre Termux 1022, y el valor es 3:
attribute 0xbeeff00d STRIPPING_PROTECTION valor=4 B
valor = 3
No es una rareza de estos dos APK: lo llevan prácticamente todas las piezas con v2 y v3, y en
los 125 firmantes v2 en que leímos el valor, es 3. Las que tienen v2 y no v3 no lo llevan, como
corresponde: no hay un esquema superior que anunciar. Las excepciones (v2 y v3 sin el atributo)
son 8 en todo el muestrario; por ejemplo com.craftxbox.yubiclip.xor
(versión 10003, de F-Droid) y org.syrja.speedcrunch (versión 4, de IzzyOnDroid).
Es el hermano binario del X-Android-APK-Signed de la «sección 3.2 · META-INF/CERT.SF», y cumple el mismo papel un
nivel más arriba. Quitar el bloque v3 de un APK que tiene v2 y v3 no cuela, porque el v2, que
sigue validando, declara que debía haber un v3. La demostración está en la «sección 10.3 · La protección contra el downgrade, demostrada».
5. v3: rango de SDK y rotación de clave
v3 es v2 con dos añadidos. La documentación oficial lo resume en una frase: «V3 adds information about the supported SDK versions and a proof-of-rotation struct to the APK signing block».
5.1 minSdkVersion y maxSdkVersion en el signer
Cada firmante declara el rango de versiones de plataforma en el que aplica. Los valores aparecen
dos veces: dentro del signed data, donde están protegidos por la firma, y fuera, a nivel de
signer, «used to skip verification of this signature if the current platform is not in range».
La copia de fuera es una optimización; la de dentro es la autoridad. Un verificador que solo lea
la copia de fuera acepta un rango manipulado.
Volcado real del base.apk de Google Keep 5.26.411.03.97:
bloque v3.1: valor=7613 B, secuencia de signers=7609 B
signer: minSdkVersion=33 maxSdkVersion=2147483647
…
minSdkVersion=33 maxSdkVersion=2147483647 (copia firmada)
bloque v3: valor=1763 B, secuencia de signers=1759 B
signer: minSdkVersion=24 maxSdkVersion=32
…
minSdkVersion=24 maxSdkVersion=32 (copia firmada)
Los dos rangos son contiguos y no se solapan: [24, 32] para el bloque v3 y [33, 2147483647]
para el v3.1. Es la rotación segmentada de la «sección 6 · v3.1: la rotación segmentada por SDK». Y no es solo Keep: en todas las piezas
del muestrario con bloque v3.1, el rango de v3 acaba justo antes de donde empieza el de v3.1, los
dos certificados son distintos, el v3.1 lleva PROOF_OF_ROTATION y la copia de fuera coincide con
la firmada. Ninguna tiene más de un firmante en v3.1. La única con v3.1 desde el nivel 37 es com.oplus.games (10.42.3), con el v3 acabado en el 36.
5.2 El lineage de rotación
El lineage —«glosario»— es la cadena de rotación de certificados:
acredita que una clave nueva sucede legítimamente a una anterior.
El problema que resuelve. Antes de v3, cambiar la clave de firma de una aplicación era
imposible en la práctica: la instalación previa está atada a la clave anterior, así que un APK
firmado con una clave nueva se rechaza como si fuese de otro autor. Y si la clave se ha filtrado, o
se ha perdido, o vive en un HSM que hay que retirar, no había salida.
Cómo lo resuelve. El bloque v3 admite un atributo PROOF_OF_ROTATION_ATTR_ID = 0x3ba06f8c con
una lista enlazada simple de certificados, del más antiguo al más reciente, donde cada nodo está
firmado por la clave del nodo anterior. Cuando el sistema ve un APK firmado con una clave que
no conoce, recorre el lineage. Si encuentra en él el certificado asociado a la instalación, acepta
la sucesión.
Formato exacto, según V3SigningCertificateLineage.java:
uint32 version del lineage (1)
secuencia de nodos, cada uno con prefijo uint32 de longitud:
├─ bytes con prefijo: signed data
│ ├─ bytes con prefijo: certificado X.509 en DER
│ └─ uint32 : id del algoritmo con el que el nodo anterior firmó este
├─ uint32 : flags de capacidad
├─ uint32 : id del algoritmo con el que este nodo firma al siguiente
└─ bytes con prefijo : firma del nodo anterior sobre este signed data
El primer nodo no lleva firma (no hay nodo anterior): su campo de firma mide 0 bytes. Los dos algoritmos se encadenan. El de fuera de un nodo tiene que coincidir con el de dentro del siguiente (la spec v3: «must match the one from the signed data section in the next level»), y es el que se usa para verificar la firma de ese siguiente.
Las capacidades. Cada nodo lleva un uint32 de flags que dice qué sigue pudiendo hacer el
certificado antiguo una vez rotada la clave. Los nombres y los valores salen de
SigningCertificateLineage.java:
| Flag | Valor | Comentario literal del código | Qué significa |
|---|---|---|---|
PAST_CERT_INSTALLED_DATA |
1 | «accept data from already installed pkg with this cert» | Sin esto, la actualización pierde los datos de la instalación anterior |
PAST_CERT_SHARED_USER_ID |
2 | «accept sharedUserId with pkg with this cert» | Mantiene el sharedUserId con paquetes aún firmados con la clave vieja |
PAST_CERT_PERMISSION |
4 | «grant SIGNATURE permissions to pkgs with this cert» | Mantiene los permisos de nivel signature frente a terceros no rotados |
PAST_CERT_ROLLBACK |
8 | «Enable updates back to this certificate» | Peligroso: permite volver a la clave vieja |
PAST_CERT_AUTH |
16 | «Preserve authenticator module-based access in AccountManager» | Conserva el acceso a las cuentas del AccountManager |
El código advierte explícitamente sobre ROLLBACK: «this effectively removes any benefit of
signing certificate changes, since a compromised key could retake control of an app even
after change». Por eso el valor por defecto que construye apksig es
INSTALLED_DATA | PERMISSION | SHARED_USER_ID | AUTH = 0x17, con ROLLBACK apagado.
Los linajes reales no siempre usan ese valor. El del base.apk de Google Keep tiene tres nodos y
ROLLBACK activo en el del medio:
lineage version=1
nodo #1: cert=1095 B sigAlgId=0x0103 RSA_PKCS1_V1_5_WITH_SHA256 sig=0 B
flags=0x00000017 → INSTALLED_DATA|SHARED_USER_ID|PERMISSION|AUTH
nodo #2: cert=1484 B sigAlgId=0x0104 RSA_PKCS1_V1_5_WITH_SHA512 sig=256 B
flags=0x0000001f → INSTALLED_DATA|SHARED_USER_ID|PERMISSION|ROLLBACK|AUTH
nodo #3: cert=1484 B sigAlgId=0x0000 ? sig=512 B
flags=0x00000017 → INSTALLED_DATA|SHARED_USER_ID|PERMISSION|AUTH
Keep ha rotado dos veces. Una clave RSA de 2.048 bits (nodo 1) firma a una de 4.096 (nodo 2) con una
firma de 256 bytes, y esa firma a otra de 4.096 (nodo 3) con una de 512 bytes. El nodo 1 declara el
algoritmo (0x0103) con el que firmará al siguiente y no lleva firma propia; el nodo 3 lleva la
firma y no declara sucesor. El nodo 2, que ya no firma ningún bloque, deja la puerta abierta a
volver a su clave (ROLLBACK). Tres nodos es poco habitual: lo normal es un lineage de dos. Otros APK con ROLLBACK
activo en un nodo del lineage de v3.1 son com.google.android.apps.mapslite (165.0),
com.facebook.lite (534.0.0.7.108, de RSA de 1.024 bits a RSA de 4.096) y el
fabricantes/com.whatsapp/WhatsApp.apk de la web del autor. Cuántas apps activan ROLLBACK en
total no lo sabemos (ver «Lo que no hemos podido comprobar», «sección 1 · Qué es y por qué existe»).
apksigner lineage --print-certs lee el mismo lineage sin escribir código, sobre el base.apk
extraído en la «sección 10.1 · Veredicto por esquema sobre varios APK»:
$BT/apksigner lineage --print-certs --in $SCR/keep_x/base.apk
Signer #1 in lineage certificate DN: CN=Android, OU=Android, O=Google Inc., L=Mountain View, …
Signer #1 in lineage certificate SHA-256 digest: f0fd6c5b410f25cb25c3b53346c8972fae30f8ee7411df910480ad6b2d60db83
Has installed data capability: true
Has shared UID capability : true
Has permission capability : true
Has rollback capability : false
Has auth capability : true
Signer #2 in lineage certificate DN: CN=Android, OU=Android, O=Google Inc., L=Mountain View, …
Signer #2 in lineage certificate SHA-256 digest: 7ce83c1b71f3d572fed04c8d40c5cb10ff75e6d87d9df6fbd53f0468c2905053
Has installed data capability: true
Has shared UID capability : true
Has permission capability : true
Has rollback capability : true
Has auth capability : true
Signer #3 in lineage certificate DN: CN=Android, OU=Android, O=Google Inc., L=Mountain View, …
Signer #3 in lineage certificate SHA-256 digest: e6a1604a39f8c655231f3554870554edabd68c2b837550bdc9bb85a94b65adc5
…las mismas cinco capacidades que el nodo 1, con rollback: false…
Los tres SHA-256 se corresponden con el lineage: f0fd6c5b… es el firmante V3.0, con rango
[24, 32], y e6a1604a…, el V3.1, con [33, INT_MAX]. 7ce83c1b… es la clave intermedia, que ya
no firma ningún bloque. El lineage y los rangos de SDK cuentan la misma historia desde dos sitios
distintos del fichero, y que el último nodo sea el firmante es una de las reglas que se verifican
(«sección 5.2 de APK Signing Block · Rechazos estructurales y reglas del lineage»). La salida de apksigner lineage no
lleva el rango; esa correspondencia sale de apksigner verify («sección 10.1 · Veredicto por esquema sobre varios APK»).
Fíjate en el rollback: true del nodo 2: esta rotación de Google deja abierta la vuelta a esa
clave. Es lo que el código advierte como peligroso y, en el despliegue híbrido de la «sección 7.4 · Rotación implícita y ROLLBACK»,
lo que se pide a propósito.
6. v3.1: la rotación segmentada por SDK
6.1 Por qué se separó de v3
El problema es de compatibilidad hacia atrás. Un dispositivo con Android 9 a 12 entiende el bloque v3: si el desarrollador rota la clave y escribe el nuevo firmante ahí, ese dispositivo intenta usar la clave nueva. Pero antes de Android 13 la plataforma tiene defectos conocidos con la rotación, y el resultado eran fallos de actualización. La documentación lo dice sin rodeos: «The v3.1 scheme addresses some of the known issues with APK Signature Scheme v3 regarding rotation».
La solución es de una simplicidad brutal: el mismo formato, otro identificador de bloque.
«The v3.1 signing block has the same contents as the v3 signing block, but with the new block ID these signatures are recognized only on devices running Android 13 and higher.»
Un Android 12 no conoce 0x1b93ad61, así que lo ignora igual que ignora el relleno. Un Android 13
lo busca primero. Nada más hace falta.
6.2 Cómo conviven los dos bloques
En el mismo APK, a la vez, con rangos de SDK disjuntos:
APK Signing Block
├── 0x1b93ad61 v3.1 → firmante ROTADO , minSdk=33, maxSdk=INT_MAX
├── 0xf05368c0 v3 → firmante ORIGINAL , minSdk=24, maxSdk=32
│ + attr 0x559f8b02 ROTATION_MIN_SDK_VERSION = 33
└── 0x7109871a v2 → firmante ORIGINAL
+ attr 0xbeeff00d STRIPPING_PROTECTION = 3
- Android 13 o superior usa el firmante rotado del bloque v3.1.
- Android 12 o inferior ignora el bloque v3.1 y usa el firmante original del bloque v3.
- Android 7.0 a 8.1 ignora los dos y usa el bloque v2.
El bloque v3 lleva además un atributo de protección: ROTATION_MIN_SDK_VERSION_ATTR_ID = 0x559f8b02. Su valor es el minSdkVersion que debería declarar el bloque v3.1. El comentario de
V3SchemeConstants.java explica la regla:
«If this value is set to X and a v3.1 signing block does not exist, or the minimum SDK version for rotation in the v3.1 signing block is not X, then the APK should be rejected.»
En Keep vale 33, y el bloque v3.1 declara minSdkVersion=33. Cuadra. Así que quitar el bloque
v3.1 para forzar que un Android 13 use la clave vieja no funciona: el bloque v3, que sigue
validando, exige que exista. Pasa lo mismo en todas las piezas del muestrario con bloque v3.1: el
firmante v3 lleva 0x559f8b02 con el mismo mínimo que el v3.1, y ninguna lleva v3.1 sin v3. Una
anomalía aparte: en
fabricantes/com.whatsapp/WhatsApp.apk el identificador 0x1b93ad61 aparece dos veces en el
bloque, así que no hay que dar por hecho que un identificador no se repite.
Y hay una regla simétrica en ApkVerifier.java: un bloque v3.1 sin bloque v3 es un error,
Issue.V31_BLOCK_FOUND_WITHOUT_V3_BLOCK, «as a v3.1 signature is intended to support key
rotation on T+ with the v3 signature containing the original signing key».
6.3 La rotación en la práctica
La rotación existe, pero la hacen sobre todo las apps grandes de Google Play: casi una de cada diez
de las más instaladas tiene bloque v3.1. En el resto de fuentes es rara. El mercado chino es un
caso aparte: rota algo más de una app de cada diez, pero casi siempre con el lineage en el
bloque v3 y sin bloque v3.1. En F-Droid rota 1 app (dev.lexip.hecate, versión 139) y en
IzzyOnDroid, otra.
En las apps de Google Play con v3.1, la clave nueva lleva a menudo el nombre de Play App Signing
(«sección 1 · Qué es y por qué existe»). El caso típico es pasar de una clave RSA de 2.048 o de 1.024 bits a una de 4.096.
Pero la rotación no siempre refuerza la clave: com.larus.wolf (13.0.0, pieza base.apk)
pasa de RSA de 4.096 a RSA de 2.048 bits. No hemos medido por qué rotan; el nombre de la clave
nueva es solo una pista. Ejemplos:
de.systembau.prourlaubapp›base.apk: v3.1, de RSA 1.024 a RSA 4.096, hacia Play App Signing.com.google.android.apps.mapslite(165.0): de Play App Signing a Play App Signing, con tres nodos.
Los detalles de qué permite cada nodo están en la «sección 5.2 · El lineage de rotación».
7. v3.2: la firma híbrida
Android 17 (API 37) añade un tercer bloque a la familia v3 para la transición a la criptografía
poscuántica. El APK se firma a la vez con una clave clásica y con una ML-DSA, y el
verificador exige las dos. Para falsificarlo habría que romper los dos algoritmos, así que ML-DSA
se despliega sin apostarlo todo a un algoritmo recién estandarizado.
El CDD de Android 17 lo hace obligatorio (requisito 4 [C-0-2]: «MUST support verifying ".apk"
files using APK Signature Scheme v3.2, […]»). En AOSP depende del flag
android.security.apk_pqc_hybrid_signing, que la configuración cp2a de android-17.0.0_r1
(la de aosp_current) deja ENABLED y READ_ONLY. Las dos cosas no se contradicen. El requisito
del CDD se dirige a las implementaciones de dispositivo («Devices implementations»): obliga al
fabricante que quiera un Android 17 compatible. El flag es el mecanismo con el que AOSP enciende
el código: ApkSignatureSchemeV3Verifier solo busca el bloque v3.2 si
android.security.Flags.apkPqcHybridSigning() devuelve true.
Android 16 y anteriores no conocen 0x70e1c89f y se lo saltan. Para instalarse en ellos, el APK
tiene que llevar además un bloque v3.0 o v3.1 firmado con una sola clave clásica; Android 17
acepta uno que solo lleve el bloque híbrido.
El bloque ya está en el campo, aunque todavía poco: lo llevan 34 piezas de 9 apps del sorteo de
Google Play (un 2 % de sus apps), y ninguna app de las demás fuentes. Todas vienen de carpetas de
adb, y son la base y los splits de apps como com.vexostudio.win786. Las 34 llevan además v2 y
un bloque v3 con la clave original, como recomienda la documentación, y los dos atributos del
bloque v3 que anuncian el híbrido desde el nivel 37. Así sirven a Android 16 y anteriores sin
cambios y a Android 17 con la firma poscuántica. Ninguna lleva ML-DSA en v2, v3 ni v3.1. Las 9
apps son com.LiiKrass.BrawlBoxSimulator, com.astropeak.congklak,
com.chatakmovie.app, com.clarkstudio.idl, com.coddykit.corruptstate, com.phasora,
com.ragdollsurvival.forestnight, com.verato.securevpn y com.vexostudio.win786.
7.1 El bloque 0x70e1c89f
El formato es el de v3.0 sin un byte distinto: lo escribe el mismo V3SchemeSigner con otro
identificador, y cada firmante tiene la estructura de la «sección 5 de
APK Signing Block · Estructura interna de un bloque v2 o v3». Cambian tres reglas:
- Exactamente dos firmantes, uno clásico y otro ML-DSA.
apksigescribe primero el clásico, pero el orden no importa: cada uno se clasifica por la clave de su primer certificado, que es PQC si su algoritmo esML-DSAo uno de los OID de ML-DSA. - El mismo rango de SDK en los dos, en la copia firmada y en la de fuera.
lineageen los dos, con la misma historia salvo el último nodo («sección 7.4 · Rotación implícita y ROLLBACK»).
| Firmante | Algoritmo | Digest de contenido | Clave |
|---|---|---|---|
| Clásico | El que v3 elige para la clave: 0x0103/0x0104 (RSA), 0x0201/0x0202 (ECDSA), 0x0301 (DSA) |
CHUNKED_SHA256 o CHUNKED_SHA512 |
RSA, EC o DSA |
| PQC | 0x0501 ML_DSA |
CHUNKED_SHA512 |
ML-DSA-65 o ML-DSA-87 |
ML-DSA-65 y ML-DSA-87 comparten el identificador 0x0501. El conjunto de parámetros va en el
OID del SubjectPublicKeyInfo: 2.16.840.1.101.3.4.3.18 y 2.16.840.1.101.3.4.3.19. En el
dispositivo la clave la decodifica Conscrypt, que solo admite esos dos: «Only ML-DSA-65 and
ML-DSA-87 are currently supported». apksig no lo comprueba y firma y verifica con ML-DSA-44.
Los atributos que protegen el bloque no van dentro de él, sino en otros firmantes:
| ID | Nombre en apksig |
Dónde | Valor |
|---|---|---|---|
0xbf940529 |
HYBRID_MIN_SDK_VERSION_ATTR_ID |
Firmantes v3.0 y v3.1 | int32 LE: SDK mínimo del bloque v3.2 |
0x9f06b79c |
HYBRID_MAX_SDK_VERSION_ATTR_ID |
Firmantes v3.0 y v3.1 | int32 LE: SDK máximo del bloque v3.2 |
0xc2a6b3ba |
SIGNER_TARGETS_DEV_RELEASE_ATTR_ID |
Firmantes v3.1 y v3.2 | Vacío: apunta a una release en desarrollo |
Las constantes están en V3SchemeConstants.java de apksig en la etiqueta android-17.0.0_r1, no
en la rama main, congelada desde marzo de 2025. MIN_SDK_WITH_V32_SUPPORT vale
AndroidSdkVersion.C, es decir, 37. Este es el volcado con -v del volcador de la «sección 9 de
APK Signing Block · El volcador», de un APK de prueba —no del muestrario— firmado el
18 de octubre de 2026 con la receta de la «sección 7.5 · Receta: firmar y verificar con apksigner 37.0.0» (K0, RSA de 2048 bits, en v2 y v3.0; C_K1, EC
P-256, y PQC_K1, ML-DSA-65, en v3.2). El primer «…» omite la lista de pares y el bloque v2:
…
bloque v3.2: valor=19953 B, secuencia de signers=19949 B
signer: minSdkVersion=36 maxSdkVersion=2147483647
signed data: digests=44 B certs=412 B attrs=1544 B
digest alg=0x0201 ECDSA_WITH_SHA256 32 B 1a192d15de6e312096d43c23…
certificate X.509 DER: 408 B
minSdkVersion=36 maxSdkVersion=2147483647 (copia firmada)
attribute 0x3ba06f8c PROOF_OF_ROTATION valor=1528 B
lineage version=1
nodo #1: cert=804 B sigAlgId=0x0103 RSA_PKCS1_V1_5_WITH_SHA256 sig=0 B
flags=0x0000001f → INSTALLED_DATA|SHARED_USER_ID|PERMISSION|ROLLBACK|AUTH
nodo #2: cert=408 B sigAlgId=0x0000 ? sig=256 B
flags=0x00000017 → INSTALLED_DATA|SHARED_USER_ID|PERMISSION|AUTH
attribute 0xc2a6b3ba SIGNER_TARGETS_DEV_RELEASE valor=0 B
signature alg=0x0201 ECDSA_WITH_SHA256 71 B
public key SubjectPublicKeyInfo DER: 91 B
signer: minSdkVersion=36 maxSdkVersion=2147483647
signed data: digests=76 B certs=5592 B attrs=6724 B
digest alg=0x0501 ML_DSA 64 B 8e6218795f02b417ad8b8300…
certificate X.509 DER: 5588 B
minSdkVersion=36 maxSdkVersion=2147483647 (copia firmada)
attribute 0x3ba06f8c PROOF_OF_ROTATION valor=6708 B
lineage version=1
nodo #1: cert=804 B sigAlgId=0x0103 RSA_PKCS1_V1_5_WITH_SHA256 sig=0 B
flags=0x0000001f → INSTALLED_DATA|SHARED_USER_ID|PERMISSION|ROLLBACK|AUTH
nodo #2: cert=5588 B sigAlgId=0x0000 ? sig=256 B
flags=0x00000017 → INSTALLED_DATA|SHARED_USER_ID|PERMISSION|AUTH
attribute 0xc2a6b3ba SIGNER_TARGETS_DEV_RELEASE valor=0 B
signature alg=0x0501 ML_DSA 3309 B
public key SubjectPublicKeyInfo DER: 1974 B
bloque v3: valor=1474 B, secuencia de signers=1470 B
…
attribute 0xbf940529 HYBRID_MIN_SDK_VERSION valor=4 B
valor = 36
Fíjate en lo que pesa. El APK sin firmar mide 755 bytes y el firmado 29.006. La firma ML-DSA-65
ocupa 3.309 bytes y la clave 1.952, 1.974 con la envoltura del SubjectPublicKeyInfo (con
ML-DSA-87, 4.627 y 2.592). Y el certificado PQC va dos veces, en la secuencia de certificados y
al final del lineage. K0 lleva
ROLLBACK (0x1f) en los dos lineages, como pide la receta («sección 7.4 · Rotación implícita y ROLLBACK»). El minSdkVersion=36
con 0xc2a6b3ba y la falta de 0x9f06b79c son cosa de apksigner 37.0.0 («sección 7.5 · Receta: firmar y verificar con apksigner 37.0.0»).
Un APK real de Google Play tiene el mismo formato. El base.apk de com.vexostudio.win786
(7.166.961 bytes) lleva un bloque v3.2 de 24.737 bytes con dos firmantes: uno clásico, RSA de 4.096
bits con el algoritmo 0x0104 (RSA PKCS#1 v1.5 con SHA-512), y otro PQC, con 0x0501 (ML-DSA) y el
OID 2.16.840.1.101.3.4.3.18, es decir, ML-DSA-65. Los dos tienen el rango [37, 2147483647]. Las
34 piezas del muestrario son iguales en esto: 0x0104 y 0x0501, ML-DSA-65, y un certificado de
v3 distinto del de v3.2. Respecto al APK de prueba cambian tres cosas:
el clásico es RSA de 4.096 bits con SHA-512 y no EC P-256, el rango empieza en 37 y no en 36, y el
v3 que lo acompaña lleva los dos atributos, 0xbf940529 = 37 y 0x9f06b79c = 2147483647. Los dos
lineages empiezan por la misma clave clásica K0, con ROLLBACK (0x1f), como pide la receta de la
«sección 7.4 · Rotación implícita y ROLLBACK». El volcado completo con -v de esta pieza no lo hemos hecho con el volcador publicado
(ver «Lo que no hemos podido comprobar», «sección 1 · Qué es y por qué existe»).
7.2 Cómo se verifica
Todo lo de esta sección está leído en el código de android-17.0.0_r1. No hemos podido ejecutarlo
en un Android 17: su imagen de emulador no arranca en nuestra máquina de referencia
(«El muestrario → §8 · La máquina de referencia»).
La plataforma sigue probando v4, v3, v2 y v1, pero dentro de v3 ApkSignatureSchemeV3Verifier.verify
prueba ahora v3.2, luego v3.1 y por último v3.0. Los dos primeros se saltan si no están o si
ninguno de sus firmantes cubre el SDK del dispositivo. Si el que aplica falla, el APK se rechaza
con INSTALL_PARSE_FAILED_NO_CERTIFICATES. Cada firmante del v3.2 pasa la verificación v3 normal de la
«sección 5 · v3: rango de SDK y rotación de clave» y, además:
| Comprobación | Mensaje de la plataforma | Issue de apksig |
|---|---|---|
| Dos firmantes | APK Signature Scheme V3.2 supports exactly two signers; N found |
V32_MISSING_DUAL_SIGNERS |
| Uno clásico y uno PQC | …requires one classical and one PQC signer; both are PQC |
V32_INCORRECT_ALGORITHM_PAIR |
| Mismo rango de SDK | …requires both signers target the same SDK range; classical: a-b, PQC: c-d |
V32_SIG_INCONSISTENT_SDK_TARGETING |
| Lineage en los dos, con los mismos certificados | …requires both signers have the same signing history, but […] |
V32_SIG_LINEAGE_MISMATCH_* |
| Mismas capacidades | …but the capabilities diverge at index i |
V32_SIG_LINEAGE_MISMATCH_IN_CAPABILITIES |
| Digests iguales si comparten algoritmo | SHA-512 contents digest does not match the digest specified by a preceding signer |
— |
Superado eso, la integridad se comprueba con todos los digests de los dos (con un clásico
P-256, SHA-256 y SHA-512), y la identidad del paquete pasa a ser el firmante PQC:
SigningDetails guarda sus certificados con la versión menor MINOR_VERSION_32_HYBRID (2).
Un firmante PQC en solitario no vale fuera del bloque híbrido: en v3.0 y v3.1 la plataforma
responde The platform does not currently support single PQC signers in the v3 signature blocks.
La documentación extiende la regla a v2 («The platform doesn't verify a single-signer PQC
configuration using previous signature schemes, such as v2, v3.0, or v3.1»), pero el código de la
etiqueta no la aplica: ApkSigningBlockUtils.java, que comparten v2 y v3, acepta
SIGNATURE_ML_DSA = 0x0501 con el flag activo (líneas 154-158 y 446) y lo traduce a
CHUNKED_SHA512, a una clave ML-DSA y a una firma ML-DSA (515-519, 568-572 y 614-618), y
ApkSignatureSchemeV2Verifier elige y verifica la firma con esas funciones sin ninguna
comprobación de PQC (243-298). Según el código, un APK cuya única firma sea un bloque v2 con
ML-DSA verifica en Android 17.
Ojo: un fallo de verificación puede ser del JDK y no del APK. apksigner 37.0.0 con Java 21
no sabe leer una clave ML-DSA (llegó al JDK con la versión 24). Con Java 21.0.10 rechaza las 34
piezas del muestrario con v3.2, aunque sus bloques v2 y v3 estén intactos, porque un bloque
superior presente tiene que validar («sección 8 · Qué esquema exige o admite cada nivel de API»):
DOES NOT VERIFY
ERROR: The APK contains a v3.2 signature block, but an error was encountered with one of the hybrid signers
ERROR: APK Signature Scheme v3.2 Hybrid PQC signer: (minSdkVersion=37, maxSdkVersion=2147483647): Malformed public key: java.security.NoSuchAlgorithmException: ML-DSA KeyFactory not available
Con Java 25.0.5, las mismas 34 verifican. Un ejemplo es com.vexostudio.win786 › base.apk; otro,
el split com.astropeak.congklak › split_config.xxhdpi.apk. El comando para repetirlo con un JDK
25 está en la «sección 10 · Recetas».
7.3 La protección contra el stripping
El bloque v3.0 o v3.1 que acompaña al híbrido declara sus límites: 0xbf940529 con el
minSdkVersion del v3.2 y 0x9f06b79c con el maxSdkVersion. Android 17 los mira cuando acaba
verificando con v3.0 o v3.1. Si los firmantes del v3.2 quedaban fuera del rango del dispositivo,
compara ese rango con los atributos: Expected a v3.2 signing block targeting min SDK version X, but the v3.2 block was targeting Z, y lo mismo con el máximo. Si no hay bloque v3.2: Expected a v3.2 signing block targeting SDK version X to Y, but a v3.2 block was not found. El máximo es
opcional, pero un máximo sin mínimo es un error.
El máximo existe para que el híbrido pueda dejar de usarse: un APK puede declararlo hasta la
API Y y volver a un firmante único desde Y+1, sin que nadie recorte el rango. Android 16 y
anteriores ignoran estos atributos, y no les hace falta más: nunca usaron el bloque v3.2.
Esto es lo que pasa si quitas el bloque v3.2 del APK de la «sección 7.5 · Receta: firmar y verificar con apksigner 37.0.0» (con el relleno ampliado
para no mover un byte fuera del bloque, como en la «sección 10.3 · La protección contra el downgrade, demostrada»):
DOES NOT VERIFY
ERROR: APK Signature Scheme v3 signer #1: The v3.0 signer indicates a hybrid signer should be
supported starting from SDK version 36, but a v3.2 block was not found
Con --max-sdk-version 36 el mismo fichero verifica: para Android 16 y anteriores es correcto.
Las 34 piezas del muestrario con v3.2 anuncian el híbrido en su bloque v3 con los dos atributos:
0xbf940529 = 37 y 0x9f06b79c = 2147483647 en las 34, es decir, sin tope. apksigner 37.0.0
da 0x9f06b79c por atributo desconocido. La prueba de quitar el bloque v3.2 la hicimos con el
APK de prueba y no la hemos repetido sobre las piezas reales.
7.4 Rotación implícita y ROLLBACK
El bloque híbrido es una rotación. La plataforma arma el lineage del paquete con la historia
del firmante clásico, que acaba en la clave clásica nueva, y pone detrás el certificado PQC:
[K0, …, C_K1, PQC_K1]. La documentación: «appends the new classical key to the app's existing
signing lineage as the next-to-last key, and treats the new PQC key as the app's current signing
identity». Por eso los dos lineages tienen que coincidir salvo el último nodo, en certificados y
en capacidades. Sin lineage, la plataforma usa [C_K1, PQC_K1] con las capacidades por defecto,
0x17. Reglas de actualización de SigningDetails (las dos últimas filas son la regla «New key
material»: las claves del híbrido tienen que ser nuevas):
| Instalado | Actualización | Se acepta si |
|---|---|---|
| K0 (v3.0 o v3.1) | K0 + bloque v3.2 | K0 está en los dos lineages híbridos, con INSTALLED_DATA |
| Híbrido | Otro híbrido | C_K1 y PQC_K1 están en los dos lineages nuevos |
| Híbrido | Firmante único nuevo | C_K1 y PQC_K1 están en su lineage |
| Híbrido | C_K1 o PQC_K1 como firmante único | Nunca: reutilización de clave |
| K0 | Híbrido que usa K0 como clave clásica | Nunca: reutilización de clave |
ROLLBACK. Durante el despliegue, la documentación recomienda concedérsela a K0, la clave
clásica original, en el lineage del bloque híbrido. Así se pueden volver a publicar versiones
firmadas solo con K0 si algo falla; luego se retira cuando el despliegue esté asentado. La
actualización firmada con K0 entra por la segunda condición de
PackageManagerServiceUtils.verifySignatures: que la firma instalada conceda ROLLBACK a la
nueva.
Google Play hace lo que recomienda la documentación: en los dos lineages de cada una de las 34
piezas con v3.2, K0 lleva ROLLBACK (0x1f) y la clave nueva, 0x17. Solo vemos el estado entre
el 19 y el 27 de octubre de 2026: no sabemos si Google lo retirará cuando asiente el despliegue.
Dos detalles que no están en la guía:
- Hay que ponerla en los dos lineages, porque las capacidades de K0 tienen que coincidir.
apksignerno lo comprueba al firmar, y luego rechaza el resultado conThe signers in the v3.2 block don't have the same capabilities in their history starting from index 0. - Concedérsela a C_K1 no sirve: volver a una de las claves híbridas es reutilización, tenga o
no
ROLLBACK. La prueba CTS lo dice así: «an update APK signed with one of the hybrid keys should fail the roll back attempt, even if the hybrid key has been granted the ROLLBACK capability».
7.5 Receta: firmar y verificar con apksigner 37.0.0
Hace falta un JDK con ML-DSA, que llegó con Java 24 (JEP 497). El apksigner.jar trae las clases
de Conscrypt pero no su biblioteca nativa, así que con Java 21 falla la firma, y también la
verificación de un híbrido válido, con ML-DSA KeyFactory not available. La clave la genera
OpenSSL 3.5 o posterior, pero tiene que ir en la forma priv-only: con la de por defecto,
apksigner responde Not an RSA, EC, DSA, or ML-DSA private key. Lo ejecutamos el 25 de septiembre de 2026, y de nuevo el 18 de octubre con la
misma salida, con Temurin 25.0.2 y OpenSSL 3.6.3:
BT=~/Library/Android/sdk/build-tools/37.0.0
export PATH=~/.sdkman/candidates/java/25.0.2-tem/bin:$PATH # un JDK 24 o posterior
apks() { "$BT/apksigner" -J-enable-native-access=ALL-UNNAMED "$@"; }
OSSL=/opt/homebrew/opt/openssl@3/bin/openssl
keytool -genkeypair -keystore k0.p12 -storetype PKCS12 -alias k0 -keyalg RSA -keysize 2048 \
-validity 10000 -storepass pruebas -dname "CN=K0 clasica original, O=Ejemplo, C=ES"
keytool -genkeypair -keystore c_k1.p12 -storetype PKCS12 -alias c_k1 -keyalg EC \
-groupname secp256r1 -validity 10000 -storepass pruebas \
-dname "CN=C_K1 clasica hibrida, O=Ejemplo, C=ES"
$OSSL genpkey -algorithm ML-DSA-65 -out pqc_k1.pem
$OSSL req -new -x509 -key pqc_k1.pem -out pqc_k1.crt -days 10000 \
-subj "/CN=PQC_K1 ML-DSA-65/O=Ejemplo/C=ES"
$OSSL pkcs8 -topk8 -nocrypt -in pqc_k1.pem -outform DER -out pqc_k1.pk8 \
-provparam ml-dsa.output_formats=priv-only
apks rotate --out lin_c.bin --old-signer --ks k0.p12 --ks-pass pass:pruebas \
--set-rollback true --new-signer --ks c_k1.p12 --ks-pass pass:pruebas
apks rotate --out lin_p.bin --old-signer --ks k0.p12 --ks-pass pass:pruebas \
--set-rollback true --new-signer --key pqc_k1.pk8 --cert pqc_k1.crt
apks sign --out hibrido.apk --ks k0.p12 --ks-pass pass:pruebas \
--next-signer --hybrid-signer-role classical --ks c_k1.p12 --ks-pass pass:pruebas \
--signer-lineage lin_c.bin \
--next-signer --hybrid-signer-role pqc --key pqc_k1.pk8 --cert pqc_k1.crt \
--signer-lineage lin_p.bin sin_firmar.apk
apks verify -v --print-certs hibrido.apk | grep -E 'v3\.2 scheme|Hybrid .*(DN|algorithm)'
Verified using v3.2 scheme (APK Signature Scheme v3.2): true
V3.2 Hybrid Classical Signer: (minSdkVersion=36 (dev release=true), maxSdkVersion=2147483647) certificate DN: CN=C_K1 clasica hibrida, O=Ejemplo, C=ES
V3.2 Hybrid Classical Signer: (minSdkVersion=36 (dev release=true), maxSdkVersion=2147483647) key algorithm: EC
V3.2 Hybrid PQC Signer: (minSdkVersion=36 (dev release=true), maxSdkVersion=2147483647) certificate DN: C=ES, O=Ejemplo, CN=PQC_K1 ML-DSA-65
V3.2 Hybrid PQC Signer: (minSdkVersion=36 (dev release=true), maxSdkVersion=2147483647) key algorithm: ML-DSA
El primer firmante, sin papel, es K0: firma v1, v2 y v3.0. Los dos con --hybrid-signer-role
forman el bloque v3.2, cada uno con su --signer-lineage.
La misma orden sobre un APK real de Google Play del muestrario, com.vexostudio.win786 ›
base.apk, con Temurin 25.0.2 y apksigner verify --verbose --print-certs:
Verifies
Verified using v1 scheme (JAR signing): true
Verified using v2 scheme (APK Signature Scheme v2): true
Verified using v3 scheme (APK Signature Scheme v3): true
Verified using v3.1 scheme (APK Signature Scheme v3.1): false
Verified using v3.2 scheme (APK Signature Scheme v3.2): true
Verified using v4 scheme (APK Signature Scheme v4): false
Verified for SourceStamp: true
Number of signers: 1
V3.2 Hybrid Classical Signer: (minSdkVersion=37, maxSdkVersion=2147483647) certificate DN: CN=Android, OU=Android, O=Google Inc., L=Mountain View, ST=California, C=US
V3.2 Hybrid Classical Signer: (minSdkVersion=37, maxSdkVersion=2147483647) key algorithm: RSA
V3.2 Hybrid PQC Signer: (minSdkVersion=37, maxSdkVersion=2147483647) certificate DN: CN=Android, OU=Android, O=Google Inc., L=Mountain View, ST=California, C=US
V3.2 Hybrid PQC Signer: (minSdkVersion=37, maxSdkVersion=2147483647) key algorithm: ML-DSA
Mismo formato que en la receta. Aquí el minSdkVersion es 37 y no 36, y no lleva la marca
dev release. La línea de v1 es true porque esa pieza declara minSdkVersion 23.
Estado en apksigner 37.0.0. Lo que sigue es de esta versión de la herramienta, no del formato
de las «secciones 7.1 · El bloque 0x70e1c89f» a 7.4, y puede cambiar con la siguiente:
- Sin un
--signer-lineagepara cada firmante híbrido, termina con unNullPointerExceptionenDefaultApkSignerEngine.createHybridSignerConfig. - Se compiló con Android 17 aún en desarrollo (
DEV_RELEASE = 37,PROD_RELEASE = 36): por eso escribeminSdkVersion=36con0xc2a6b3bayHYBRID_MIN_SDK_VERSION = 36, y no conoce0x9f06b79cni--hybrid-max-sdk-version. Compilado desde la etiquetaandroid-17.0.0_r1,apksigescribe 37 y los dos atributos. Según el código, Android 17 acepta las dos variantes. apksigner lineage --in hibrido.apkno lee los lineages del bloque v3.2: solo mira v3.1 y v3.0, y aquí respondeThe provided APK does not contain a valid lineage.- Genera el
.idsigde v4 con un solosigningInfo, firmado con K0: elV4SchemeSignerdeandroid-17.0.0_r1solo sabe añadir el bloque de v3.1 («sección 4 de Firma v4 y verificación · v4 no se sostiene sola»). La plataforma, en cambio, cuando el bloque v3 que ha leído es el v3.2, busca en el.idsigun bloque para0x70e1c89fy, sin él, rechaza la firma v4 (ApkSignatureSchemeV4Verifier.java, líneas 160-179): según el código, la instalación incremental de esteAPKen Android 17 falla.
8. Qué esquema exige o admite cada nivel de API
| Nivel de API | v1 | v2 | v3 | v3.1 | v3.2 | v4 |
|---|---|---|---|---|---|---|
| 1 – 23 | Único posible | Ignorado | Ignorado | Ignorado | Ignorado | Ignorado |
| 24 – 27 (7.0–8.1) | Admitido | Preferido | Ignorado | Ignorado | Ignorado | Ignorado |
| 28 – 29 (9–10) | Admitido | Admitido | Preferido | Ignorado | Ignorado | Ignorado |
| 30 – 32 (11–12L) | Insuficiente si targetSdk ≥ 30 |
Admitido | Preferido | Ignorado | Ignorado | Admitido |
| 33 – 36 (13–16) | Insuficiente si targetSdk ≥ 30 |
Admitido | Admitido | Preferido | Ignorado | Admitido |
| 37 y superiores (17+) | Insuficiente si targetSdk ≥ 30 |
Admitido | Admitido | Admitido | Preferido si su rango lo cubre | Admitido |
Desde la 37, si el APK trae un bloque v3.2 cuyo rango de SDK cubre el del dispositivo, se verifica
ese bloque y ningún otro; si no lo cubre, se cae a v3.1 o v3.0, que comprueban los atributos contra
el stripping («sección 7.3 · La protección contra el stripping»). Los dispositivos anteriores lo ignoran.
Reglas duras que hay detrás de la tabla:
targetSdkVersion≥ 30 obliga a v2 o superior. Literal de developer.android.com: «Apps that target Android 11 (API level 30) that are currently only signed using APK Signature Scheme v1 must now also be signed using APK Signature Scheme v2 or higher. Users can't install or update apps that are only signed with APK Signature Scheme v1 on devices that run Android 11».minSdkVersion< 24 obliga a v1. No hay alternativa: esas plataformas no miran elAPK Signing Block.- «Preferido» significa que los inferiores no se comprueban. Si hay un esquema superior válido
para el rango, el sistema no verifica los de abajo. Eso es lo que produce la salida de la
«sección 10.1 · Veredicto por esquema sobre varios APK», donde un
APKcon bloque v2 presente sale comov2: false. - Un esquema superior presente obliga a que valide. Si el bloque v3 está y no verifica, el
APKse rechaza; no se cae a v2.ApkVerifierlo hace devolviendo el resultado en cuantoresult.containsErrors(). El detalle está en «Firma v4 y verificación → §5.2 · Las reglas, en orden».
En la práctica, las bases cumplen las dos: ninguna app con targetSdkVersion 30 o más está firmada
solo con v1, y todas las que tienen minSdkVersion menor que 24 llevan v1. Los splits son la
excepción. Hay 93 splits de 6 apps de Microsoft y de Mi Browser, todos de contenedores .apkm de
APKMirror, que no llevan v1 ni declaran minSdkVersion. Sin ese dato, apksigner supone 1 y exige
v1; con el --min-sdk-version de su base (33 o 30) verifican los 93, igual que las bases. Un
ejemplo es el split_config.uk.apk del .apkm de com.microsoft.office.powerpoint
(16.0.20611.20014). No hemos probado la instalación real de esos splits.
9. Por qué un APK moderno lleva v1+v2+v3 (y cuándo se puede omitir v1)
La recomendación oficial es acumular: «sign apps with all schemes, first with v1, then v2, and then v3». El motivo es que cada esquema lo entiende un tramo de versiones distinto y ninguno es un superconjunto del otro en cobertura de dispositivos.
apksigner decide qué esquemas aplica a partir de --min-sdk-version y --max-sdk-version, y por
defecto toma el minSdkVersion del manifiesto:
«By default,
apksigneruses the value of theminSdkVersionattribute from the app's manifest file.»
v1 se puede omitir cuando minSdkVersion ≥ 24, porque a partir de ahí todo dispositivo entiende
v2. Pero apksigner no lo omite por su cuenta: escribe v1 por defecto con cualquier
minSdkVersion, y para omitirlo hay que pedir --v1-signing-enabled false. Su ayuda dice que lo
decide «based on min and max SDK version», pero la opción vale true si no se indica
(ApkSignerTool.java, línea 146). apksigner 37.0.0, sobre un APK de prueba con
minSdkVersion 32, escribe META-INF/K0.SF, K0.RSA y MANIFEST.MF.
Llevarlo no rompe nada, pero tampoco aporta: añade un esquema con las debilidades de la «sección 3.4 · Las debilidades estructurales de v1»
para cualquier lector que lo consulte. Y sobra a menudo. Más de la mitad de las apps de F-Droid con
minSdkVersion 24 o más la llevan (las firmadas con la clave que genera F-Droid, todas), y en el
mercado chino, la mayoría. En peso cuesta poco: en el cliente de F-Droid, los tres ficheros
comprimidos son 76.527 bytes de 12.569.951 (0,6 %). Cuatro APK con nombre muestran el reparto:
APK |
minSdkVersion |
v1 | v2 | v3 |
|---|---|---|---|---|
org.briarproject.briar.android_10522.apk |
21 | ✅ | ✅ | ❌ |
org.fdroid.fdroid_2000052.apk |
24 | ✅ (ficheros presentes) | ✅ | ✅ |
com.termux_1022.apk |
24 | ✅ (ficheros presentes) | ✅ | ✅ |
base.apk de Google Keep 5.26.411.03.97 |
30 | ❌ | ✅ (bloque presente) | ✅ + v3.1 |
Ojo con la última fila: Keep tiene bloque v2, pero apksigner informa v2: false porque con
minSdkVersion 30 ese bloque nunca se usa: el bloque v3 cubre todo el rango. Lo mismo pasa con v1
en las filas 2 y 3: los ficheros están, pero con minSdkVersion 24 apksigner no los comprueba.
Que un esquema no se verifique no significa que no esté. Es la distinción entre el binario y
el veredicto, y confundirlas es el error más frecuente al leer la salida de apksigner. Y lo
vas a ver a menudo: pasa en 4 de cada 10 apps de F-Droid con v1, y en 4 de cada 10 piezas con v2
de las más instaladas de Google Play.
9.1 El reparto de combinaciones por estrato
La tabla da, para cada fuente, qué combinación de esquemas lleva la pieza base o única, en
porcentaje de apps. «Lleva» quiere decir que el bloque o los ficheros están, no que apksigner los
verifique.
| Combinación | F-Droid | IzzyOnDroid | Google Play (más instaladas) | Google Play (sorteo) | Mercado chino |
|---|---|---|---|---|---|
| v1+v2+v3 | 62 % | 16 % | 28 % | 28 % | 35 % |
| v2 | 21 % | 47 % | 3 % | 3 % | 5 % |
| v1+v2 | 6 % | 35 % | 6 % | 8 % | 57 % |
| v2+v3 | 2 % | 1 % | 52 % | 58 % | 1 % |
| solo v1 | 8 % | 1 % | 1 % | 0 % | 1 % |
| solo v3 | <1 % | <1 % | 1 % | 0 % | 0 % |
| v2+v3+v3.1 | 0 % | 0 % | 8 % | 1 % | 0 % |
| v1+v2+v3+v3.1 | 0 % | 0 % | 2 % | <1 % | 1 % |
| v2+v3+v3.2 | 0 % | 0 % | 0 % | 2 % | 0 % |
| v1+v2+v3+v3.2 | 0 % | 0 % | 0 % | 1 % | 0 % |
Lo que más pesa en el reparto es el minSdkVersion. Con menos de 24, lo normal es v1+v2+v3, salvo
en IzzyOnDroid, donde mandan v1+v2. Con 24 a 27 desaparece v1: en F-Droid e IzzyOnDroid abunda la
v2 sola, y en Google Play, v2+v3.
9.2 Las apps divididas y los contenedores
Una app de Google Play suele llegar en varias piezas: una base y varios splits (de arquitectura,
idioma y densidad). Android las instala juntas solo si todas llevan la misma firma, y en el
muestrario se cumple sin excepciones: todas las piezas de una app tienen el mismo paquete, el mismo
versionCode y el mismo certificado. Lo que cambia de una pieza a otra son los esquemas. Todas
llevan v3. v2 falta en algún split de 7 apps (Microsoft 365, Outlook, Word, Excel, PowerPoint, VLC y
Mi Browser). Y v1 falta en todos los splits de una de cada tres apps de las más instaladas y de
una de cada diez del sorteo. Eso tiene un efecto en apksigner, que se explica en la «sección 10.5 · Cuando apksigner dice DOES NOT VERIFY». Un ejemplo es el split
com.vexostudio.win786 › split_config.arm64_v8a.apk, que lleva el mismo certificado que su
base.
Los contenedores .apkm y .xapk no son un APK. Los .apkm de APKMirror llevan una firma v1
propia en su raíz (META-INF/APKMIRRO.SF y APKMIRRO.RSA). Cubre las piezas como ficheros, no la
app. En el de Keep, el manifiesto lista 30 entradas (26 splits, la base, info.json, icon.png y
APKM_installer.url) con SHA1-Digest. Los .xapk no la llevan. La firma de la app es la de
cada pieza de dentro. Cómo son los conjuntos está en
«AAB, splits y contenedores».
9.3 Los protectores y la firma
Un protector (packer) cambia el APK después de compilarlo, así que hay que firmarlo otra vez. La
firma resultante es normal: apksigner verifica las apps empaquetadas. Aquí «empaquetada» es lo que
marca APKiD 3.1.0, una herramienta que detecta protectores; en el mercado chino son unas 4 de cada
10 apps, y nuestro propio recuento por heurística coincide casi siempre (ver
«Packers y protectores»). Las etiquetas más
frecuentes son SecNeo.B, Ijiami y yidun.
Lo que cambia es el esquema. En el mercado chino, las empaquetadas llevan todas v1, y 7 de cada 10
se quedan en v1+v2 sin v3; entre las que no están empaquetadas, v3 la tiene el 43 %. En Google
Play los protectores son raros con nuestra heurística; APKiD marca más, porque sus etiquetas de
DexGuard dan falsos positivos (ver el documento enlazado). No sabemos quién firma después del protector (autor, tienda o
protector): solo el esquema y que verifica. Los ejemplos del mercado chino son
com.jzzs.ParentsHelper (versión 1006033) y com.corp21cn.mail189 (versión 185), las dos con v1+v2
sin v3; el de Google Play, com.google.android.apps.bard (1.0.995038376-345) › base.apk, con
v2+v3.
10. Recetas
Herramientas: apksigner 0.9 de build-tools 37.0.0, unzip y openssl 3.6.3 del sistema.
Salidas ejecutadas entre el 27 y el 31 de octubre de 2026 sobre el muestrario, descargado entre el
19 y el 27 de octubre de 2026 (ver «El muestrario»). En los
bloques de código, MUESTRARIO es la carpeta del muestrario y las rutas son las relativas de esa
carpeta ($MUESTRARIO/fdroid/…, $MUESTRARIO/play/…). Para el uso general de estas herramientas,
ver «Firma y empaquetado».
Cómo repetir las cifras. Salen de dos scripts del repositorio: MUESTRARIO_RAIZ=<carpeta del muestrario> python3 -I scripts/muestrario/cifras/firma_2.py --atlas <carpeta> [--leer-volumen] y
scripts/muestrario/cifras/nucleo_binario.py; la verificación de las 34 piezas con v3.2 con un JDK
25 es nucleo_binario.py --validar --java <JDK 25>. Las salidas de apksigner, unzip y openssl
se repiten con los comandos de las recetas.
10.1 Veredicto por esquema sobre varios APK
BT=~/Library/Android/sdk/build-tools/37.0.0
MUESTRARIO=<carpeta del muestrario>
$BT/apksigner verify --verbose --print-certs $MUESTRARIO/fdroid/com.termux_1022.apk
Verifies
Verified using v1 scheme (JAR signing): false
Verified using v2 scheme (APK Signature Scheme v2): true
Verified using v3 scheme (APK Signature Scheme v3): true
Verified using v3.1 scheme (APK Signature Scheme v3.1): false
Verified using v3.2 scheme (APK Signature Scheme v3.2): false
Verified using v4 scheme (APK Signature Scheme v4): false
Verified for SourceStamp: false
Number of signers: 1
V3.0 Signer: certificate DN: CN=FDroid, OU=FDroid, O=fdroid.org, L=ORG, ST=ORG, C=UK
V3.0 Signer: certificate SHA-256 digest: 228fb2cfe90831c1499ec3ccaf61e96e8e1ce70766b9474672ce427334d41c42
…
V3.0 Signer: key algorithm: RSA
V3.0 Signer: key size (bits): 2048
…
v1: false con los ficheros META-INF/84D3000E.SF y .RSA presentes en el APK: no es que
falten, es que minSdkVersion=24 y apksigner no los comprueba. Y el v3.2 de la sexta línea es
la firma híbrida de Android 17 de la «sección 7 · v3.2: la firma híbrida». Los «…» marcan las líneas que hemos omitido: los
digests SHA-1 y MD5 del certificado, aquí, y los de la clave pública después.
Sobre el base.apk de Google Keep 5.26.411.03.97, extraído del .apkm del muestrario, aparece el
caso completo:
SCR=/tmp/scratch
unzip -o -q $MUESTRARIO/play/com.google.android.keep_5.26.411.03.97-220679628_1arch_1dpi_24lang_5077c1df745152f19ddcb9e265a31428_apkmirror.com.apkm base.apk -d $SCR/keep_x
$BT/apksigner verify --verbose --print-certs $SCR/keep_x/base.apk
Verifies
Verified using v1 scheme (JAR signing): false
Verified using v2 scheme (APK Signature Scheme v2): false
Verified using v3 scheme (APK Signature Scheme v3): true
Verified using v3.1 scheme (APK Signature Scheme v3.1): true
…
Verified for SourceStamp: true
Number of signers: 1
V3.1 Signer: (minSdkVersion=33, maxSdkVersion=2147483647) certificate DN: CN=Android, …
…
V3.1 Signer: (minSdkVersion=33, maxSdkVersion=2147483647) key size (bits): 4096
…
V3.0 Signer: (minSdkVersion=24, maxSdkVersion=32) certificate DN: CN=Android, …
…
V3.0 Signer: (minSdkVersion=24, maxSdkVersion=32) key size (bits): 2048
…
Source Stamp Signer: certificate DN: CN=Android, …
…
Source Stamp Timestamp: 1792435881
…
El primer «…» son las líneas de v3.2 y v4, las dos false; los demás, los digests y el algoritmo de
cada certificado y de su clave, y el último, el aviso INFO de apksig para el bloque v3.1, que el
sello no cubre («sección 5.3 de APK Signing Block · El source stamp, 0x6dff800d»). Dos claves distintas
para dos rangos de SDK disjuntos: la rotación de la «sección 6 · v3.1: la rotación segmentada por SDK» en un APK de producción. No es la
única; ver la «sección 6.3 · La rotación en la práctica».
10.2 El veredicto depende del rango de SDK que se le pase
Es el mismo fichero (el base.apk de Keep de la «sección 10.1 · Veredicto por esquema sobre varios APK») en las cuatro invocaciones:
for m in 21 24 33; do
echo "--- min-sdk-version $m"
$BT/apksigner verify --min-sdk-version $m --verbose $SCR/keep_x/base.apk \
| head -6
done
echo "--- min-sdk 24, max-sdk 32"
$BT/apksigner verify --min-sdk-version 24 --max-sdk-version 32 --verbose \
$SCR/keep_x/base.apk | head -6
--- min-sdk-version 21
DOES NOT VERIFY
ERROR: Missing META-INF/MANIFEST.MF
--- min-sdk-version 24
Verifies
Verified using v1 scheme (JAR signing): false
Verified using v2 scheme (APK Signature Scheme v2): true
Verified using v3 scheme (APK Signature Scheme v3): true
Verified using v3.1 scheme (APK Signature Scheme v3.1): true
…
--- min-sdk-version 33
…
Verified using v2 scheme (APK Signature Scheme v2): false
Verified using v3 scheme (APK Signature Scheme v3): true
Verified using v3.1 scheme (APK Signature Scheme v3.1): true
…
--- min-sdk 24, max-sdk 32
…
Verified using v2 scheme (APK Signature Scheme v2): true
Verified using v3 scheme (APK Signature Scheme v3): true
Verified using v3.1 scheme (APK Signature Scheme v3.1): false
…
Los «…» marcan las líneas de head -6 que se omiten: Verifies y la de v1, delante, y la de v3.2,
detrás.
Cuatro veredictos distintos sobre los mismos bytes. Con --min-sdk-version 21 el APK no
verifica, porque una plataforma de API 21 exigiría v1 y aquí no hay MANIFEST.MF. Con
--max-sdk-version 32 el bloque v3.1 desaparece del veredicto, porque ninguna plataforma del rango
lo mira. «¿Verifica este APK?» es una pregunta mal formulada; la buena es «¿verifica para qué
rango de plataformas?».
10.3 La protección contra el downgrade, demostrada
Esta receta parte de copia.apk, la copia de org.fossify.math (versión 10) firmada en la «sección
10.2 de Firma v4 y verificación · Firmar una copia y verificarla», y lee el bloque con
dump_sigblock.py, el volcador de la «sección 9 de APK Signing Block · El volcador».
Se quita el bloque v3 del APK conservando el v2 y el mismo tamaño total del
APK Signing Block, ajustando el relleno, para que ningún otro byte se mueva y la firma v2 siga
siendo aritméticamente correcta. Todo sobre una copia en el scratchpad.
# copia.apk es la copia de org.fossify.math_10.apk firmada en la sección 10.2 de
# 03-firma-v4-y-verificacion.md; sin_v3.apk es el mismo fichero sin el par 0xf05368c0
python3 dump_sigblock.py $SCR/firma/sin_v3.apk
$BT/apksigner verify --verbose $SCR/firma/sin_v3.apk
== sin_v3.apk
inicio del bloque : 7057408 (multiplo de 4096: True)
size (cabeza/cola): 4088 / 4088 coinciden: True
offset del CD : 7061504 total del bloque: 4096
0x7109871a 1536 bytes v2 (APK_SIGNATURE_SCHEME_V2_BLOCK_ID)
0x42726577 2504 bytes padding (VERITY_PADDING_BLOCK_ID)
DOES NOT VERIFY
ERROR: APK Signature Scheme v2 signer #1: APK Signature Scheme v2 signature 0 indicates the
APK is signed using APK Signature Scheme v3 but no such signature was found. Signature
stripped?
La salida es de una ejecución anterior, sobre una copia de otra calculadora de Fossify que ya no
está en el muestrario. Con org.fossify.math_10.apk cambian los offsets y los tamaños; el mensaje
de apksigner es el mismo.
El digest v2 cuadra (no se ha movido un byte fuera del bloque) y aun así el APK se rechaza, porque
el atributo 0xbeeff00d de la «sección 4.3 · La protección contra el stripping, desde el otro lado» dice que tenía que haber un v3. Es el mismo mecanismo que
el X-Android-APK-Signed de v1, un piso más arriba.
10.4 Ver los ficheros de v1
unzip -o -q $MUESTRARIO/fdroid/org.fdroid.fdroid_2000052.apk 'META-INF/*' -d $SCR/v1
ls $SCR/v1/META-INF/ | grep -E '\.(SF|RSA)$|MANIFEST'
head -8 $SCR/v1/META-INF/MANIFEST.MF
head -5 $SCR/v1/META-INF/CIARANG.SF
CIARANG.RSA
CIARANG.SF
MANIFEST.MF
Manifest-Version: 1.0
Name: AndroidManifest.xml
SHA-256-Digest: aqhylM/52uV54sQpmBXxWmEtuWplKDAdauZWh7iqDnY=
Name: DebugProbesKt.bin
SHA-256-Digest: BlvXkrhSd2TzMUcYgwKvW/niqNpA/eCDDcERrSba5A4=
Signature-Version: 1.0
Created-By: 1.0 (Android)
SHA-256-Digest-Manifest: 0BeGr7+gSMKU6tz3NuyXFDe6y4M+hx5L7+LAC8PZMXI=
X-Android-APK-Signed: 2, 3
El APK es el del cliente de F-Droid (org.fdroid.fdroid, versión 2000052). El head -8 del
manifiesto muestra las dos primeras secciones; la línea partida de la «sección 3.1 · META-INF/MANIFEST.MF» está más abajo
(línea 54).
10.5 Cuando apksigner dice DOES NOT VERIFY
apksigner rechaza pocas piezas, y cuando lo hace es por dos motivos que no son de la firma. Con el
minSdkVersion por defecto, rechaza poco más del 1 % de las piezas de las más instaladas de Google
Play y menos del 3 % de las del sorteo; en las demás fuentes, ninguna.
- Un split sin
minSdkVersiony sin v1. Sin ese dato,apksignersupone 1 y pide v1:
DOES NOT VERIFY
ERROR: Missing META-INF/MANIFEST.MF
Son los 93 splits de 6 apps de la «sección 8 · Qué esquema exige o admite cada nivel de API» (Outlook, Microsoft 365, Word, Excel, PowerPoint y
Mi Browser). Con
--min-sdk-version 33, el split de PowerPoint de la «sección 8 · Qué esquema exige o admite cada nivel de API» verifica, con v3 y source stamp.
Con el de su base, verifican los 93.
2. Una firma v3.2 con un JDK sin ML-DSA. Son las 34 piezas de 9 apps del sorteo de la «sección
7.2 · Cómo se verifica». Se arregla con Java 24 o posterior.
Ninguna pieza se rechaza por stripping, por una entrada sin digest o por un certificado raro. Un
DOES NOT VERIFY puede ser del JDK o de un dato que falta: antes de culpar al APK, repite con
otro minSdkVersion o con otro JDK.
Fuentes
- APK signature scheme v2 — Android Open Source Project — https://source.android.com/docs/security/features/apksigning/v2
Consultado el 12 de agosto de 2026. De aquí salen las cuatro secciones del
APKde la «sección 4 · v2: firma del fichero completo», la cita sobre qué protege v2, y la tabla de identificadores de algoritmo de firma que se amplía en el «documento 02 · El APK Signing Block». - APK signature scheme v3 — Android Open Source Project — https://source.android.com/docs/security/features/apksigning/v3
Consultado el 12 de agosto de 2026. De aquí salen la cita «V3 adds information about the
supported SDK versions…», el identificador
0x3ba06f8cdelproof-of-rotationy la descripción deminSDK/maxSDKde la «sección 5.1 · minSdkVersion y maxSdkVersion en el signer». - APK signature scheme v3.1 — Android Open Source Project — https://source.android.com/docs/security/features/apksigning/v3-1 Consultado el 12 de agosto de 2026. De aquí sale íntegra la «sección 6 · v3.1: la rotación segmentada por SDK»: el motivo de la separación, la cita «same contents as the v3 signing block, but with the new block ID» y el reparto por versión de Android.
- Application signing — Android Open Source Project — https://source.android.com/docs/security/features/apksigning Consultado el 12 de agosto de 2026. De aquí salen las versiones de introducción de v1, v2 y v3 de la «sección 2 · La línea del tiempo», la recomendación de firmar con todos los esquemas de la «sección 9 · Por qué un APK moderno lleva v1+v2+v3 (y cuándo se puede omitir v1)» y la explicación del rechazo de firmas v2+ eliminadas.
- AOSP —
tools/apksig/.../internal/apk/v3/V3SchemeConstants.java, etiquetaandroid-17.0.0_r1— https://android.googlesource.com/platform/tools/apksig/+/refs/tags/android-17.0.0_r1/src/main/java/com/android/apksig/internal/apk/v3/V3SchemeConstants.java Consultado el 24 y el 25 de septiembre de 2026. De aquí salenAPK_SIGNATURE_SCHEME_V3_BLOCK_ID,APK_SIGNATURE_SCHEME_V31_BLOCK_ID,ROTATION_MIN_SDK_VERSION_ATTR_IDy su comentario citado en la «sección 6.2 · Cómo conviven los dos bloques», los umbralesMIN_SDK_WITH_V3_SUPPORT,MIN_SDK_WITH_V31_SUPPORTyMIN_SDK_WITH_V32_SUPPORT = 37de la «sección 2 · La línea del tiempo», y los comentarios de0xbf940529,0x9f06b79cy0xc2a6b3bade la «sección 7 · v3.2: la firma híbrida». - AOSP —
tools/apksig/.../SigningCertificateLineage.java— https://android.googlesource.com/platform/tools/apksig/+/refs/tags/android-17.0.0_r1/src/main/java/com/android/apksig/SigningCertificateLineage.java Consultado el 25 de septiembre de 2026. De aquí sale íntegra la tabla de capacidades de la «sección 5.2 · El lineage de rotación» con sus valores y sus comentarios literales, incluida la advertencia sobrePAST_CERT_ROLLBACK. - AOSP —
tools/apksig/.../internal/apk/v3/V3SigningCertificateLineage.java— https://android.googlesource.com/platform/tools/apksig/+/refs/tags/android-17.0.0_r1/src/main/java/com/android/apksig/internal/apk/v3/V3SigningCertificateLineage.java Consultado el 25 de septiembre de 2026. De aquí sale el formato binario del lineage de la «sección 5.2 · El lineage de rotación», tomado del comentario// FORMAT (little endian):. - AOSP —
tools/apksig/.../internal/apk/ApkSigningBlockUtils.java— https://android.googlesource.com/platform/tools/apksig/+/refs/tags/android-17.0.0_r1/src/main/java/com/android/apksig/internal/apk/ApkSigningBlockUtils.java Consultado el 25 de septiembre de 2026. De aquí sale la normalización del offset delCentral Directoryen elEOCDde la «sección 4.1 · Las dos exclusiones y por qué son necesarias», con su comentario literal. - AOSP —
tools/apksig/.../ApkVerifier.java— https://android.googlesource.com/platform/tools/apksig/+/refs/tags/android-17.0.0_r1/src/main/java/com/android/apksig/ApkVerifier.java Consultado el 25 de septiembre de 2026. De aquí salen las condiciones exactas bajo las que se verifica cada esquema (secciones «8» y «9»), el orden v3.2, v3.1 y v3.0 de la «sección 7.2 · Cómo se verifica» y el errorV31_BLOCK_FOUND_WITHOUT_V3_BLOCKde la «sección 6.2 · Cómo conviven los dos bloques». - AOSP —
tools/apksig/.../internal/apk/v2/V2SchemeConstants.java— https://android.googlesource.com/platform/tools/apksig/+/refs/tags/android-17.0.0_r1/src/main/java/com/android/apksig/internal/apk/v2/V2SchemeConstants.java Consultado el 25 de septiembre de 2026. De aquí saleSTRIPPING_PROTECTION_ATTR_ID = 0xbeeff00dde la «sección 4.3 · La protección contra el stripping, desde el otro lado». - JAR File Specification — Oracle, Java SE 21 — https://docs.oracle.com/en/java/javase/21/docs/specs/jar/jar.html
Consultado el 12 de agosto de 2026. De aquí salen la estructura del manifiesto y del
.SFde las secciones «3.1» y «3.2», el límite de 72 bytes por línea con su regla de continuación, las extensiones.RSA/.DSA/.ECy el procedimiento de validación en cuatro pasos. Consultada de nuevo el 18 de octubre de 2026 para los algoritmos que asigna a cada extensión —RSA o RSASSA-PSS en.RSA, EC o EdDSA en.EC— de la «sección 3.3 · META-INF/CERT.RSA». - RFC 5652 — Cryptographic Message Syntax (CMS) — https://www.rfc-editor.org/rfc/rfc5652.html
Consultado el 12 de agosto de 2026. Standards Track, septiembre de 2009. Es la
especificación del
SignedData(apartado 5.1 del RFC) que contiene el fichero.RSAde la «sección 3.3 · META-INF/CERT.RSA». - Behavior changes: Apps targeting Android 11 — https://developer.android.com/about/versions/11/behavior-changes-11
Consultado el 12 de agosto de 2026. De aquí sale citada la obligación de firmar con v2 o
superior a partir de
targetSdkVersion30 («sección 8 · Qué esquema exige o admite cada nivel de API»). - apksigner — Android Studio — https://developer.android.com/tools/apksigner
Consultado el 12 de agosto de 2026. De aquí salen la descripción de
--min-sdk-versiony la regla de queapksignerdecide los esquemas a partir del rango de SDK («sección 9 · Por qué un APK moderno lleva v1+v2+v3 (y cuándo se puede omitir v1)»). - APK Signature Scheme v3.2 — Android Open Source Project — https://source.android.com/docs/security/features/apksigning/v3-2
Consultado el 24 de septiembre de 2026, cuando la página tenía fecha del 29 de julio, y de
nuevo el 18 de octubre, con fecha del 30 de septiembre. De aquí salen el bloque híbrido, los
dos firmantes, ML-DSA-65 y ML-DSA-87, la recomendación de mantener un bloque v3.0 o v3.1
clásico, la rotación implícita, el linaje compartido, la recomendación de
ROLLBACKpara K0 y la restricción de los firmantes PQC en solitario, citada en la «sección 7.2 · Cómo se verifica» («sección 7 · v3.2: la firma híbrida»). - AOSP — verificación de firmas de la plataforma en
android-17.0.0_r1— https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/core/java/android/util/apk/ApkSignatureSchemeV3Verifier.java, y en el mismo directorioApkSignatureVerifier.java,ApkSigningBlockUtils.javayApkSignatureSchemeV4Verifier.java. Consultado el 25 de septiembre de 2026. De aquí salen el orden de la «sección 7.2 · Cómo se verifica», sus comprobaciones y mensajes, los atributos de la «sección 7.3 · La protección contra el stripping» y el linaje fusionado de la «sección 7.4 · Rotación implícita y ROLLBACK». - AOSP —
SigningDetails.javayPackageManagerServiceUtils.javaenandroid-17.0.0_r1— https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/core/java/android/content/pm/SigningDetails.java y https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/services/core/java/com/android/server/pm/PackageManagerServiceUtils.java. Consultado el 25 de septiembre de 2026. De aquí salen las reglas de actualización y de reutilización de claves de la «sección 7.4 · Rotación implícita y ROLLBACK». - AOSP —
HybridSignatureVerificationTest.javade CTS enandroid-17.0.0_r1— https://android.googlesource.com/platform/cts/+/refs/tags/android-17.0.0_r1/hostsidetests/appsecurity/src/android/appsecurity/cts/HybridSignatureVerificationTest.java Consultado el 25 de septiembre de 2026. De aquí salen la instalación de unAPKcon solo el bloque híbrido de la «sección 7 · v3.2: la firma híbrida» y la cita sobreROLLBACKde la «sección 7.4 · Rotación implícita y ROLLBACK». - Android 17 Compatibility Definition — https://source.android.com/docs/compatibility/17/android-17-cdd Consultado el 25 de septiembre y el 18 de octubre de 2026; la página se actualizó el 31 de agosto. De aquí sale el requisito 4 [C-0-2] de la «sección 7 · v3.2: la firma híbrida», que el CDD formula para las «Devices implementations».
- AOSP — el flag
android.security.apk_pqc_hybrid_signing— https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/core/java/android/security/flags.aconfig y https://android.googlesource.com/platform/build/release/+/refs/tags/android-17.0.0_r1/release_config_map.textproto. Consultado el 25 de septiembre de 2026. De aquí sale que v3.2 esté activado enandroid-17.0.0_r1(«sección 7 · v3.2: la firma híbrida»). El 18 de octubre se comprobaron la definición del flag (flags.aconfig, líneas 227-232) y su uso encore/java/android/util/apk/ApkSignatureSchemeV3Verifier.javade la misma etiqueta, que solo busca el bloque v3.2 con el flag activo (líneas 146-156 y 275-277). - AOSP —
apksigenandroid-17.0.0_r1— https://android.googlesource.com/platform/tools/apksig/+/refs/tags/android-17.0.0_r1/src/main/java/com/android/apksig/ (ApkVerifier.java,DefaultApkSignerEngine.java,ApkSigner.java,internal/apk/v3/V3SchemeSigner.javaeinternal/apk/SignatureAlgorithm.java). Consultado el 25 de septiembre de 2026. De aquí salen el formato de la «sección 7.1 · El bloque 0x70e1c89f», losIssuede la «sección 7.2 · Cómo se verifica» y lo que hace la herramienta en la «sección 7.5 · Receta: firmar y verificar con apksigner 37.0.0». - AOSP — Conscrypt en
android-17.0.0_r1— https://android.googlesource.com/platform/external/conscrypt/+/refs/tags/android-17.0.0_r1/common/src/main/java/org/conscrypt/OpenSslMlDsaKeyFactory.java Consultado el 25 de septiembre de 2026. De aquí sale que la plataforma solo admita ML-DSA-65 y ML-DSA-87 («sección 7.1 · El bloque 0x70e1c89f»). - JEP 497: Quantum-Resistant Module-Lattice-Based Digital Signature Algorithm — https://openjdk.org/jeps/497 Consultado el 25 de septiembre de 2026. De aquí sale que ML-DSA llegue al JDK en la versión 24 («sección 7.5 · Receta: firmar y verificar con apksigner 37.0.0»).
apksigner0.9 debuild-tools37.0.0, con Temurin 25.0.2 y OpenSSL 3.6.3 — ejecutado el 25 de septiembre de 2026. De aquí salen el rechazo sin el bloque v3.2 de la «sección 7.3 · La protección contra el stripping» y la receta de la «sección 7.5 · Receta: firmar y verificar con apksigner 37.0.0».- AOSP — la verificación v1 en
android-17.0.0_r1— https://android.googlesource.com/platform/tools/apksig/+/refs/tags/android-17.0.0_r1/src/main/java/com/android/apksig/internal/apk/v1/V1SchemeVerifier.java y, en el mismo directorio,V1SchemeSigner.java, coninternal/pkcs7/AlgorithmIdentifier.javaeinternal/oid/OidConstants.javadeapksig; https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/core/java/android/util/jar/StrictJarVerifier.java y https://android.googlesource.com/platform/libcore/+/refs/tags/android-17.0.0_r1/ojluni/src/main/java/sun/security/pkcs/SignerInfo.java, conojluni/src/main/java/sun/security/x509/AlgorithmId.java. Consultado el 18 de octubre de 2026. De aquí sale lo que v1 cierra y lo que deja abierto en Android, de la «sección 3.2 · META-INF/CERT.SF»: la sección principal del manifiesto solo se comprueba si el.SFtrae-Digest-Manifest-Main-Attributes(V1SchemeVerifier.java, líneas 986-1000;StrictJarVerifier.java, líneas 461-468 y 502-526), queapksigno escribe (V1SchemeSigner.java, líneas 436-467), mientras que toda entrada fuera deMETA-INF/tiene que estar en el manifiesto y firmada (V1SchemeVerifier.java, líneas 1278-1326). Y los algoritmos de la «sección 3.3 · META-INF/CERT.RSA»: el v1 deapksigsolo resuelve RSA, DSA y ECDSA (AlgorithmIdentifier.java, líneas 132-163;OidConstants.java, líneas 442-460), y niSignerInfo.javaniAlgorithmId.javade libcore mencionan EdDSA. - AOSP — ML-DSA en
android.util.apk,android-17.0.0_r1— https://android.googlesource.com/platform/frameworks/base/+/refs/tags/android-17.0.0_r1/core/java/android/util/apk/ApkSigningBlockUtils.java, y en el mismo directorioApkSignatureSchemeV2Verifier.javayApkSignatureSchemeV4Verifier.java. Consultado el 18 de octubre de 2026. De aquí salen el cierre de la «sección 7.2 · Cómo se verifica»:SIGNATURE_ML_DSA = 0x0501aceptado con el flag activo (ApkSigningBlockUtils.java, líneas 154-158 y 446) y traducido a digest, clave y firma (515-519, 568-572 y 614-618), y el verificador v2 sin comprobación de PQC (ApkSignatureSchemeV2Verifier.java, 243-298); y la elección del bloque del.idsigpor el bloque v3 leído de la «sección 7.5 · Receta: firmar y verificar con apksigner 37.0.0» (ApkSignatureSchemeV4Verifier.java, 160-179). - AOSP —
apksignerenandroid-17.0.0_r1, yapksigner sign -hdebuild-tools37.0.0 — https://android.googlesource.com/platform/tools/apksig/+/refs/tags/android-17.0.0_r1/src/apksigner/java/com/android/apksigner/ApkSignerTool.java, consrc/main/java/com/android/apksig/DefaultApkSignerEngine.javadel mismo repositorio. Consultado y ejecutado el 18 de octubre de 2026. De aquí sale el valor por defecto de--v1-signing-enabledde la «sección 9 · Por qué un APK moderno lleva v1+v2+v3 (y cuándo se puede omitir v1)»:true(ApkSignerTool.java, línea 146), que el motor solo apaga si el firmante más antiguo es PQC (DefaultApkSignerEngine.java, 236-273), frente a la ayuda, que dice «enabled based on min and max SDK version». apksigner0.9 yaapt2debuild-tools37.0.0,keytool, OpenSSL 3.6.3 y el volcador de la «sección 9 de APK Signing Block · El volcador» — ejecutados el 18 de octubre de 2026 sobreAPKde prueba sin código generados conaapt2, con Temurin 21.0.10 y, para la firma híbrida, Temurin 25.0.2. De aquí salen el volcado de la «sección 7.1 · El bloque 0x70e1c89f», sobre unAPKfirmado con la receta de la «sección 7.5 · Receta: firmar y verificar con apksigner 37.0.0»; el.idsigde un solosigningInfode la «sección 7.5 · Receta: firmar y verificar con apksigner 37.0.0»; el v1 queapksignerescribe conminSdkVersion32, de la «sección 9 · Por qué un APK moderno lleva v1+v2+v3 (y cuándo se puede omitir v1)», y el orden de las líneas deapksigner verifycon el que se marcan los recortes de las secciones «10.1» y «10.2».- El «muestrario», con
apksigner0.9 debuild-tools37.0.0 yopenssl3.6.3 — ejecutados entre el 27 y el 31 de octubre de 2026 sobre las apps descargadas entre el 19 y el 27 de octubre de 2026, con Temurin 21.0.10 y, para v3.2, Temurin 25. De aquí salen las cifras de todo el documento y las salidas de las secciones «4.3», «5.1», «5.2», «7.1», «7.2», «9» y «10.1» a 10.5. - App signing — Android Developers — https://developer.android.com/studio/publish/app-signing Consultado el 31 de octubre de 2026. De aquí sale la descripción de Play App Signing de la «sección 1 · Qué es y por qué existe»: Google guarda y protege la clave de firma de la app, y el autor sube el paquete con una clave de subida distinta.