Cette page explique comment utiliser le rappel de données appareil pour stocker et récupérer des données personnalisées sur des appareils spécifiques. Vous pouvez rappeler les données personnalisées de manière fiable ultérieurement lorsque votre application est installée sur le même appareil, même après la réinitialisation de l'appareil. Cela vous permet de détecter et d'empêcher la réutilisation d'un appareil en fonction d'une action ou d'un comportement que vous spécifiez, tout en préservant la confidentialité des utilisateurs.
Comment fonctionne le rappel de données appareil ?
Le rappel de données appareil permet aux applications de stocker et de récupérer des données personnalisées associées à un appareil spécifique tout en préservant la confidentialité des utilisateurs. Les données étant stockées sur les serveurs Google, votre appli peut les rappeler de manière fiable, même après sa réinstallation ou la réinitialisation de l'appareil. Par exemple, vous pouvez utiliser cette fonctionnalité pour rappeler les appareils sur lesquels vous avez constaté des abus graves, les appareils qui ont déjà utilisé des éléments de grande valeur (comme un essai sans frais) ou les appareils utilisés de manière répétée pour créer des comptes à des fins abusives. Le rappel de données appareil préserve la confidentialité des utilisateurs, car l'application à l'origine de la demande ne peut rappeler que les données limitées qu'elle a associées aux appareils, sans accéder aux identifiants des appareils ou aux identifiants utilisateur. Une fois le rappel de données appareil activé, vous pouvez effectuer les opérations suivantes :
- Lire les données par appareil : vous pouvez lire trois valeurs ou bits personnalisés pour chaque appareil lorsque vous obtenez une évaluation d'intégrité. Vous pouvez définir votre propre signification pour ces valeurs. Par exemple, vous pouvez traiter les valeurs comme trois indicateurs distincts ou les combiner pour représenter huit étiquettes personnalisées.
- Modifier les données par appareil : une fois que vous avez obtenu un jeton d'intégrité, vous pouvez l'utiliser pour effectuer un appel côté serveur vers le serveur de Google Play afin de modifier une ou plusieurs valeurs. Vous disposez de 14 jours pour utiliser le jeton. Cela vous permet de modifier une valeur si, par exemple, un abus ne devient évident que dans les deux semaines suivant la première vérification d'intégrité. Lorsque vous modifiez une valeur, le mois et l'année de la modification sont également stockés.
Conditions préalables et points à noter concernant le rappel de données appareil
Le rappel de données appareil ne peut être utilisé que pour stocker et rappeler des informations afin de protéger la sécurité de l'application et de limiter les abus, la fraude et les accès non autorisés. Vous ne pouvez pas utiliser le rappel de données appareil pour créer une empreinte numérique ou suivre des utilisateurs ou des appareils individuels, ni pour suivre des caractéristiques sensibles de l'utilisateur ou de l'appareil, telles que le genre, l'âge ou les données de localisation.
Le rappel de données appareil est soumis aux conditions préalables suivantes :
- Le rappel de données appareil peut être utilisé sur les téléphones, les tablettes, les pliables, les téléviseurs, les voitures et Wear OS. Sur Wear, le rappel de données appareil n'est disponible que sur les appareils équipés de Wear OS 5 ou version ultérieure. Le rappel de données appareil n'est pas disponible sur les émulateurs.
- Le rappel de données appareil nécessite l'installation et l'activation de versions récentes du Google Play Store et des services Google Play sur l'appareil.
- Le rappel de données appareil nécessite que le compte utilisateur dispose d'une licence Play. Sinon, l'évaluation ne sera pas examinée.
Le rappel de données appareil implique les considérations de temps suivantes :
- Après avoir validé un jeton d'intégrité, vous disposez de 14 jours pour l'utiliser afin de stocker des données de rappel de données appareil personnalisées.
- Le rappel de données appareil inclut des codes temporels afin que vous puissiez accorder une priorité plus élevée aux données récemment modifiées qu'à celles modifiées il y a longtemps. Envisagez d'ignorer ou de réinitialiser les données après une période suffisamment longue pour tenir compte du fait que les appareils peuvent changer de propriétaire, ou être reconditionnés et revendus.
- Les bits de rappel d'un appareil sont stockés pendant trois ans après le dernier accès en lecture ou en écriture.
- Si vous devez supprimer toutes les données associées à un appareil, votre application peut réinitialiser les trois valeurs sur cet appareil en les définissant sur "false". Cela réinitialisera automatiquement les codes temporels.
Pour les développeurs disposant de plusieurs applications et ceux qui transfèrent des applications, le rappel de données appareil fonctionne comme suit :
- Toutes les applications de votre compte de développeur Google Play ont accès aux trois mêmes valeurs par appareil. En d'autres termes, si l'une de vos applications modifie l'une des valeurs, toutes vos applications liront la valeur modifiée lorsqu'elles seront installées sur le même appareil.
- Si une application est transférée d'un compte de développeur à un autre, le rappel de données appareil reflétera les données par appareil du nouveau compte de développeur, et non celles de l'ancien.
Activer le rappel de données appareil
Lorsque vous êtes prêt, activez le rappel de données appareil dans la Play Console :
- Connectez-vous à la Play Console.
- Sélectionnez l'application qui utilisera le rappel de données appareil.
- Accédez à Protégé avec Play dans le menu de gauche.
- À côté de l'API Play Integrity, cliquez sur Gérer.
- Dans la section "Réponses" de la page, cliquez sur Modifier les réponses.
- Activez le rappel de données appareil.
- Cliquez sur "Enregistrer les modifications".
Lorsque vous activez ou désactivez le rappel de données appareil, toutes les réponses de test de l'API Play Integrity que vous avez configurées dans la Play Console sont supprimées, et vous devez les recréer.
Lire les valeurs de rappel de données appareil
Le rappel de données appareil fonctionne à la fois dans les requêtes classiques et standards de l'API Play Integrity. Dans les requêtes standards, le rappel de données appareil est actualisé lors de l'appel de préparation. En d'autres termes, après avoir modifié les données par appareil, vous devrez effectuer un autre préchauffage pour voir la valeur mise à jour. Une fois le rappel de données appareil activé, vous pourrez lire les valeurs de rappel de données appareil dans vos évaluations d'intégrité.
Modifier les valeurs de rappel de données appareil
Vous pouvez modifier les valeurs de rappel de données appareil en effectuant un appel d'API de serveur à serveur semblable au décodage du verdict d'intégrité. Définir un bit sur true met également à jour sa date d'écriture (même s'il était déjà défini sur true). Définir un bit sur false réinitialise sa date d'écriture sur "vide". Les bits non spécifiés dans une requête restent inchangés. Il existe un léger délai de propagation entre l'écriture des bits et la possibilité de les lire dans le verdict. Ce délai peut atteindre 30 secondes, mais il est généralement beaucoup plus court. Les requêtes d'écriture de rappel de données appareil doivent être moins fréquentes que les requêtes de jeton d'intégrité. Elles ne sont pas comptabilisées dans votre quota de demandes de jetons d'intégrité, mais sont soumises à des limites de débit distinctes.
playintegrity.googleapis.com/v1/PACKAGE_NAME/deviceRecall:write -d \
'{
"integrityToken": "INTEGRITY_TOKEN",
"newValues": {
"bitFirst": true,
"bitThird": false
}
}'newValues.BitFirst = true // ForceSendFields optional for value true newValues.BitSecond = false // ForceSendFields required for value false newValues.BitThird = nil // do not set ForceSendFields for unspecified bits newValues.ForceSendFields = []string{"BitSecond"}