Check-list de sécurité pour l'utilisation de Firebase AI Logic

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.

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 :

É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 :

Étapes suivantes