Esquemas de firma v1, v2, v3, v3.1 y v3.2

Antes conviene leer «Contenedor ZIP» · se lee en paralelo con «APK Signing Block»

referencia técnica · Actualizado el 15 de noviembre de 2026

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:

  1. 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.
  2. Los permisos de nivel signature se conceden entre aplicaciones firmadas con la misma clave. Es lo que permite que un paquete hable con otro sin pedir permiso al usuario.
  3. El sharedUserId y 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 por CN=Amazon Self-Sign CA.
  • com.microsoft.office.outlook (Outlook, versión 5.2641.1): certificado emitido por CN=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/.

digest de cada entradadigest del manifiestoenterofirma PKCS#7 sobre losbytes del .SFcontenido delAPKMETA-INF/MANIFEST.MFMETA-INF/CERT.SFMETA-INF/CERT.RSA← certificado +firma

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.SF y CIARANG.RSA.
  • com.termux (versión 1022): 84D3000E.SF y 84D3000E.RSA.
  • com.vexostudio.win786 › base.apk: BNDLTOOL.SF y BNDLTOOL.RSA.
  • moe.henry_zhr.kill_domain_verification (versión 4, de IzzyOnDroid): CERT.SF, firmada con el plugin de Gradle de Android.
  • El .apkm de Keep (5.26.411.03.97): APKMIRRO.SF y APKMIRRO.RSA en 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-Digest en la mayoría de las apps y SHA1-Digest en una de cada cinco de F-Droid (736 de 3.663 apps con v1). apksigner usa SHA-1 cuando minSdkVersion es menor que 18: las 605 apps de F-Droid, las 127 de IzzyOnDroid y las demás con ese minSdkVersion llevan SHA1-Digest. Con 18 o más hay excepciones: 131 apps de F-Droid, por ejemplo Briar (org.briarproject.briar.android, versión 10522, minSdkVersion 21). 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.ver y sion son una sola línea lógica: META-INF/androidx.compose.material3.adaptive_adaptive-layout.version. Un parser que corte por \n sin volver a unir las continuaciones lee mal el nombre.
  • El propio MANIFEST.MF no 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.SF y CIARANG.RSA). Las entradas que no son de META-INF/ están todas: apksigner no ha dado ni un error de entrada sin digest («No digest for…») en las 8.109 piezas cuya v1 comprueba por tener minSdkVersion menor que 24. El contenedor .apkm de Keep lista 30 entradas y deja fuera los mismos tres ficheros de META-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, con SHA1-Digest-Manifest-Main-Attributes.
  • tk.al54.dev.badpixels (versión 4): jarsigner, igual.
  • com.netflix.ninja 13.2.1-27207: otra herramienta, con SHA-256-Digest-Manifest-Main-Attributes.
  • El APKMIRRO.SF del contenedor de Keep (el mismo .apkm de la «sección 3 · v1: JAR signing»): Created-By: 21.0.12.1 (N/A) y SHA1-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 con SHA512withECDSA.
  • 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:

  1. Exactamente dos firmantes, uno clásico y otro ML-DSA. apksig escribe 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 es ML-DSA o uno de los OID de ML-DSA.
  2. El mismo rango de SDK en los dos, en la copia firmada y en la de fuera.
  3. lineage en 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. apksigner no lo comprueba al firmar, y luego rechaza el resultado con The 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-lineage para cada firmante híbrido, termina con un NullPointerException en DefaultApkSignerEngine.createHybridSignerConfig.
  • Se compiló con Android 17 aún en desarrollo (DEV_RELEASE = 37, PROD_RELEASE = 36): por eso escribe minSdkVersion=36 con 0xc2a6b3ba y HYBRID_MIN_SDK_VERSION = 36, y no conoce 0x9f06b79c ni --hybrid-max-sdk-version. Compilado desde la etiqueta android-17.0.0_r1, apksig escribe 37 y los dos atributos. Según el código, Android 17 acepta las dos variantes.
  • apksigner lineage --in hibrido.apk no lee los lineages del bloque v3.2: solo mira v3.1 y v3.0, y aquí responde The provided APK does not contain a valid lineage.
  • Genera el .idsig de v4 con un solo signingInfo, firmado con K0: el V4SchemeSigner de android-17.0.0_r1 solo 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 .idsig un bloque para 0x70e1c89f y, sin él, rechaza la firma v4 (ApkSignatureSchemeV4Verifier.java, líneas 160-179): según el código, la instalación incremental de este APK en 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 el APK 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 APK con bloque v2 presente sale como v2: false.
  • Un esquema superior presente obliga a que valide. Si el bloque v3 está y no verifica, el APK se rechaza; no se cae a v2. ApkVerifier lo hace devolviendo el resultado en cuanto result.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, apksigner uses the value of the minSdkVersion attribute 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.

  1. Un split sin minSdkVersion y sin v1. Sin ese dato, apksigner supone 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

  1. 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 APK de 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».
  2. 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 0x3ba06f8c del proof-of-rotation y la descripción de minSDK/maxSDK de la «sección 5.1 · minSdkVersion y maxSdkVersion en el signer».
  3. 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.
  4. 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.
  5. AOSP — tools/apksig/.../internal/apk/v3/V3SchemeConstants.java, etiqueta 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/v3/V3SchemeConstants.java Consultado el 24 y el 25 de septiembre de 2026. De aquí salen APK_SIGNATURE_SCHEME_V3_BLOCK_ID, APK_SIGNATURE_SCHEME_V31_BLOCK_ID, ROTATION_MIN_SDK_VERSION_ATTR_ID y su comentario citado en la «sección 6.2 · Cómo conviven los dos bloques», los umbrales MIN_SDK_WITH_V3_SUPPORT, MIN_SDK_WITH_V31_SUPPORT y MIN_SDK_WITH_V32_SUPPORT = 37 de la «sección 2 · La línea del tiempo», y los comentarios de 0xbf940529, 0x9f06b79c y 0xc2a6b3ba de la «sección 7 · v3.2: la firma híbrida».
  6. 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 sobre PAST_CERT_ROLLBACK.
  7. 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):.
  8. 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 del Central Directory en el EOCD de la «sección 4.1 · Las dos exclusiones y por qué son necesarias», con su comentario literal.
  9. 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 error V31_BLOCK_FOUND_WITHOUT_V3_BLOCK de la «sección 6.2 · Cómo conviven los dos bloques».
  10. 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í sale STRIPPING_PROTECTION_ATTR_ID = 0xbeeff00d de la «sección 4.3 · La protección contra el stripping, desde el otro lado».
  11. 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 .SF de 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/.EC y 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».
  12. 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 .RSA de la «sección 3.3 · META-INF/CERT.RSA».
  13. 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 targetSdkVersion 30 («sección 8 · Qué esquema exige o admite cada nivel de API»).
  14. 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-version y la regla de que apksigner decide 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)»).
  15. 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 ROLLBACK para 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»).
  16. 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 directorio ApkSignatureVerifier.java, ApkSigningBlockUtils.java y ApkSignatureSchemeV4Verifier.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».
  17. AOSP — SigningDetails.java y PackageManagerServiceUtils.java en android-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».
  18. AOSP — HybridSignatureVerificationTest.java de CTS en android-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 un APK con solo el bloque híbrido de la «sección 7 · v3.2: la firma híbrida» y la cita sobre ROLLBACK de la «sección 7.4 · Rotación implícita y ROLLBACK».
  19. 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».
  20. 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 en android-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 en core/java/android/util/apk/ApkSignatureSchemeV3Verifier.java de la misma etiqueta, que solo busca el bloque v3.2 con el flag activo (líneas 146-156 y 275-277).
  21. AOSP — apksig 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/ (ApkVerifier.java, DefaultApkSignerEngine.java, ApkSigner.java, internal/apk/v3/V3SchemeSigner.java e internal/apk/SignatureAlgorithm.java). Consultado el 25 de septiembre de 2026. De aquí salen el formato de la «sección 7.1 · El bloque 0x70e1c89f», los Issue de 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».
  22. 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»).
  23. 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»).
  24. apksigner 0.9 de build-tools 37.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».
  25. 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, con internal/pkcs7/AlgorithmIdentifier.java e internal/oid/OidConstants.java de apksig; 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, con ojluni/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 .SF trae -Digest-Manifest-Main-Attributes (V1SchemeVerifier.java, líneas 986-1000; StrictJarVerifier.java, líneas 461-468 y 502-526), que apksig no escribe (V1SchemeSigner.java, líneas 436-467), mientras que toda entrada fuera de META-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 de apksig solo resuelve RSA, DSA y ECDSA (AlgorithmIdentifier.java, líneas 132-163; OidConstants.java, líneas 442-460), y ni SignerInfo.java ni AlgorithmId.java de libcore mencionan EdDSA.
  26. 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 directorio ApkSignatureSchemeV2Verifier.java y ApkSignatureSchemeV4Verifier.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 = 0x0501 aceptado 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 .idsig por el bloque v3 leído de la «sección 7.5 · Receta: firmar y verificar con apksigner 37.0.0» (ApkSignatureSchemeV4Verifier.java, 160-179).
  27. AOSP — apksigner en android-17.0.0_r1, y apksigner sign -h de build-tools 37.0.0 — https://android.googlesource.com/platform/tools/apksig/+/refs/tags/android-17.0.0_r1/src/apksigner/java/com/android/apksigner/ApkSignerTool.java, con src/main/java/com/android/apksig/DefaultApkSignerEngine.java del mismo repositorio. Consultado y ejecutado el 18 de octubre de 2026. De aquí sale el valor por defecto de --v1-signing-enabled de 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».
  28. apksigner 0.9 y aapt2 de build-tools 37.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 sobre APK de prueba sin código generados con aapt2, 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 un APK firmado con la receta de la «sección 7.5 · Receta: firmar y verificar con apksigner 37.0.0»; el .idsig de un solo signingInfo de la «sección 7.5 · Receta: firmar y verificar con apksigner 37.0.0»; el v1 que apksigner escribe con minSdkVersion 32, 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 de apksigner verify con el que se marcan los recortes de las secciones «10.1» y «10.2».
  29. El «muestrario», con apksigner 0.9 de build-tools 37.0.0 y openssl 3.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.
  30. 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.