Google Play App Signing en 2026 : guide pas à pas pour importer des clés, mettre à niveau des clés et les réinitialiser
Play App Signing répartit la signature d’application en deux tâches : vous conservez une clé, Google conserve une clé. En 2026, une troisième clé s’y est ajoutée — la moitié post-quantique de la nouvelle signature hybride — ce qui explique pourquoi les empreintes que vous enregistrez auprès de Google Maps, OAuth ou Facebook Login ne sont plus une valeur unique. Voici le modèle complet des clés issu de la documentation Play Console de Google, les chemins exacts dans la console et les deux opérations les plus importantes en pratique : la mise à niveau annuelle de la clé de signature d’application et la réinitialisation de la clé d’importation.
Ce que vous réglez aujourd’hui : savoir quelle clé sert à quoi, configurer Play App Signing pour une application nouvelle ou existante, enregistrer les bonnes empreintes (jusqu’à trois), mettre à niveau une clé de signature d’application et réinitialiser une clé d’upload perdue sans perdre l’application ni la fiche.
Deux clés, trois avec signature post-quantique
Conformément à Utiliser Play App Signing, chaque application sous Play App Signing dispose de clés distinctes, chacune avec son propre détenteur, format et règles de récupération.
- Clé d’upload — la vôtre. Format : un keystore Java (
.jksou.keystore). Exigence : RSA de 2048 bits ou plus. Vous l’utilisez pour signer votre app bundle avant de le téléverser dans la Play Console, et Google s’en sert pour vérifier votre identité. Si elle est compromise ou perdue, Google peut la réinitialiser pour vous — c’est tout l’intérêt de la séparation. - Clé de signature de l’application — celle de Google Play. Format : un certificat public (
.derou.pem). Les clés générées par Google sont en RSA 4096 bits ; une clé personnalisée que vous fournissez doit être en RSA 2048 bits ou plus. Google utilise cette clé pour signer les APK finaux livrés sur les appareils des utilisateurs. Gérez-la vous-même, en dehors de la signature d’application Play, et si vous la perdez, elle ne peut pas être réinitialisée. - Clés prêtes pour le post-quantique de Quantum — celles de Google Play, ajoutées pour Android 17. La signature hybride associe une clé classique RSA 4096 bits à une clé post-quantique ML-DSA-65. Google génère une nouvelle clé classique pour la signature hybride, différente de la clé classique utilisée pour les appareils antérieurs à Android 17, si bien que l’application finit par utiliser trois clés distinctes. Android 17 et versions ultérieures vérifient l’application avec le schéma de signature APK v3.2, qui contient exactement deux signataires dans un bloc hybride ; les versions plus anciennes de Android continuent de vérifier l’application avec les blocs de signature classiques.
Pour une sécurité maximale, votre clé d’upload et votre clé de signature d’application doivent être des clés différentes. Et lorsque Google signe vos APK avec la clé de signature d’application, il utilise apksigner pour ajouter deux tampons au manifeste, com.android.stamp.source et com.android.stamp.type, afin que les APK restent traçables jusqu’au signataire d’origine.
Nouvelle application : la signature post-quantique est désormais la norme
- Créez l’application. Elle est automatiquement inscrite à la signature hybride prête pour le 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.
- Créer une clé de téléversement — générez un keystore dans Android Studio, ou utilisez l'utilitaire Java
keytoolen ligne de commande. - Importez votre app bundle. L’inscription se fait à l’import ; il n’y a pas d’étape d’activation distincte.
- Facultatif : changer la clé de signature de l’application si vous préférez la gérer vous-même. Rendez-vous dans Protégé par Play → Distribution sur le Play Store → Accéder à la signature d’application Play et cliquez sur Changer la clé de signature de l’application. Cela n’est possible qu’avant qu’une version ne soit déployée sur le canal de test ouvert ou le canal de production, et vous pouvez soit utiliser la clé de signature d’une autre application du même compte développeur, soit fournir une copie de votre propre clé.
Application existante : s'inscrire via l'outil PEPK
Si vous signez et téléversez encore vos propres APK, vous pouvez migrer vers la signature d'application Play pour obtenir des app bundles et les améliorations Play qui les accompagnent.
- Dans Play Console, accédez à Protégé par Play → Diffusion sur le Play Store → Accéder à la signature d’application Play et acceptez les conditions d’utilisation si ce n’est pas déjà fait.
- Transférez une copie de votre clé d'origine. Téléchargez l'outil PEPK et suivez les instructions unifiées pas à pas pour chiffrer et importer votre clé de signature d'application existante depuis n'importe quel dépôt.
- Créer une nouvelle clé d’importation (recommandé). Générez une nouvelle clé dans Android Studio et enregistrez son certificat dans la Play Console.
Enregistrez jusqu’à trois empreintes auprès de vos fournisseurs d’API
Maps, OAuth et Facebook Login authentifient votre application par l’empreinte de la clé de signature de l’application. Comme Google signe l’APK final, vous devez enregistrer auprès de ces fournisseurs l’empreinte de la clé de signature détenue par Google — n’enregistrer que votre clé de téléversement locale est la panne classique après migration.
- Allez dans Protégé par Play → Distribution sur le Play Store → Accéder à la signature d'application Play.
- Faites défiler jusqu’à la section Clé de signature de l’application et copiez les empreintes SHA-1 ou SHA-256.
- Si votre application utilise la signature hybride post-quantique, copiez les empreintes des trois clés et enregistrez-les toutes : la nouvelle clé classique et la clé PQC utilisée sur les appareils récents, plus la clé classique utilisée sur les appareils plus anciens.
- Collez-les dans la console de chaque fournisseur (par exemple Google Cloud Console). Si vous utilisez Android App Links, mettez à jour
assetlinks.jsonavec les mêmes empreintes.
Mettez à niveau la clé de signature de l’application — une fois par an, quand vous en avez besoin
Si la clé de signature de l'application est compromise, ou si vous voulez une clé cryptographiquement plus forte, vous pouvez demander une mise à niveau annuelle de la clé. La mise à niveau s'applique à toutes les installations sur Android 17 (niveau d'API 37) et supérieur, et l'application des règles diffère selon la version de la plateforme :
- Android 17 (niveau d’API 37) et versions supérieures — la plateforme applique strictement la clé hybride mise à niveau, prête pour le post-quantique (schéma de signature APK v3.2).
- Android 13 à 16 (niveaux d’API 33–36) — la plateforme applique strictement votre dernière clé classique (schéma de signature APK v3.1).
- Android 7 à 12 (niveaux d’API 24–32) — la plateforme n’applique pas la clé mise à niveau et reconnaît toujours la dernière clé classique ; Play Protect ajoute une validation que les mises à jour sont signées avec votre dernière clé classique, sauf si l’utilisateur a désactivé cette option.
Réserve sur les données partagées : comme la clé mise à niveau n’est pas appliquée sur l’API 32 et inférieure, si vous utilisez la même clé sur plusieurs applications pour partager des données, ces anciennes versions Android ne reconnaîtront que la clé héritée pour des fonctionnalités telles que le partage d’autorisations personnalisées.
Comment passer à l'offre supérieure :
- Allez dans Protégé par Play → Distribution sur le Play Store → Accéder à la signature d'application Play.
- Dans la section App signing key, cliquez sur Upgrade key.
- Choisissez votre voie : laissez Google Play générer une nouvelle clé de signature d’application (recommandé), utilisez la même clé de signature que pour une autre application de ce compte développeur, ou fournissez une copie de votre clé de signature d’application.
- Cliquez sur Enregistrer.
- Enregistrez les nouvelles empreintes auprès de vos fournisseurs d’API — avec une signature prête pour le post-quantique, cela signifie deux nouvelles clés : la nouvelle clé classique et la nouvelle clé PQC.
Réinitialiser une clé d'upload perdue
Une clé d’upload perdue ou soupçonnée compromise ne vous verrouille pas l’accès à votre application.
- Créer une nouvelle clé d'upload dans Android Studio.
- Exportez le certificat au format PEM :
keytool -export -rfc -keystore upload-keystore.jks -alias upload -file upload_certificate.pem
- Dans la Play Console, allez dans Protégé par Play → Protection Play Store → Gérer la signature d’application Play.
- Dans la section Certificat de clé d’importation, cliquez sur Demander la réinitialisation de la clé d’importation, saisissez le motif de la réinitialisation, importez votre fichier
upload_certificate.pemet cliquez sur Demander.
Ce que cela implique lorsqu’un compte ou une application change de mains
La clé de signature de l’application est détenue par Google et voyage avec l’application ; le travail de transfert se concentre donc sur le keystore d’upload et sur les services qui font confiance à vos empreintes.
- Récupérez le keystore d’envoi (
.jks) avec son alias et son mot de passe, ou prévoyez une réinitialisation de la clé d’envoi côté destinataire. - Revérifiez toute intégration dépendant d’une empreinte après chaque mise à niveau ou réinitialisation : clés d’API Maps restreintes par SHA-1, Facebook Login, clients OAuth et
assetlinks.jsonpour les App Links. Ces échecs sont silencieux, pas bruyants. - Une liste de transfert qui réclame encore un seul SHA-1 est obsolète : avec une signature prête pour le post-quantique, le prestataire voit trois empreintes.
Deux tutoriels liés sur ce blog : la liste de vérification pour le transfert de compte et d’application Google Play et le tutoriel sur le contrôle d’accès à Play Console.
Diffuser hors de Google Play, et tester ce que les utilisateurs reçoivent réellement
- La même clé partout : vous pouvez laisser Google générer la clé de signature de l’application, puis télécharger un APK universel signé depuis Play Console ou l’API Play Developer pour le distribuer sur d’autres stores — allez dans Test & release → Dernières versions et bundles, sélectionnez votre app bundle et ouvrez l’onglet Téléchargements. Vous pouvez aussi générer vous-même la clé de signature de l’application et en transférer une copie à Google lors de la configuration de Play App Signing.
- Testez l’artefact réel : utilisez Internal App Sharing pour tester exactement ce que Play livrera, ou téléchargez les APK spécifiques à l’appareil depuis l’explorateur d’app bundle et installez-les localement avec
adb install-multiple *.apk. - APK Signature Scheme v4 est appliqué automatiquement aux applications éligibles pour prendre en charge une distribution optimisée sur les appareils Android 11+. Aucune action requise — sauf que les applications utilisant la signature hybride post-quantique sont exclues, car la v4 n’est pas encore compatible avec elle.
- Protégez l’accès à la console : imposez la validation en deux étapes à tous les utilisateurs du compte. Perdre le keystore est récupérable ; perdre le compte ne l’est pas.
Liste de vérification avant soumission
- Clé d’importation stockée dans un keystore avec une sauvegarde hors de la machine de build, alias et mot de passe consignés dans votre gestionnaire de mots de passe.
- La clé d’envoi et la clé de signature de l’application sont deux clés différentes.
- App inscrite à Play App Signing (les nouvelles apps y sont inscrites automatiquement lors de l’envoi du bundle).
- Toutes les empreintes de clé de signature d’application copiées depuis la Play Console dans chaque console de fournisseur d’API — les trois clés lorsque la signature hybride est utilisée.
assetlinks.jsonmis à jour avec les mêmes empreintes si vous utilisez les App Links.- Effectuez la mise à niveau de la clé avant qu’une version ne soit en test ouvert ou en production si vous voulez votre propre clé de signature d’application.
- Après mise à niveau ou réinitialisation : empreintes réenregistrées et intégrations retestées sur un appareil réel.
- Validation en deux étapes imposée à chaque utilisateur de la Play Console.
La version en une ligne
Vous signez avec la clé d’upload, Google signe avec la clé de signature d’application, et Android 17 ajoute des clés post-quantiques à l’équation — gardez donc le keystore d’upload sauvegardé, enregistrez chaque empreinte de clé de signature d’application auprès de vos fournisseurs d’API, utilisez le parcours de mise à niveau annuel quand vous avez besoin d’une clé plus robuste, et réinitialisez la clé d’upload dans Play Console si elle est perdue.
Sources
Vous gérez des comptes développeur à grande échelle ? Nous prenons en charge le volet opérationnel.
Nous avons bien reçu votre message et vous répondrons sous 24 heures.
← Retour à la modification