KappS Base de conocimiento · Blog

Firma de apps de Google Play en 2026: claves de carga, restablecimiento de claves perdidas y actualizaciones de claves

Blog Guía

Todas las apps de Google Play se firman dos veces: una por ti, antes de la subida, y otra por Google, antes de que el archivo llegue al dispositivo del usuario. La clave que hay detrás de esa segunda firma —la clave de firma de apps— es la única pieza de una app que no puede sustituirse volviendo a subir un paquete, y desde 2026 una gran parte reside en la propia infraestructura de claves de Google. Esta guía explica qué hace Play App Signing, en qué se diferencian los tres tipos de clave, cómo se inscriben las apps nuevas y existentes, qué huellas digitales necesitan realmente tus proveedores de API, qué hacer cuando se pierde una clave de subida y cómo se aplican las actualizaciones de la clave de firma de apps en las distintas versiones de Android.


Por qué la clave de firma importa más que la cuenta

Las cuentas de desarrollador se pueden renombrar, volver a verificar, transferir entre propietarios y migrar a organizaciones. Las claves de firma no. Android decide si una actualización es legítima comprobando que el nuevo APK esté firmado con la misma clave que el instalado; si esa cadena se rompe, la única forma de publicar una «nueva versión» es publicar otra app y pedir a los usuarios que la instalen de nuevo, perdiendo instalaciones, reseñas e historial.

Ese único hecho es la razón de que exista Play App Signing. Desde agosto de 2021, se espera que las apps nuevas en Google Play lo usen, y hoy es la vía predeterminada: Google guarda la clave que firma los APK de distribución, así que un portátil perdido, un almacén de claves robado o un desarrollador que se marcha ya no pueden acabar con la vida de una app. Lo que conservas —y lo que la mayoría sigue llamando "el almacén de claves"— es la clave de carga, y esa sí se puede restablecer.


Tres tipos de clave, tres funciones muy distintas

La documentación de Play separa las claves según quién las posee y qué firman. Acertar con esta correspondencia es lo que evita tanto los errores de autenticación (registrar una huella incorrecta en una API) como el pánico (pensar que un almacén de claves perdido es fatal).

  • Clave de carga: la conservas tú. Se guarda en un almacén de claves Java (.jks o .keystore) y debe ser una clave RSA de 2048 bits o más. La usas para firmar el paquete de la app antes de subirlo; Google la usa para verificar que la carga proviene de ti. Si se pierde o se compromete, Google pueden restablecerla.
  • Clave de firma de la app: la custodia Google Play. Asociada a un certificado público (.der o .pem). Las claves generadas por Google son RSA de 4096 bits; las claves que aportes tú mismo deben ser RSA de 2048 bits o superior. Es la clave que firma los APK optimizados que se entregan a los usuarios. Puedes dejar que Google la genere o aportar la tuya.
  • Claves híbridas preparadas para la computación cuántica, en manos de Google Play. Una firma híbrida que combina una clave RSA clásica de 4096 bits con una clave poscuántica ML-DSA-65. Android 17 y versiones posteriores verifican las apps con el esquema de firma de APK v3.2; los dispositivos más antiguos siguen verificando mediante el bloque de firma clásico. Como Google genera una clave clásica aparte para la ruta anterior a Android 17, una app puede acabar usando tres claves distintas a la vez.

Nota del propio Google sobre el diseño: para máxima seguridad, tu clave de carga y tu clave de firma de la app deben ser claves distintas.

Cuando Google firma tus APK, también marca el manifiesto con com.android.stamp.source y com.android.stamp.type, de modo que un APK entregado siga siendo rastreable hasta el firmante original. Cambiar cualquier cosa en esta página requiere permiso de administrador en la cuenta, y por eso quien tiene el rol de administrador controla en la práctica el futuro de la app, no solo su configuración.


Qué desbloquea la inscripción

Play App Signing no es solo un servicio de custodia de claves. Permitir que Google firme los APK optimizados generados a partir de tus paquetes es lo que habilita la protección automática y la traducción automática de cadenas (impulsada por modelos Gemini), y en los juegos desbloquea servicios como Play Games Sidekick, Play-as-you-download y las pruebas gratuitas de títulos de pago. Una app que gestiona sus propias claves de firma fuera de Play App Signing simplemente no obtiene nada de esto.


Registrar una nueva app

  1. Crea la app. Una app recién creada se inscribe automáticamente en la firma híbrida preparada para criptografía cuántica 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.
  2. Crea una clave de carga. Genera un almacén de claves para firmar tu paquete de lanzamiento, ya sea en Android Studio o con la utilidad keytool de Java desde la línea de comandos. Guarda este archivo y sus contraseñas en un lugar al que sigas teniendo acceso dentro de dos años.
  3. Sube el paquete de la app. Preparar una versión y subir el .aab es lo que completa la inscripción automática.
  4. Opcionalmente, cambia la clave de firma de la app. Los desarrolladores avanzados que quieran gestionar su propia clave pueden hacerlo antes de que se haya implementado ninguna versión en los canales de pruebas abiertas o de producción: 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. Puedes reutilizar la misma clave que otra app de la cuenta de desarrollador o proporcionar una copia de tu propia clave de firma de la app.

Migrar una app existente

Si aún gestionas tus propias claves y subes APK, puedes pasarte a Play App Signing para obtener paquetes de la app y el resto de mejoras de Play:

  1. Ve a Protegido con Play > Distribución en Play Store > Ir a la firma de apps de Play en Play Console.
  2. Acepta los términos del servicio si aún no lo has hecho.
  3. Transfiere una copia de tu clave de firma original. Descarga la herramienta PEPK y sigue las instrucciones paso a paso de Google para cifrar y subir tu clave existente desde el repositorio donde esté. Esto es lo que preserva la ruta de actualización para los usuarios que ya la tienen instalada.
  4. Crear una nueva clave de carga (recomendado). Genera una clave nueva en Android Studio y registra su certificado en la consola, para que la clave que usas en las cargas diarias deje de ser la que firma para los usuarios.

Registra las huellas correctas con tus proveedores de API

Este es el paso que rompe las apps después de la inscripción. Servicios como Google Maps, OAuth o Facebook Login autentican tu app mediante la huella de la clave de firma de la app. Como ahora Google firma el APK final, la huella que llega a los usuarios es la que tiene Google, así que debes registrar la Googlehuella de la clave de firma de la app en cada proveedor, no solo la huella de la clave de carga local.

  • Abre Protegido con Play > Distribución en Play Store > Ir a la firma de apps de Play y desplázate hasta la sección Clave de firma de apps.
  • Copia las huellas SHA-1 o SHA-256 que exige el proveedor y pégalas en la consola de ese proveedor (por ejemplo, Google Cloud Console para Maps y OAuth).
  • Si tu app usa firma híbrida preparada para cúbits, copia y registra las huellas de tres claves: la nueva clave clásica y la clave poscuántica usadas en dispositivos más recientes, además de la clave clásica usada en dispositivos antiguos.
  • Si usas App Links de Android, actualiza assetlinks.json con las mismas huellas digitales.

Cuando se pierde la clave de carga o se ve comprometida

Perder una clave de carga no te deja fuera de tu app. La ruta de recuperación está documentada y es rutinaria:

  1. Crea una nueva clave de carga en Android Studio.
  2. Exporta su certificado a formato PEM:
keytool -export -rfc -keystore upload-keystore.jks -alias upload -file upload_certificate.pem
  1. En Play Console, ve a Protegido con Play > Protección de Play Store > Gestionar la firma de apps de Play.
  2. En la sección Certificado de clave de carga, haz clic en Solicitar restablecimiento de la clave de carga.
  3. Introduce el motivo del restablecimiento, sube el archivo upload_certificate.pem y haz clic en Solicitar.

Hasta que se procese el restablecimiento no puedes subir nuevas versiones, así que planifica la recuperación antes de una fecha límite, no después. Ten en cuenta la asimetría: la clave de carga es restablecible, pero la clave de firma de la app no es algo que puedas pedirle a Google que reemplace a demanda.


Actualizar la clave de firma de la app

Si se compromete una clave de firma de la app, o necesitas una criptográficamente más fuerte, Play admite una actualización anual de clave que se aplica a las instalaciones en Android 17 (nivel de API 37) y versiones posteriores. La aplicación de políticas varía según la versión de la plataforma:

  • Android 17 (API 37) y superiores: la plataforma aplica estrictamente la clave híbrida mejorada preparada para la computación cuántica, verificada mediante el esquema de firma APK v3.2.
  • Android 13 (API 33) a Android 16 (API 36): la plataforma aplica estrictamente tu clave clásica más reciente, según el esquema de firma de APK v3.1.
  • Android 7 (API 24) a Android 12 (API 32): la plataforma en sí no exige la clave actualizada y sigue reconociendo la última clave clásica. Google Play Protect añade una validación comprobando que las actualizaciones estén firmadas con tu última clave clásica, salvo que el usuario lo haya desactivado.

Hay una consecuencia fácil de pasar por alto: como la plataforma no aplica la clave actualizada en Android 12 y versiones anteriores, las apps que comparten la misma clave de firma entre varias apps para compartir datos solo reconocerán, en esas versiones antiguas, la clave heredada para funciones como el uso compartido de permisos personalizados.

Para realizar la actualización: abre Protegido con Play > Distribución en Play Store > Ir a la firma de apps de Play, haz clic en Actualizar clave en la sección Clave de firma de la app, elige una opción —dejar que Google Play genere una clave nueva (recomendado), reutilizar la clave de firma de otra app de la cuenta o aportar una copia de la tuya— y haz clic en Guardar. Después, registra las nuevas huellas digitales con tus proveedores de API. Con la firma híbrida preparada para la computación cuántica, eso significa dos claves nuevas: la nueva clave clásica y la nueva clave poscuántica.


Publicar fuera de Google Play

Si distribuyes la misma app a través de otras Androidtiendas y quieres una única identidad de firma en todas partes, tienes dos opciones:

  • Deja que Google genere la clave de firma de la app y luego descarga un APK universal firmado desde Play Console (Probar y publicar > Últimas versiones y paquetes, selecciona el paquete y abre la pestaña Descargas) o mediante la API de Play Developer, y distribuye ese archivo por otro canal.
  • Genera tú mismo la clave de firma de la app y transfiere una copia a Google al configurar Play App Signing, para que se use la misma clave en todas las tiendas.

Play App Signing también aplica automáticamente el esquema de firma de APK v4 a las apps aptas para admitir una distribución optimizada en Android 11 y versiones posteriores; no se requiere ninguna acción. La excepción son las apps que usan firma híbrida preparada para cúbits, que aún no es compatible con la firma v4.


Los errores que les cuestan instalaciones reales a apps reales

  • Tratar el almacén de claves de carga como algo desechable. Google puede restablecer una clave de carga, pero aun así no podrás subir nada hasta que se procese el restablecimiento. Haz una copia de seguridad del archivo del almacén de claves y de sus contraseñas fuera de la máquina de compilación.
  • Registras solo tu huella digital local. Tras la inscripción, el APK entregado lleva la huella digital de la clave de firma de apps de Google. Los proveedores de mapas, OAuth e inicio de sesión que solo conocen tu huella anterior fallarán.
  • Olvidar assetlinks.json. Android La verificación de App Links depende de las mismas huellas digitales.
  • Cambiar la clave de firma después del lanzamiento. Es posible cambiar la clave de firma predeterminada de la app antes de que algo se implemente en pruebas abiertas o producción, no después. Toma las decisiones sobre claves al crear la app, no en la primera actualización.
  • Ignorar la ruta de la Android antigua en la firma híbrida. Las apps que usan firma preparada para criptografía cuántica tienen tres claves, y los proveedores necesitan todas las huellas relevantes, no solo la más reciente.
  • Dar por hecho que las actualizaciones se comportan igual en todas las versiones de Android. La aplicación de las claves actualizadas termina en Android 12, donde la comprobación la hace Play Protect, no la plataforma.
  • Alojar la clave por tu cuenta en tu propio proyecto de Cloud. Google permite el registro mediante un proyecto de Google Cloud autoalojado para requisitos muy específicos, pero lo documenta como no estándar y no recomendado: asumes toda la responsabilidad de las operaciones de firma, pierdes la recuperación ante desastres y puedes perder optimizaciones avanzadas, ciertas mejoras de Play y funciones como la firma híbrida preparada para la computación cuántica. Google no puede regenerar ni corregir una versión existente en esa configuración; la solución es una nueva versión.
  • Control de acceso débil. Todo en la página de firma de apps es de nivel administrador. Activa la verificación en dos pasos para todos los usuarios de la cuenta.

El modelo en una línea: tu clave de carga demuestra quién eres y siempre puede restablecerse; la clave de firma de la app demuestra la identidad de tu app ante cada dispositivo donde está instalada y es el activo que nunca debes perder ni filtrar. Inscríbete en Play App Signing, registra las huellas gestionadas por Play en todos los lugares donde tu app se autentica y trata el almacén de claves de tu canal de compilación como infraestructura de producción: con copia de seguridad, acceso controlado y sustituido solo de forma deliberada.


¿Gestionas cuentas de desarrollador a escala? Nosotros nos encargamos de la parte operativa.

Haz clic para elegir un archivo · clic derecho → Pegar, o pulsa Ctrl/⌘+V para pegar una captura de pantalla

También puedes arrastrar un archivo a este cuadro.

Respondemos al correo que nos proporciones. Tus datos se quedan con KappS.

✔ Enviado

Hemos recibido tu mensaje y responderemos en un plazo de 24 horas.


← Volver a editar