Firma de apps de Google Play en 2026: guía paso a paso para subir claves, actualizar claves y restablecerlas
Play App Signing divide la firma de apps en dos tareas: tú conservas una clave y Google conserva otra. En 2026 se les unió una tercera clave —la mitad poscuántica de la nueva firma híbrida—, y por eso las huellas digitales que registras en Google Maps, OAuth o Facebook Login ya no son un único valor. Aquí tienes el modelo completo de claves según la propia documentación de Play Console de Google, las rutas exactas de la consola y las dos operaciones que más importan en la práctica: la actualización anual de la clave de firma de apps y el restablecimiento de la clave de carga.
Lo que vas a resolver hoy: saber qué hace cada clave, configurar Play App Signing para una app nueva o existente, registrar las huellas correctas (hasta tres), actualizar una clave de firma de app y restablecer una clave de carga perdida sin perder la app ni la ficha.
Dos claves, tres con firma preparada para la computación cuántica
Según Usar Play App Signing, cada app bajo Play App Signing maneja claves distintas, cada una con su propio titular, formato y reglas de recuperación.
- Clave de carga: tuya. Formato: un almacén de claves Java (
.jkso.keystore). Requisito: RSA de 2048 bits o más. La usas para firmar tu paquete de la app antes de subirlo a Play Console, y Google la usa para verificar tu identidad. Si se ve comprometida o se pierde, Google puede restablecerla por ti: esa es precisamente la razón de la separación. - Clave de firma de la app: la de Google Play. Formato: un certificado público (
.dero.pem). Las claves generadas por Google son RSA de 4096 bits; una clave personalizada que aportes debe ser RSA de 2048 bits o superior. Google usa esta clave para firmar los APK finales que se entregan a los dispositivos de los usuarios. Si la gestionas tú, fuera de Play App Signing, y la pierdes, no se puede restablecer. - Claves preparadas para la computación cuántica: las de Google Play, añadidas para Android 17. La firma híbrida combina una clave clásica RSA de 4096 bits con una clave poscuántica ML-DSA-65. Google genera una nueva clave clásica para la firma híbrida distinta de la clave clásica que usa para dispositivos anteriores a Android 17, así que la app acaba usando tres claves distintas. Android 17 y versiones posteriores verifican la app con el esquema de firma de APK v3.2, que incluye exactamente dos firmantes en un bloque híbrido; las versiones anteriores de Android siguen verificando la app con los bloques de firma clásicos.
Para máxima seguridad, tu clave de carga y tu clave de firma de la app deberían ser claves distintas. Y cuando Google firma tus APK con la clave de firma de la app, usa apksigner para añadir dos sellos al manifiesto, com.android.stamp.source y com.android.stamp.type, de modo que los APK sigan siendo rastreables hasta el firmante original.
App nueva: la firma preparada para la criptografía poscuántica ya es la opción predeterminada
- Crea la app. Se inscribe automáticamente en la firma híbrida preparada para cúbits, con claves generadas por Google. Google también genera una clave clásica independiente para los bloques de firma reconocidos en Android 16 y versiones anteriores.
- Crea una clave de carga — genera un almacén de claves en Android Studio o usa la utilidad
keytoolde Java desde la línea de comandos. - Sube el paquete de tu app. La inscripción ocurre al subirlo; no hay un paso de adhesión aparte.
- Opcional: cambiar la clave de firma de la app si prefieres gestionarla tú mismo. Ve a Protegida con Play → Distribución en Play Store → Ir a la firma de apps de Play y haz clic en Cambiar la clave de firma de la app. Solo es posible antes de que haya una versión implementada en el canal de pruebas abiertas o en el canal de producción, y puedes usar la clave de firma de otra app de la misma cuenta de desarrollador o aportar una copia de tu propia clave.
App existente: inscríbete mediante la herramienta PEPK
Si aún firmas y subes tus propios APK, puedes migrar a la firma de apps de Play para obtener paquetes de app y las mejoras de Play que los acompañan.
- En Play Console, ve a Protegido con Play → Distribución en Play Store → Ir a la firma de apps de Play y acepta los términos del servicio si aún no lo has hecho.
- Transfiere una copia de tu clave original. Descarga la herramienta PEPK y sigue las instrucciones unificadas paso a paso para cifrar y subir tu clave de firma de app existente desde cualquier repositorio.
- Crea una nueva clave de carga (recomendado). Genera una clave nueva en Android Studio y registra su certificado en Play Console.
Registra hasta tres huellas con tus proveedores de API
Maps, OAuth y Facebook Login autentican tu app mediante la huella de la clave de firma de la app. Como Google firma el APK final, debes registrar ante esos proveedores la huella de la clave de firma de la app que gestiona Google; registrar solo tu clave de subida local es el fallo clásico tras la migración.
- Ve a Protegido con Play → Distribución en Play Store → Ir a la firma de apps de Play.
- Desplázate a la sección Clave de firma de la app y copia las huellas SHA-1 o SHA-256.
- Si tu app usa firma híbrida preparada para criptografía cuántica, copia las huellas de tres claves y registra cada una: la nueva clave clásica y la clave PQC que se usa en dispositivos más recientes, además de la clave clásica que se usa en dispositivos más antiguos.
- Pégalos en la consola de cada proveedor (por ejemplo, Google Cloud Console). Si usas Android App Links, actualiza
assetlinks.jsoncon las mismas huellas digitales.
Actualiza la clave de firma de la app: una vez al año, cuando lo necesites
Si la clave de firma de la app se ve comprometida, o quieres una clave criptográficamente más fuerte, puedes solicitar una actualización anual de la clave. La actualización se aplica a todas las instalaciones en Android 17 (nivel de API 37) y superiores, y la aplicación de políticas varía según la versión de la plataforma:
- Android 17 (nivel de API 37) y superior: la plataforma aplica estrictamente la clave híbrida mejorada preparada para criptografía cuántica (esquema de firma de APK v3.2).
- Android 13 a 16 (niveles de API 33–36): la plataforma aplica estrictamente tu clave clásica más reciente (esquema de firma APK v3.1).
- Android 7 a 12 (niveles de API 24–32): la plataforma no aplica la clave actualizada y sigue reconociendo la última clave clásica; Play Protect añade la validación de que las actualizaciones estén firmadas con tu última clave clásica, salvo que el usuario lo haya desactivado.
Advertencia sobre datos compartidos: como la clave actualizada no se aplica en API 32 y versiones anteriores, si usas la misma clave en varias apps para compartir datos, esas versiones antiguas de Android solo reconocerán la clave heredada para funciones como el uso compartido de permisos personalizados.
Cómo actualizar:
- Ve a Protegido con Play → Distribución en Play Store → Ir a la firma de apps de Play.
- En la sección Clave de firma de la app, haz clic en Actualizar clave.
- Elige tu ruta: deja que Google Play genere una nueva clave de firma de app (recomendado), usa la misma clave de firma de app que otra app de esta cuenta de desarrollador o proporciona una copia de tu clave de firma de app.
- Haz clic en Guardar.
- Registra las nuevas huellas con tus proveedores de API — con firma preparada para la cuántica eso significa dos claves nuevas, la nueva clave clásica y la nueva clave PQC.
Restablecer una clave de carga perdida
Perder una clave de carga o sospechar que está comprometida no te deja fuera de tu app.
- Crea una nueva clave de carga en Android Studio.
- Exporta el certificado a formato PEM:
keytool -export -rfc -keystore upload-keystore.jks -alias upload -file upload_certificate.pem
- En Play Console, ve a Protegido con Play → Protección de Play Store → Gestionar la firma de apps de Play.
- En la sección Certificado de la clave de carga, haz clic en Solicitar restablecimiento de la clave de carga, indica el motivo del restablecimiento, sube tu archivo
upload_certificate.pemy haz clic en Solicitar.
Qué significa esto cuando cambia de manos una cuenta o una app
La clave de firma de la app la gestiona Google y viaja con la app, así que el trabajo de traspaso se concentra en el almacén de claves de carga y en los servicios que confían en tus huellas digitales.
- Obtén el almacén de claves de carga (
.jks) junto con su alias y contraseña, o prevé un restablecimiento de la clave de carga en el lado receptor. - Vuelve a comprobar toda integración que dependa de huellas digitales tras cualquier actualización o restablecimiento: claves de la API de Maps restringidas por SHA-1, Facebook Login, clientes OAuth y
assetlinks.jsonpara App Links. Estos fallan en silencio, no de forma ruidosa. - Una lista de traspaso que todavía pide un SHA-1 está desactualizada: con la firma preparada para la computación cuántica, el proveedor ve tres huellas digitales.
Dos guías relacionadas en este blog: la Google Play lista de verificación para transferir cuentas y apps y el tutorial de control de acceso de Play Console.
Distribuir fuera de Google Play y probar lo que los usuarios reciben realmente
- La misma clave en todas partes: puedes dejar que Google genere la clave de firma de la app y luego descargar desde Play Console o la API de Play Developer un APK universal firmado para distribuir en otras tiendas; ve a Probar y publicar → Últimas versiones y paquetes, selecciona tu paquete de la app y abre la pestaña Descargas. Como alternativa, genera tú mismo la clave de firma de la app y transfiere una copia a Google cuando configures la firma de apps de Play.
- Prueba el artefacto real: usa Internal App Sharing para probar exactamente lo que Play entregará, o descarga los APK específicos de cada dispositivo desde el explorador de paquetes de la app e instálalos localmente con
adb install-multiple *.apk. - APK Signature Scheme v4 se aplica automáticamente a las apps elegibles para admitir una distribución optimizada en dispositivos Android 11 o superiores. No se requiere ninguna acción, salvo que las apps que usan firma híbrida preparada para criptografía cuántica quedan excluidas, porque v4 aún no es compatible con ella.
- Protege el acceso a la consola: exige la verificación en dos pasos para todos los usuarios de la cuenta. Perder el almacén de claves tiene solución; perder la cuenta, no.
Lista de verificación previa
- Clave de carga guardada en un almacén de claves con una copia de seguridad fuera de la máquina de compilación, y el alias y la contraseña anotados en tu gestor de contraseñas.
- La clave de carga y la clave de firma de la app son claves distintas.
- App inscrita en Play App Signing (las apps nuevas se inscriben automáticamente al subir el paquete).
- Todas las huellas de las claves de firma de la app copiadas de Play Console a la consola de cada proveedor de API — las tres claves cuando se usa firma híbrida.
assetlinks.jsonactualizado con las mismas huellas si usas App Links.- La actualización de la clave se hace antes de que una versión esté en pruebas abiertas o en producción si quieres tu propia clave de firma de la app.
- Tras la actualización o el restablecimiento: huellas registradas de nuevo e integraciones probadas otra vez en un dispositivo real.
- Verificación en dos pasos obligatoria para todos los usuarios de Play Console.
La versión en una línea
Tú firmas con la clave de carga, Google firma con la clave de firma de la app, y la Android 17 añade claves poscuánticas a la mezcla; así que mantén una copia de seguridad del almacén de claves de carga, registra cada huella de clave de firma de la app con tus proveedores de API, usa la ruta de actualización anual cuando necesites una clave más fuerte y restablece la clave de carga en Play Console si alguna vez se pierde.
Fuentes
¿Gestionas cuentas de desarrollador a escala? Nosotros nos encargamos de la parte operativa.
Hemos recibido tu mensaje y responderemos en un plazo de 24 horas.
← Volver a editar