En savoir plus sur les clés API pour Firebase et les gérer
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Une clé API est une chaîne unique qui permet d'acheminer les requêtes vers votre projet Firebase lors de l'interaction avec Firebase et les services Google. Cette page fournit des informations de base sur les clés API, ainsi que des bonnes pratiques pour les utiliser et les gérer avec les applications Firebase.
Si vous avez reçu un e-mail de Google Cloud concernant une "clé API Google accessible publiquement pour votre projet Google Cloud" et que la clé API indiquée dans l'e-mail est votre clé API Firebase, assurez-vous qu'elle répond aux exigences suivantes pour pouvoir être incluse en toute sécurité dans votre code ou vos fichiers de configuration. Vous pouvez vérifier les éléments suivants sur la page API et services > Identifiants de la console Google Cloud.
Il s'agit de la clé API que vous utilisez pour votre application Firebase et uniquement pour les services Firebase. Ces clés sont généralement appelées Browser key (auto created by Firebase), Android key (auto created by Firebase) ou iOS key (auto created by Firebase).
Elle ne comporte aucune autre API dans sa liste d'autorisation "Restrictions relatives aux API". En particulier, la liste ne doit pas contenir Generative Language API.
Assurez-vous également d'utiliser Firebase Security Rules et App Check comme recommandé pour les produits Firebase que vous utilisez.
Le reste de cette page fournit des informations détaillées sur les clés API pour Firebase, ainsi qu'une liste de questions fréquentes sur ces clés.
Informations générales sur les clés API et Firebase
Les clés API pour Firebase sont différentes des clés API standards
Contrairement à l'utilisation habituelle des clés API, les clés API pour les services Firebase ne sont pas utilisées pour contrôler l'accès aux ressources de backend. Cela ne peut être fait qu'avec Firebase Security Rules (pour contrôler quels utilisateurs finaux peuvent accéder aux ressources) et Firebase App Check (pour contrôler quelles applications peuvent accéder aux ressources).
En règle générale, vous devez protéger scrupuleusement les clés API (par exemple, en utilisant un service de coffre-fort ou en définissant les clés en tant que variables d'environnement). Toutefois, les clés API des services Firebase peuvent être incluses dans le code ou les fichiers de configuration enregistrés.
Vous pouvez afficher et gérer toutes les clés API de votre projet sur la page API et services > Identifiants de la console Google Cloud.
Vous pouvez également trouver la clé API automatiquement associée à une application Firebase aux emplacements suivants. Par défaut, toutes les applications Firebase de votre projet pour la même plate-forme (Apple, Android ou Web) utilisent la même clé API.
Applications Firebase pour Apple : recherchez la clé API mise en correspondance automatiquement dans le fichier de configuration Firebase, GoogleService-Info.plist, dans le champ API_KEY.
Applications Android Firebase : recherchez la clé API mise en correspondance automatiquement dans le fichier de configuration Firebase, google-services.json, dans le champ current_key.
Applications Web Firebase : recherchez la clé API mise en correspondance automatiquement dans l'objet de configuration Firebase, dans le champ apiKey.
Utiliser une clé API
Les clés API pour Firebase permettent d'identifier votre projet Firebase lorsque vous interagissez avec Firebase ou les services Google. Plus précisément, elles permettent d'associer les requêtes API à votre projet pour le quota et la facturation. Elles sont également utiles pour accéder aux données publiques.
Pour la grande majorité des développeurs et des cas d'utilisation, vous n'interagissez pas directement avec ces clés API. À la place, lorsque votre application appelle une API Firebase qui nécessite une clé API fournie par le client mobile ou Web, elle recherche automatiquement une clé API dans la configuration Firebase de votre application. Cette configuration a été ajoutée au codebase de votre application lorsque vous l'avez associée à Firebase.
Notez que vous pouvez fournir la clé API de votre application dans votre application à l'aide d'un autre mécanisme, comme les options Firebase ou les variables d'environnement.
De plus, pour certaines API REST des services Firebase, vous devrez peut-être transmettre explicitement la valeur de la clé API dans l'appel en tant que paramètre de requête.
Cet exemple montre comment effectuer une requête à l'aide de l'API Firebase Authentication :
Examiner et appliquer les restrictions appropriées aux clés API
Pour toutes les clés API de votre projet, il est essentiel de vous assurer qu'elles sont soumises aux restrictions et limites d'API appropriées, comme décrit dans cette section.
Vérifier les API automatiquement ajoutées à la liste d'autorisation pour vos clés API Firebase
Lorsque Firebase crée une clé API dans votre projet, nous ajoutons automatiquement des restrictions d'API à cette clé. Les API ajoutées à cette liste d'autorisation sont des API liées à Firebase qui nécessitent que le client fournisse une clé API avec l'appel. Notez que la plupart des API requises pour utiliser les services Firebase n'ont pas besoin d'être ajoutées à la liste d'autorisation de vos clés API.
Étant donné que Firebase ajoute les API nécessaires pour tous les services Firebase, la liste d'autorisation d'une clé API peut inclure des API pour des produits que vous n'utilisez pas.
Vous pouvez supprimer des API de la liste d'autorisation, mais vous devez veiller à ne pas supprimer les API requises pour Firebase et les services Firebase que vous utilisez (consultez la liste des API liées à Firebase qui doivent figurer sur la liste d'autorisation pour chaque service/produit). Sinon, vous obtiendrez des erreurs lors des appels aux services Firebase.
Réduire le quota si vous utilisez l'authentification Authentication basée sur un mot de passe
Si vous utilisez l'Firebase Authentication basée sur un mot de passe et que quelqu'un obtient votre clé API, il ne pourra pas accéder à la base de données de votre projet Firebase ni aux données Cloud Storagetant que ces données sont protégées par Firebase Security Rules. Toutefois, ils pourraient utiliser votre clé API pour accéder aux points de terminaison d'authentification de Firebase et envoyer des requêtes d'authentification à votre projet.
Pour limiter le risque qu'une personne utilise de manière abusive une clé API pour tenter une attaque par force brute, vous pouvez resserrer le quota par défaut des points de terminaison identitytoolkit.googleapis.com afin de refléter les attentes normales de trafic de votre application. Sachez que si vous resserrez ce quota et que votre application gagne soudainement des utilisateurs, vous risquez d'obtenir des erreurs de connexion jusqu'à ce que vous augmentiez le quota.
Vous pouvez modifier les quotas d'API de votre projet dans la console Google Cloud.
Utilisez des clés API distinctes et restreintes pour tous les services non Firebase.
Bien que les clés API utilisées pour les services Firebase n'aient généralement pas besoin d'être traitées comme des secrets, vous devez prendre des précautions supplémentaires avec les clés API que vous utilisez avec d'autres API Google Cloud.
Si vous utilisez une API Google Cloud (sur n'importe quelle plate-forme) qui n'est pas destinée à un service ou produit Firebase, nous vous recommandons vivement de créer des clés API distinctes et restreintes pour ces API. Cela est d'une importance cruciale si l'API est destinée à un service Google Cloud facturable. En particulier, n'incluez jamais Gemini Developer API dans la liste d'autorisation d'une clé API accessible publiquement ou d'une clé utilisée pour d'autres services.
En utilisant des clés API distinctes et restreintes pour les API non-Firebase, vous pouvez effectuer une rotation ou remplacer les clés si nécessaire, et ajouter des restrictions supplémentaires aux clés API sans perturber votre utilisation des services Firebase.
Afficher les instructions pour créer des clés spécifiques à l'API
Ces instructions décrivent comment créer une clé API distincte et restreinte pour une fausse API appelée Super Service API.
Étape 1 : Configurez vos clés API existantes pour interdire l'accès à Super Service API
Dans la console Google Cloud, accédez à la page API et services > Identifiants.
Si vous y êtes invité, sélectionnez votre projet.
Pour chaque clé API existante de la liste, ouvrez la vue de modification.
Dans la section Restrictions relatives aux API, sélectionnez Restreindre la clé, puis ajoutez à la liste toutes les API auxquelles vous souhaitez que la clé API ait accès. Veillez à ne pas inclure l'API pour laquelle vous créez une clé API distincte (dans cet exemple, Super Service API).
Lorsque vous configurez les restrictions d'API pour une clé API, vous déclarez explicitement les API auxquelles la clé a accès. **Par défaut, lorsque l'option Ne pas restreindre la clé est sélectionnée dans la section Restrictions relatives aux API, une clé API peut être utilisée pour accéder à n'importe quelle API activée pour le projet.**
Désormais, vos clés API existantes ne permettront pas d'accéder à Super Service API, mais chaque clé continuera de fonctionner pour toutes les API que vous avez ajoutées à sa liste de restrictions d'API.
Étape 2 : Créez et utilisez une nouvelle clé API pour accéder à Super Service API
Revenez à la page API et services > Identifiants.
Assurez-vous que votre projet Firebase est toujours sélectionné.
Cliquez sur Créer des identifiants > Clé API. Notez la nouvelle clé API, puis cliquez sur Restreindre la clé.
Dans la section Restrictions relatives aux API, sélectionnez Restreindre la clé, puis ajoutez uniquementSuper Service API à la liste.
Cette nouvelle clé API n'accorde l'accès qu'à l'Super Service API.
Configurez votre application et vos services pour qu'ils utilisent la nouvelle clé API.
Utiliser des clés API spécifiques à l'environnement
Si vous configurez différents projets Firebase pour différents environnements, tels que la préproduction et la production, il est important que chaque instance d'application interagisse avec le projet Firebase correspondant. Par exemple, votre instance d'application de préproduction ne doit jamais communiquer avec votre projet Firebase de production. Cela signifie également que votre application de préproduction doit utiliser des clés API associées à votre projet Firebase de préproduction.
Pour réduire les problèmes liés à la promotion des modifications de code du développement à la préproduction, puis à la production, au lieu d'inclure les clés API dans le code lui-même, définissez-les en tant que variables d'environnement ou incluez-les dans un fichier de configuration.
Questions fréquentes et dépannage
Questions fréquentes
Les clés API des services Firebase sont-elles limitées par défaut ?
Oui, par défaut, toutes les clés API que Firebase provisionne automatiquement pour être utilisées avec les API liées à Firebase sont soumises à des restrictions d'API. Consultez la liste des API liées à Firebase qui figurent sur cette liste d'autorisation.
Les API ajoutées à cette liste d'autorisation sont celles appelées par les services Firebase à partir du code client et nécessitent des clés API pour identifier votre projet ou votre application Firebase. Notez que la plupart des API requises pour utiliser les services Firebase n'ont pas besoin de figurer sur la liste d'autorisation de vos clés API.
Étant donné que Firebase ajoute les API nécessaires pour tous les services Firebase, la liste d'autorisation d'une clé API peut inclure des API pour des produits que vous n'utilisez pas. Vous pouvez supprimer des API de la liste d'autorisation, mais vous devez veiller à ne pas supprimer les API requises pour Firebase et les services Firebase que vous utilisez (consultez la liste des API liées à Firebase qui doivent figurer sur la liste d'autorisation pour chaque service/produit). Sinon, vous obtiendrez des erreurs lors des appels aux services Firebase.
Vous pouvez afficher toutes vos clés API et leurs restrictions d'API sur la page API et services > Identifiants de la console Google Cloud.
Notez les points suivants concernant la façon dont Firebase applique ces "restrictions d'API" :
À partir de mai 2024, toutes les nouvelles clés API provisionnées automatiquement par Firebase seront automatiquement limitées à la liste des API liées à Firebase.
En mai 2024, toutes les clés API existantes et sans restriction que Firebase avait précédemment provisionnées automatiquement sont limitées à la liste des API liées à Firebaseainsi qu'à toutes les API actuellement activées du projet.
Les clés API existantes et déjà restreintes que Firebase avait précédemment provisionnées automatiquement n'ont pas été modifiées.
Les clés API existantes qui n'ont pas été provisionnées automatiquement par Firebase n'ont pas été modifiées.
Comment déterminer quelle clé API est associée à mon application Firebase ?
Vous pouvez utiliser l'une des options suivantes pour déterminer quelle clé API est associée à votre application Firebase :
Puis-je avoir deux clés API listées pour la même application Firebase dans mon fichier/objet de configuration Firebase ?
Applications Apple Firebase : chaque application possède son propre fichier de configuration et ne peut lister qu'une seule clé API.
Applications Android Firebase : toutes les applications Android du projet Firebase sont listées dans le même fichier de configuration, et chaque application ne peut avoir qu'une seule clé API listée. Toutefois, chaque application de ce fichier de configuration peut avoir une clé différente.
Applications Web Firebase : chaque application possède son propre objet de configuration et ne peut lister qu'une seule clé API.
Toutefois, vous pouvez utiliser plusieurs clés API avec une même application. Vous devez fournir un mécanisme permettant à votre application d'accéder à ces autres clés API, par exemple via une variable d'environnement. Le mécanisme d'accès aux autres clés API ne peut pas dépendre de la présence de ces clés API dans votre fichier/objet de configuration Firebase.
Comment Firebase sait-il quelle clé API associer à une application (comme dans le fichier/l'objet de configuration Firebase) ?
Si Firebase ne trouve aucune clé restreinte correspondante, il listera dans le fichier/l'objet de configuration la clé iOS key pour les applications Apple, la clé Android key pour les applications Android et la clé Browser key pour les applications Web (en supposant que ces clés existent et qu'aucune restriction d'application ne les empêche de correspondre à cette application).
Puis-je supprimer manuellement la clé API et le champ de mon fichier/objet de configuration Firebase ?
Oui, vous pouvez supprimer manuellement votre clé API de votre fichier/objet de configuration. Toutefois, vous devez fournir un autre mécanisme pour que votre application puisse accéder à une clé API (par exemple, via une variable d'environnement). Sinon, tous les appels aux services Firebase échoueront.
Puis-je modifier manuellement mon fichier/objet de configuration Firebase avec différentes clés API ?
Oui, vous pouvez modifier manuellement un fichier/objet de configuration pour associer une autre clé API à une application.
Puis-je déplacer une clé API d'un projet Firebase vers un autre ?
Non, une clé API n'identifie qu'un projet spécifique et ne peut pas être déplacée vers un autre projet.
Que se passe-t-il si je supprime une clé API listée dans la console Google Cloud ?
Si vous supprimez une clé API utilisée par une application, les appels d'API de cette application échoueront. Vous pouvez recevoir des rapports, des e-mails ou des erreurs indiquant que vous essayez d'utiliser une clé API non valide.
La suppression d'une clé API est définitive et irréversible.
Quelles API sont requises dans la liste d'autorisation "Restrictions d'API" pour une clé API Firebase ?
Pour une clé API Firebase, les seules API qui doivent figurer sur la liste d'autorisation "Restrictions relatives aux API" de la clé sont celles qui nécessitent que le client fournisse une clé API avec l'appel. Notez que très peu d'API liées à Firebase sont soumises à cette exigence. La plupart des API liées à Firebase activées dans votre projet n'ont pas besoin de figurer dans la liste d'autorisation "Restrictions relatives aux API" de la clé.
Utilisez le tableau suivant pour déterminer les API liées à Firebase qui doivent être incluses dans la liste d'autorisation "Restrictions relatives aux API" pour une clé API Firebase. N'oubliez pas que les clés API Firebase ne doivent être utilisées que pour les services Firebase. Découvrez comment créer des clés API distinctes et restreintes pour des types d'API spécifiques.
Vous pouvez afficher et gérer les clés API de votre projet sur la page API et services > Identifiants de la console Google Cloud.
API Firebase de vérification du numéro de téléphone
Firebase Phone Number Verification
* Obligatoire uniquement si vous utilisez la clé API Firebase avec des outils tiers ou un accès REST direct au service/produit Firebase.
** Obligatoire pour les versions antérieures du SDK du produit. Si vous utilisez la dernière version du SDK, l'API n'a pas besoin de figurer sur la liste d'autorisation de la clé.
Dépannage
Comment corriger une erreur API_KEY_SERVICE_BLOCKED ou Forbidden 403 indiquant que les requêtes adressées à cette API sont bloquées ?
Suivez les instructions de ces questions fréquentes si vous obtenez une erreur API_KEY_SERVICE_BLOCKED ou une erreur semblable à celle-ci :
Forbidden: 403 POST https://example-service.googleapis.com/method: Requests to this API example-service.googleapis.com method google.example-service.rest.method are blocked.
La clé API utilisée par votre application pour appeler l'API est probablement soumise à des restrictions d'API, et l'API n'est pas incluse dans la liste d'autorisation de la clé.
Si vous obtenez cette erreur lorsque vous essayez d'utiliser un service non-Firebase, nous vous recommandons vivement de créer une clé API spécifiquement pour ce service et cette API. Les clés API Firebase ne doivent être utilisées que pour les services/produits Firebase.
Découvrez comment créer des clés API distinctes et restreintes pour des types d'API spécifiques.
Comment corriger cette erreur ? "Échec de la récupération de l'ID de mesure de cette application Firebase depuis le serveur."
La clé API utilisée par votre application Web est probablement soumise à des restrictions d'API. Si tel est le cas, assurez-vous que l'API Firebase Management figure dans la liste des API autorisées.
J'ai reçu un e-mail ou une erreur indiquant que ma clé API n'est pas valide. Que s'est-il passé et comment résoudre ce problème ?
Voici quelques-unes des causes les plus courantes de clés API non valides :
La clé API est soumise à des restrictions qui la rendent incompatible avec l'application qui tente de l'utiliser ("Restrictions relatives aux applications") ou inutilisable pour l'API appelée ("Restrictions relatives aux API").
La clé API a été supprimée du projet dans la console Google Cloud.
La clé API n'a pas été créée pour l'ID de projet indiqué dans le fichier/l'objet de configuration Firebase de l'application.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2026/11/16 (UTC).
[null,null,["Dernière mise à jour le 2026/11/16 (UTC)."],[],[]]