KappS Base de connaissances · FAQ

Gestion des secrets et protection des clés API dans les apps mobiles : pourquoi une clé API dans un APK est

FAQ Sécurité

1. La seule vraie question est de savoir quelles clés peuvent figurer dans le binaire. Les recommandations de sécurité de Google (Android) sont explicites : il ne s’agit pas d’obfuscation. « Lorsque votre application est compilée et que son code source contient des clés d’API, un attaquant peut décompiler l’application et retrouver ces ressources. » Considérez chaque chaîne présente dans l’APK, ainsi que chaque ressource ou élément qui y est intégré, comme publiée. Les clés côté client ne peuvent donc être que de faible privilège, soumises à un quota et à portée limitée : cartes, météo, flux de contenu en lecture seule, recherche publique. Tout ce qui peut déplacer de l’argent, lire les enregistrements d’un autre utilisateur, émettre des remboursements, envoyer des e-mails ou modifier l’état du serveur ne doit jamais être embarqué dans le client — cela reste derrière votre propre point de terminaison qui authentifie l’utilisateur. (§https://developer.android.com/privacy-and-security/security-tips)

2. La politique relative aux données utilisateur de Play ne mentionne jamais les mots « clé API » — elle encadre des résultats, et c’est pourquoi une clé exposée est un problème de politique et pas seulement d’ingénierie. La politique exige des développeurs qu’ils « Handle all personal and sensitive user data securely, including transmitting it using modern cryptography (for example, over HTTPS) » et qu’ils « Protect all user data with appropriate security measures, including modern cryptography for data in transit. » Une clé codée en dur n’est pas en soi une violation ; une clé codée en dur qui permet à un attaquant de lire, modifier ou exfiltrer des données utilisateur constitue une violation de la politique relative aux données utilisateur, avec un risque de retrait qui s’ajoute à la facture et à la notification de violation. §https://support.google.com/googleplay/android-developer/answer/10144311

3. Une restriction de clé n’est pas une authentification, et la documentation Google Cloud le dit clairement : « Une clé d’API standard n’authentifie pas un principal » — elle associe une requête à un projet pour la facturation et le quota. Les restrictions d’application (sites web, adresses IP, applications Android, applications iOS — un seul type à la fois) et les restrictions d’API limitent les dégâts, elles ne garantissent pas le secret, et la restriction d’application Android s’accompagne d’une mise en garde documentée : « Contourner cette restriction est simple. Si vous l’utilisez, ajoutez aussi des restrictions d’API et surveillez l’usage. » Le même document recommande de définir à la fois des restrictions d’API et des restrictions d’application, puis de surveiller ce que la clé appelle réellement. §https://cloud.google.com/docs/authentication/api-keys

4. La liste d’hygiène qui pèse vraiment. Ne validez jamais de clés dans le dépôt : les recommandations de Android pointent vers des plugins Gradle comme secrets-gradle-plugin plutôt que vers des fichiers versionnés. Utilisez des clés distinctes pour le développement, les tests et la production, et une clé par application, afin qu’une clé compromise puisse être désactivée sans interrompre la production. Lorsqu’un appelant est un serveur, restreignez par IP. Lorsque vous devez conserver un secret sur l’appareil (jetons, éléments de rafraîchissement), gardez-le dans le Keystore Android et chiffrez-le avec une bibliothèque éprouvée comme Tink plutôt qu’avec une constante de chaîne, un fichier d’assets ou de simples SharedPreferences. Toujours en HTTPS, et envisagez l’épinglage de certificat comme couche supplémentaire, pas comme substitut. §https://developer.android.com/privacy-and-security/security-tips

5. La rotation est une échéance de calendrier, pas un réflexe réservé aux incidents. Les recommandations de Android citent l’ISO 27001 et indiquent que « dans la plupart des cas, une période de rotation des clés comprise entre 90 jours et 6 mois devrait suffire » ; l’opération de rotation de Google Cloud crée une nouvelle clé avec les mêmes restrictions, et l’ancienne clé continue de fonctionner jusqu’à sa suppression. Cette fenêtre de chevauchement est tout l’enjeu : les installations sur le terrain se mettent à jour sur plusieurs semaines, il vous faut donc une fenêtre de migration où les deux clés sont valides, puis désactiver, puis supprimer. Tenez un inventaire de l’ID de clé, du propriétaire, du package, des portées et de la date de rotation — un projet peut contenir jusqu’à 300 clés, de quoi perdre le fil. §https://cloud.google.com/docs/authentication/api-keys

6. La détection détermine si une fuite se règle en un jour ou en un trimestre. Activez la journalisation de l'usage par clé ainsi que les alertes de quota et de facturation, et surveillez les trois signaux qui comptent : un pic de volume provenant d'un référent ou d'une IP inattendus, un quota épuisé à des heures où vos utilisateurs dorment, et des appels vers des endpoints que l'app n'appelle jamais. En cas d'exposition confirmée, traitez-la comme un incident selon un ordre fixe : créez la clé de remplacement avec des restrictions identiques, déployez la mise à jour du client, surveillez la baisse du trafic sur l'ancienne clé, révoquez l'ancienne clé, puis examinez les journaux d'accès et la facture sur toute la période d'exposition. Vérifiez aussi que la déclaration de sécurité des données dans Play Console correspond toujours à la réalité : « chiffré en transit » est une déclaration sur le comportement réel d'exécution, et une clé compromise qui a fait basculer un chemin en clair rend cette déclaration fausse. §https://cloud.google.com/docs/authentication/api-keys