Lorsque vous appelez Gemini API directement depuis vos applications mobiles et applications Web, la protection de votre infrastructure de backend, de vos quotas et de vos requêtes propriétaires nécessite une approche de défense en profondeur multicouche. Consultez cette checklist pour mettre en œuvre les bonnes pratiques de sécurité recommandées pour Firebase AI Logic.
Validation de l'application, de l'appareil et de l'utilisateur
Vérifiez que les requêtes entrantes proviennent d'instances légitimes et non altérées de votre application exécutées sur des appareils authentiques, ainsi que d'utilisateurs authentiques.
Appliquer Firebase App Check
Appliquez Firebase App Check pour protéger Gemini API contre les utilisations abusives lorsqu'il est appelé directement depuis votre application. Lorsque App Check est appliqué, il vérifie que les requêtes entrantes proviennent de votre application authentique et/ou d'un appareil non altéré.
App Check est compatible avec les fournisseurs d'attestation pour les plates-formes Apple (DeviceCheck, App Attest ou reCAPTCHA Enterprise), Android (Play Integrity ou reCAPTCHA Enterprise) et Web (reCAPTCHA Enterprise). Il est également compatible avec tous ces fournisseurs pour les applications Flutter et Unity.
Le 2 novembre 2026, Firebase a automatiquement appliqué App Check pour Firebase AI Logic dans tous les projets afin de protéger Gemini API contre les utilisations abusives. Pour le développement local, vous pouvez configurer le App Check fournisseur de débogage, puis enregistrer votre application auprès d'un fournisseur d'attestation de production avant de la publier pour les utilisateurs finaux.
Activer la protection contre les attaques de répétition avec des jetons à usage limité
Lors de la configuration de App Check, envisagez d'appliquer la protection contre les attaques de répétition afin que les jetons App Check soient à usage unique. Cette option offre une protection renforcée au-delà de la protection de base et vous permet de définir un niveau de protection approprié pour votre application et vos cas d'utilisation.
Configurer des restrictions pour vos clés API Firebase
Les clés API Firebase identifient votre projet et votre application Firebase lors des requêtes. Pour empêcher l'utilisation non autorisée de vos clés API :
Définissez des restrictions d'application dans la console Google Cloud pour limiter l'utilisation de la clé aux requêtes provenant de l'ID de bundle spécifique de votre application (Apple), du nom du package et de l'empreinte SHA-1 (Android) ou du site référent HTTP (Web).
Examinez la liste d'autorisation Restrictions relatives aux API de chaque clé :
- Assurez-vous que l'API Firebase AI Logic (
firebasevertexai.googleapis.com) figure sur la liste d'autorisation. - Assurez-vous que les seules autres API de la liste d'autorisation sont les services Firebase spécifiques requis par votre application. Consultez la liste des API requises pour les clés Firebase restreintes.
- Assurez-vous que l'API Firebase AI Logic (
Notez que les API liées à Firebase n'utilisent les clés API que pour identifier le projet ou l'application Firebase, et non pour autoriser l'appel de l'API.
Limiter les requêtes aux utilisateurs authentifiés uniquement
Envisagez d'appliquer le mode Utilisateurs authentifiés afin que toutes les requêtes via Firebase AI Logic incluent des identifiants valides de Firebase Authentication. Si une requête provient d'un utilisateur final non authentifié, elle est rejetée avec une erreur 401: unauthenticated.
Protection des prompts et renforcement des requêtes
Empêchez la décompilation du client d'exposer vos conceptions de requêtes et verrouillez votre backend afin que les utilisateurs malveillants ne puissent pas exécuter de requêtes arbitraires.
Utiliser des modèles de prompts côté serveur
Utilisez des modèles de prompts côté serveur pour stocker de manière sécurisée les prompts, les instructions système et les configurations de modèle dans le cloud, plutôt que de les coder en dur dans le code de l'application cliente, où ils peuvent être extraits par décompilation binaire.
Votre application ne fait référence qu'à un ID de modèle et transmet des variables d'entrée dynamiques. Les modèles de prompts côté serveur vous permettent également de mettre à jour les prompts ou de changer de modèle à la demande sans publier de nouvelle version de votre application.
Valider et nettoyer les variables de modèle fournies par le client
Les modèles de prompts côté serveur protègent la conception de vos prompts, mais les modèles qui acceptent des variables dynamiques peuvent toujours être vulnérables à l'injection de prompts. Étant donné que les modèles concatènent les variables d'entrée utilisateur dans le prompt final, veillez à procéder comme suit :
- Validez et nettoyez toutes les entrées utilisateur sur le client avant de transmettre des variables à un modèle (par exemple, en appliquant des limites de caractères et des formats attendus).
- Incluez des instructions système claires dans vos modèles qui définissent des garde-fous pour le traitement des entrées utilisateur.
Activer le mode Modèle uniquement
Envisagez d'appliquer le mode "Modèle uniquement" une fois que toutes les fonctionnalités de votre application utilisent des modèles de prompts côté serveur. Lorsqu'elle est appliquée, Firebase AI Logic bloque toutes les requêtes directes sans modèle vers Gemini API (403: unauthorized), ce qui empêche les personnes malveillantes d'envoyer des requêtes arbitraires ou d'abuser de votre quota.
Surveillance, limites et facturation
Gagnez en visibilité sur le trafic entrant et les anomalies de sécurité, et protégez votre projet contre les pics d'utilisation inattendus ou les coûts incontrôlés.
Configurer AI Monitoring dans la console Firebase
Configurez la surveillance de l'IA dans la console Firebase pour obtenir de la visibilité sur les métriques clés, comme le nombre de requêtes, la latence, l'utilisation des jetons et les taux d'erreur (y compris les échecs d'authentification 401 et les blocages de modèles uniquement 403).
Vous pouvez également inspecter des traces individuelles dans la console Google Cloud.
Définir des limites de débit et gérer les quotas
Protégez votre projet contre les pics d'utilisation inattendus et les attaques par déni de portefeuille :
- Définissez des limites de débit par utilisateur (la valeur par défaut est de 100 RPM) pour empêcher les instances client individuelles de consommer un quota excessif.
- Examinez et gérez les quotas de projet dans la console Google Cloud pour chaque API sous-jacente.
Évitez les factures surprises grâce aux alertes et aux plafonds de dépenses
Si votre projet Firebase est associé au forfait Blaze avec paiement à l'usage :
Configurez des alertes de budget et des plafonds de dépenses.
Étapes suivantes
- Consultez la checklist de sécurité Firebase générale.
- Consultez la checklist de mise en production générale pour Firebase AI Logic.
- En savoir plus sur la tarification et la gestion des coûts pour Firebase AI Logic.