KappS Base de connaissances · Blog

Signature d’application Google Play en 2026 : clés d’import, réinitialisations de clé perdue et mises à niveau de clé

Blog Guide

Chaque application sur Google Play est signée deux fois : une fois par vous, avant l’envoi, et une fois par Google, avant que le fichier n’atteigne l’appareil d’un utilisateur. La clé derrière cette seconde signature — la clé de signature d’application — est le seul élément d’une application qui ne peut pas être remplacé en renvoyant un bundle, et depuis 2026 une grande partie réside dans l’infrastructure de clés propre à Google. Ce guide couvre ce que fait Play App Signing, en quoi les trois types de clés diffèrent, comment les applications nouvelles et existantes s’inscrivent, quelles empreintes vos fournisseurs d’API ont réellement besoin, que faire lorsqu’une clé d’envoi est perdue, et comment les mises à niveau de la clé de signature d’application sont appliquées selon les versions de Android.


Pourquoi la clé de signature compte plus que le compte

Les comptes développeur peuvent être renommés, revérifiés, transférés entre propriétaires et migrés vers des organisations. Les clés de signature, non. Android détermine si une mise à jour est légitime en vérifiant que le nouvel APK est signé avec la même clé que celui installé — si cette chaîne se rompt, le seul moyen de livrer une « nouvelle version » est de publier une application différente et de demander aux utilisateurs de la réinstaller, en perdant installations, avis et historique.

C’est précisément pour cette raison que Play App Signing existe. Depuis août 2021, les nouvelles applications sur Google Play sont censées l’utiliser, et c’est aujourd’hui la voie par défaut : Google détient la clé qui signe les APK de distribution, de sorte qu’un ordinateur portable perdu, un keystore volé ou un développeur qui s’en va ne peuvent plus mettre fin à la vie d’une application. Ce que vous conservez — et que la plupart des gens appellent encore « le keystore » — c’est la clé de téléversement, et celle-ci peut être réinitialisée.


Trois types de clés, trois rôles très différents

La documentation de Play elle-même distingue les clés selon qui les détient et ce qu’elles signent. C’est cette correspondance correcte qui évite à la fois les bugs d’authentification (mauvaise empreinte enregistrée auprès d’une API) et la panique (croire qu’un keystore perdu est fatal).

  • Clé d’import — conservée par vous. Stockée dans un keystore Java (.jks ou .keystore) et doit être une clé RSA de 2048 bits ou plus. Vous l’utilisez pour signer l’app bundle avant l’import ; Google s’en sert pour vérifier que l’import provient bien de vous. En cas de perte ou de compromission, Google peut la réinitialiser.
  • Clé de signature de l’application — détenue par Google Play. Associée à un certificat public (.der ou .pem). Les clés générées par Google sont en RSA 4096 bits ; les clés que vous fournissez vous-même doivent être en RSA 2048 bits ou plus. C’est la clé qui signe les APK optimisés livrés aux utilisateurs. Vous pouvez laisser Google la générer ou fournir la vôtre.
  • Clés hybrides prêtes pour le post-quantique — détenues par Google Play. Une signature hybride qui combine une clé RSA classique de 4096 bits avec une clé post-quantique ML-DSA-65. Android 17 et versions supérieures vérifient les applications avec le schéma de signature APK v3.2 ; les appareils plus anciens continuent de vérifier via le bloc de signature classique. Comme Google génère une clé classique distincte pour le chemin antérieur à Android 17, une application peut finir par utiliser trois clés distinctes en même temps.

La note de Google sur la conception : pour une sécurité maximale, votre clé d'import et votre clé de signature d'application doivent être des clés différentes.

Lorsque Google signe vos APK, il appose également dans le manifeste com.android.stamp.source et com.android.stamp.type, afin qu'un APK livré reste traçable jusqu'au signataire d'origine. Modifier quoi que ce soit sur cette page exige la permission d'administrateur sur le compte — c'est pourquoi la personne qui détient les droits d'administrateur contrôle en réalité l'avenir de l'application, pas seulement ses paramètres.


Ce que l'inscription débloque

Play App Signing n’est pas seulement un service de garde de clés. Laisser Google signer les APK optimisés générés à partir de vos bundles, c’est ce qui active la protection automatique et la traduction automatique des chaînes (propulsée par les modèles Gemini), et pour les jeux, cela débloque des services comme Play Games Sidekick, Play-as-you-download et les essais gratuits des titres payants. Une application qui gère ses propres clés de signature en dehors de Play App Signing n’en bénéficie tout simplement pas.


Enrôler une nouvelle application

  1. Créez l'application. Une application nouvellement créée est automatiquement inscrite à la signature hybride compatible post-quantique avec des clés générées par Google ; Google génère aussi une clé classique distincte pour les blocs de signature reconnus sur Android 16 et versions antérieures.
  2. Créez une clé d’upload. Générez un keystore pour signer votre bundle de release — soit dans Android Studio, soit avec l’utilitaire Java keytool en ligne de commande. Conservez ce fichier et ses mots de passe dans un endroit où vous les aurez encore dans deux ans.
  3. Téléversez l’app bundle. Préparer une version et téléverser le fichier .aab est ce qui finalise l’inscription automatique.
  4. Optionally change the app signing key. Les développeurs avancés qui souhaitent gérer leur propre clé peuvent le faire avant qu’une version n’ait été déployée sur les canaux de test ouvert ou de production : allez dans Protected with Play > Play Store distribution > Go to Play app signing et cliquez sur Change the app signing key. Vous pouvez soit réutiliser la même clé qu’une autre application du compte développeur, soit fournir une copie de votre propre clé de signature d’application.

Migrer une application existante

Si vous gérez encore vos propres clés et uploadez des APK, vous pouvez passer à la signature d'application Play pour obtenir des app bundles et le reste des améliorations Play :

  1. Rendez-vous dans Protected with Play > Play Store distribution > Go to Play app signing dans la Play Console.
  2. Acceptez les conditions d'utilisation si ce n'est pas déjà fait.
  3. Transférez une copie de votre clé de signature d’origine. Téléchargez l’outil PEPK et suivez les instructions pas à pas de Google pour chiffrer et importer votre clé existante depuis le dépôt où elle se trouve. C’est ce qui préserve le chemin de mise à jour pour les utilisateurs déjà installés.
  4. Créez une nouvelle clé d’importation (recommandé). Générez une clé neuve dans Android Studio et enregistrez son certificat dans la console, afin que la clé utilisée pour les imports quotidiens ne soit plus celle qui signe pour les utilisateurs.

Enregistrez les bonnes empreintes auprès de vos fournisseurs d’API

C’est l’étape qui casse les applications après l’inscription. Des services comme Google Maps, OAuth ou Facebook Login authentifient votre application grâce à l’empreinte de la clé de signature de l’application. Comme Google signe désormais l’APK final, l’empreinte qui parvient aux utilisateurs est celle détenue par Google — vous devez donc enregistrer auprès de chaque fournisseur l’Googleempreinte de la clé de signature détenue par la plateforme, et pas seulement l’empreinte de la clé de téléversement locale.

  • Ouvrez Protected with Play > Play Store distribution > Go to Play app signing et faites défiler jusqu'à la section App signing key.
  • Copiez les empreintes SHA-1 ou SHA-256 exigées par le fournisseur et collez-les dans la console de ce fournisseur (par exemple, Google Cloud Console pour Maps et OAuth).
  • Si votre application utilise la signature hybride prête pour le post-quantique, copiez et enregistrez les empreintes des trois clés : la nouvelle clé classique et la clé post-quantique utilisées sur les appareils récents, plus la clé classique utilisée sur les appareils plus anciens.
  • Si vous utilisez les App Links Android, mettez à jour assetlinks.json avec les mêmes empreintes.

En cas de perte ou de compromission de la clé d'upload

Perdre une clé d’upload ne vous verrouille pas hors de votre application. Le parcours de récupération est documenté et courant :

  1. Créer une nouvelle clé d'upload dans Android Studio.
  2. Exportez son certificat au format PEM :
keytool -export -rfc -keystore upload-keystore.jks -alias upload -file upload_certificate.pem
  1. Dans la Play Console, rendez-vous dans Protected with Play > Play Store protection > Manage Play app signing.
  2. Dans la section Certificat de clé de téléversement, cliquez sur Demander la réinitialisation de la clé de téléversement.
  3. Saisissez le motif de la réinitialisation, importez le fichier upload_certificate.pem et cliquez sur Demander.

Tant que la réinitialisation n’est pas traitée, vous ne pouvez pas téléverser de nouvelles versions : planifiez donc la récupération avant une échéance, pas après. Notez l’asymétrie : la clé de téléversement est réinitialisable, la clé de signature d’application n’est pas quelque chose que vous pouvez simplement demander à Google de remplacer à la demande.


Mise à niveau de la clé de signature de l’application

Si une clé de signature d'application est compromise, ou si vous avez besoin d'une clé cryptographiquement plus robuste, Play prend en charge une mise à niveau annuelle de clé qui s'applique aux installations sur Android 17 (niveau d'API 37) et versions ultérieures. L'application des règles diffère selon la version de la plateforme :

  • Android 17 (API 37) et versions supérieures : la plateforme applique strictement la clé hybride post-quantique mise à niveau, vérifiée via le schéma de signature APK v3.2.
  • Android 13 (API 33) à Android 16 (API 36) : la plateforme applique strictement votre dernière clé classique, selon le schéma de signature APK v3.1.
  • Android 7 (API 24) à Android 12 (API 32) : la plateforme elle-même n’impose pas la clé mise à niveau et reconnaît toujours la dernière clé classique. Google Play Protect ajoute une validation en vérifiant que les mises à jour sont signées avec votre dernière clé classique, sauf si l’utilisateur a désactivé cette option.

Une conséquence est facile à manquer : comme la plateforme n’applique pas la clé mise à niveau sur Android 12 et versions antérieures, les applications qui partagent la même clé de signature entre plusieurs applications pour partager des données ne reconnaîtront, sur ces versions plus anciennes, que la clé historique pour des fonctionnalités telles que le partage d’autorisations personnalisées.

Pour lancer la mise à niveau : ouvrez Protégé par Play > Distribution sur le Play Store > Accéder à la signature d’application Play, cliquez sur Mettre à niveau la clé dans la section Clé de signature d’application, choisissez une option — laisser Google Play générer une nouvelle clé (recommandé), réutiliser la clé de signature d’application d’une autre application du compte, ou fournir une copie de la vôtre — puis cliquez sur Enregistrer. Enregistrez ensuite les nouvelles empreintes auprès de vos fournisseurs d’API. Avec la signature hybride prête pour le post-quantique, cela signifie deux nouvelles clés : la nouvelle clé classique et la nouvelle clé post-quantique.


Publier en dehors de Google Play

Si vous distribuez la même application via d’autres Android stores et souhaitez une identité de signature unique partout, deux options s’offrent à vous :

  • Laissez Google générer la clé de signature de l’application, puis téléchargez un APK universel signé depuis la Play Console (Test & release > Latest releases and bundles, sélectionnez l’app bundle, ouvrez l’onglet Downloads) ou via l’API Play Developer, et distribuez ce fichier ailleurs.
  • Générez vous-même la clé de signature de l'application et transférez-en une copie à Google lors de la configuration de Play App Signing, afin que la même clé soit utilisée sur tous les stores.

Play App Signing applique aussi automatiquement le schéma de signature APK v4 pour les apps éligibles afin de prendre en charge une distribution optimisée sur Android 11 et versions ultérieures — aucune action requise. L’exception concerne les apps utilisant une signature hybride prête pour le quantique, encore incompatible avec la signature v4.


Les pièges qui coûtent de vraies installations à de vraies applications

  • Traiter le keystore d’upload comme jetable. Google peut réinitialiser une clé d’upload, mais vous ne pouvez toujours rien uploader tant que la réinitialisation n’est pas traitée. Sauvegardez le fichier keystore et ses mots de passe en dehors de la machine de build.
  • Enregistrement de votre seule empreinte locale. Après l’enrôlement, l’APK livré porte l’empreinte de la clé de signature d’application de Google. Les services de cartes, OAuth et de connexion qui ne connaissent que votre ancienne empreinte échoueront.
  • Oublier assetlinks.json. Android La vérification App Links dépend des mêmes empreintes.
  • Modifier la clé de signature après la publication. Il est possible de changer la clé de signature d’application par défaut avant tout déploiement en test ouvert ou en production — pas après. Prenez vos décisions de clé à la création de l’application, pas à la première mise à jour.
  • Ignorer l'ancien chemin Android dans la signature hybride. Les applications utilisant une signature prête pour le post-quantique ont trois clés, et les fournisseurs ont besoin de toutes les empreintes pertinentes, pas seulement de la plus récente.
  • Supposer que les mises à jour se comportent de la même façon sur toutes les versions de Android. L’application des clés mises à niveau s’arrête à Android 12, où c’est Play Protect — et non la plateforme — qui effectue la vérification.
  • Héberger la clé vous-même dans votre propre projet Cloud. Google permet l’enrôlement via un projet Google Cloud auto-hébergé pour des besoins très spécifiques, mais le documente comme non standard et déconseillé : vous assumez l’entière responsabilité des opérations de signature, perdez la reprise après sinistre et pouvez perdre des optimisations avancées, certaines améliorations Play et des fonctionnalités comme la signature hybride prête pour le quantique. Google ne peut ni régénérer ni corriger une version existante dans cette configuration ; la solution est une nouvelle version.
  • Contrôle d’accès insuffisant. Tout, sur la page de signature d’application, relève du niveau administrateur. Imposez la validation en deux étapes à chaque utilisateur du compte.

Le modèle en une ligne : votre clé d’upload prouve qui vous êtes et peut toujours être réinitialisée ; la clé de signature de l’application prouve l’identité de votre application à chaque appareil installé et c’est l’actif que vous ne devez jamais perdre ni divulguer. Inscrivez-vous à Play App Signing, enregistrez les empreintes détenues par Play partout où votre application s’authentifie, et traitez le keystore de votre pipeline de build comme une infrastructure de production — sauvegardé, à accès contrôlé, et remplacé uniquement délibérément.


Vous gérez des comptes développeur à grande échelle ? Nous prenons en charge le volet opérationnel.

Cliquez pour choisir un fichier · clic droit → Coller, ou appuyez sur Ctrl/⌘+V pour coller une capture d’écran

Vous pouvez aussi glisser un fichier sur cette zone.

Nous répondons à l’e-mail que vous indiquez. Vos données restent chez KappS.

✔ Soumis

Nous avons bien reçu votre message et vous répondrons sous 24 heures.


← Retour à la modification