KappS Base de connaissances · FAQ

Implémentation et migration de l’API Google Play Integrity sur Google Play

FAQ Conformité technique

1. La migration n’est pas facultative — SafetyNet est totalement désactivé. Google indique dans son calendrier de dépréciation : « L’API SafetyNet Attestation a été dépréciée en 2022 et totalement désactivée en janvier 2025. Les développeurs doivent migrer vers l’API Play Integrity, qui regroupe plusieurs offres d’intégrité (y compris le verdict d’intégrité de SafetyNet Attestation) sous une seule API. » Tout appel encore présent échoue désormais : « Si vous essayez d’appeler l’API SafetyNet Attestation, vous recevrez une erreur. L’API attest retourne une tâche qui invoque toujours l’écouteur onFailure avec une ApiException et un code de statut 7 (NETWORK_ERROR). » Si vous livrez encore une version qui appelle SafetyNet, demandez à vos utilisateurs de mettre à jour. (https://developer.android.com/privacy-and-security/safetynet/deprecation-timeline)

2. Ce que l’API vérifie réellement. « L’API Play Integrity vous aide à vérifier que les actions des utilisateurs et les requêtes serveur proviennent de votre véritable application, installée par Google Play, s’exécutant sur un appareil Android authentique et certifié. » Elle renvoie trois verdicts principaux : accountDetails (accès non autorisé — si l’utilisateur a installé ou payé l’application sur Google Play), appIntegrity (altération du code — si le binaire est bien celui non modifié que Google Play reconnaît) et deviceIntegrity (appareils à risque et environnements émulés — un appareil Android authentique et certifié ou une instance authentique de Google Play Games for PC). Des verdicts facultatifs ajoutent MEETS_STRONG_INTEGRITY (mises à jour de sécurité récentes, Android 13+), appAccessRiskVerdict (capture d’écran, superpositions et abus des services d’accessibilité par d’autres applications), playProtectVerdict (Play Protect activé et aucune application dangereuse), recentDeviceActivity (volume de requêtes anormalement élevé) et deviceRecall (bêta). (https://developer.android.com/google/play/integrity/overview)

3. Créez et associez un projet Google Cloud. « Pour intégrer l’API, vous devez disposer d’un projet Google Cloud… Vous pouvez ensuite associer votre projet Google Cloud dans la Google Play Console (pour les applications) ou la console SDK Google Play (pour les SDK). L’association de votre projet est obligatoire » pour débloquer les fonctionnalités avancées et les augmentations de quota. Vous pouvez activer l’API Play Integrity dans la console Google Cloud, ou associer d’abord le projet et l’API s’active automatiquement. Attention au piège : « Les projets activés dans la console Google Cloud mais non associés dans la Play Console ou la console Play SDK ne sont pas éligibles aux fonctionnalités supplémentaires. » (https://developer.android.com/google/play/integrity/setup)

4. Choisissez entre requêtes standard ou classiques — elles diffèrent en latence et en mise en cache. Les requêtes standard ont la latence la plus faible (« quelques centaines de millisecondes en moyenne ») et une fiabilité élevée d’obtention d’un verdict exploitable, utilisent une mise en cache intelligente sur l’appareil et délèguent à Google Play la protection contre certaines attaques ; vous préparez (« préchauffez ») le fournisseur de jetons une seule fois — une instance « ne peut préparer le jeton d’intégrité que jusqu’à 5 fois par minute » — puis demandez un jeton à la demande. Les requêtes classiques, la voie d’origine, ont une latence plus élevée (« quelques secondes en moyenne »), lancent une évaluation complète qui consomme davantage de données et de batterie de l’utilisateur, et vous laissent certaines atténuations, elles doivent donc être effectuées « rarement, de manière ponctuelle » pour une action hautement sensible ou de grande valeur. Les deux nécessitent Android 6.0 (niveau d’API 23) ou supérieur. Règle explicite : « Si vous envisagez d’effectuer une requête classique et de la mettre en cache pour l’utiliser plus tard, vous devriez plutôt effectuer une requête standard afin de réduire le risque d’attaques. » (https://developer.android.com/google/play/integrity/overview, https://developer.android.com/google/play/integrity/standard)

5. Vérifiez sur votre serveur, jamais sur le client. Le flux est le suivant : l’application prépare le fournisseur de jetons avec le numéro de votre projet Google Cloud ; elle demande un jeton d’intégrité en transmettant un hash de requête ; elle reçoit un jeton signé et chiffré et le transmet à votre backend ; puis « le backend de votre application envoie le jeton à un serveur Google Play. Le serveur Google Play déchiffre et vérifie le verdict, puis renvoie les résultats au backend de votre application. » N’appliquez le verdict que dans le backend — une vérification côté client peut être contournée par un patch. (https://developer.android.com/google/play/integrity/standard)

6. Liez les jetons à la requête spécifique. Les requêtes standard sont liées à un hachage de requête que vous fournissez lors de la demande du jeton ; les requêtes classiques utilisent le champ nonce avec une liaison de contenu basée sur les données de la requête ou une logique côté serveur. Ne mettez pas les verdicts en cache et ne les réutilisez pas : « Caching a verdict increases the risk of attacks such as exfiltration and replay. » Si vous étiez sur le point de mettre en cache un verdict classique pour plus tard, passez à une requête standard. (https://developer.android.com/google/play/integrity/classic)

7. Respectez le quota. « Par défaut, votre application peut effectuer jusqu’à 10 000 requêtes par jour au total, toutes installations confondues » — vous pouvez demander un maximum quotidien plus élevé, mais prévoyez votre budget en conséquence et préparez le fournisseur de tokens à faible fréquence (jusqu’à 5 fois par minute et par instance). (https://developer.android.com/google/play/integrity/overview)

8. Déployez les verdicts sans pénaliser les utilisateurs légitimes. Recommandation explicite de Google : « implémentez l’API sans application des règles » d’abord, « recueillez la télémétrie et comprenez votre audience avant d’agir », puis estimez l’impact de toute application des règles envisagée et ajustez votre stratégie anti-abus. Traitez l’API comme un signal parmi d’autres, pas comme la stratégie entière : « L’API Play Integrity donne les meilleurs résultats lorsqu’elle est utilisée aux côtés d’autres signaux dans le cadre de votre stratégie anti-abus globale, et non comme votre unique mécanisme anti-abus. » L’API est disponible sur téléphones, tablettes, pliables, Android Auto, Android TV, Android XR, ChromeOS, Wear OS et Google Play Games sur PC. (https://developer.android.com/google/play/integrity/overview)

Limites de version et de quota (vérifiées sur les pages de Google le 2026-10-13) :

Versions de la bibliothèque. Les versions actuelles (série 1.5.x) exigent le niveau d’API Android 23 (Android 6.0) ou supérieur pour les requêtes standard et classiques ; la série 1.4.0 prenait en charge le niveau d’API 21 (Android 5.0) et supérieur. Vérifiez le minimum pour la version exacte que vous utilisez dans les notes de version de la bibliothèque plutôt que dans un tutoriel.

Types de quotas. La limite par défaut est de 10 000 requêtes par jour, liée au numéro de projet Cloud associé, et Google compte les demandes de jeton (côté client) et les déchiffrements de jeton (côté serveur) comme des actions de quota distinctes — une forte sollicitation côté client ne consomme pas à elle seule le quota de déchiffrement côté serveur. Pour un volume plus élevé, il faut demander une augmentation de quota auprès de Google.

Liaison de projet. L’API nécessite un projet Cloud Google lié à votre application dans la Play Console (ou à votre SDK dans la Play SDK Console). Le quota est lié à ce numéro de projet, donc les applications qui partagent un même projet Cloud partagent une même limite.