Informazioni sulle chiavi API per Firebase e su come gestirle

Una chiave API è una stringa univoca utilizzata per indirizzare le richieste al tuo progetto Firebase quando interagisci con i servizi Firebase e Google. In questa pagina vengono descritte le informazioni di base sulle chiavi API, nonché le best practice per l'utilizzo e la gestione delle chiavi API con le app Firebase.

Ecco gli aspetti più importanti da sapere sulle chiavi API per i servizi Firebase:

• Pubbliche per progettazione: le chiavi API per i servizi Firebase identificano solo il tuo progetto Firebase e la tua app per questi servizi. L'autorizzazione viene gestita tramite le autorizzazioni IAM Google Cloud, Firebase Security Rules e Firebase App Check.
• Applica limitazioni: tutte le chiavi API di cui è stato eseguito il provisioning da Firebase sono limitate automaticamente alle API correlate a Firebase. Per tutte le chiavi API del tuo progetto, è fondamentale applicare le limitazioni API appropriate per impedire l'utilizzo non autorizzato della quota del tuo progetto per le API.
• Utilizza solo per i servizi Firebase: utilizza le chiavi API di cui è stato eseguito il provisioning da Firebase solo per le API correlate a Firebase. Se la tua app utilizza altre API (ad esempio l'API Places per Maps o l'Gemini Developer API), utilizza una chiave API separata e limitane l'utilizzo all'API applicabile. In particolare, non includere mai Gemini Developer API nella lista consentita per una chiave API accessibile pubblicamente o una chiave utilizzata per altri servizi.
• Security Rules e App Check sono fondamentali: la sicurezza dei tuoi dati Realtime Database, Cloud Firestore e Cloud Storage viene applicata utilizzando Firebase Security Rules, mentre la protezione delle API coperte viene garantita da Firebase App Check, non mantenendo segreta la chiave API Firebase.

Se la configurazione della tua app segue le linee guida riportate sopra, le chiavi API limitate ai servizi Firebase non devono essere trattate come secret ed è sicuro includerle nel codice o nei file di configurazione.

Se hai ricevuto un'email da Google Cloud relativa a una "chiave API di Google accessibile pubblicamente per il tuo progetto Google Cloud" e la chiave API elencata nell'email è la tua chiave API Firebase, assicurati che la chiave API soddisfi i seguenti requisiti per poter essere inclusa in sicurezza nel codice o nei file di configurazione. Puoi verificare quanto segue nella pagina API e servizi > Credenziali della console Google Cloud.

• È la chiave API che utilizzi per la tua app Firebase e solo per i servizi Firebase. Questi tasti sono solitamente chiamati Browser key (auto created by Firebase), Android key (auto created by Firebase) o iOS key (auto created by Firebase).
• Contiene tutte le API correlate a Firebase richieste incluse nella lista consentita "Limitazioni API" della chiave.
• Non deve avere altre API nella lista consentita "Restrizioni API". In particolare, l'elenco non deve contenere Generative Language API.

Inoltre, assicurati di utilizzare Firebase Security Rules e App Check come consigliato per i prodotti Firebase che utilizzi.

Puoi scoprire i dettagli sulle chiavi API per Firebase e trovare un elenco di domande frequenti in Scopri di più sull'utilizzo e sulla gestione delle chiavi API per Firebase.

Importante: la chiave API che utilizzi per le chiamate all'Gemini Developer API nella tua app non deve mai essere inclusa nel codice o nei file di configurazione. Deve essere protetta dall'esposizione pubblica. Nella console Google Cloud, verrà chiamato Gemini API Key o Gemini Developer API key (auto created by Firebase) e sarà limitato a Generative Language API.

Il resto di questa pagina fornisce informazioni dettagliate sulle chiavi API per Firebase, nonché un elenco di domande frequenti su queste chiavi.

Informazioni generali sulle chiavi API e Firebase

Le chiavi API per Firebase sono diverse dalle chiavi API tipiche

A differenza di come vengono utilizzate in genere, le chiavi API per i servizi Firebase non vengono utilizzate per controllare l'accesso alle risorse di backend; questo può essere fatto solo con Firebase Security Rules (per controllare quali utenti finali possono accedere alle risorse) e Firebase App Check (per controllare quali app possono accedere alle risorse).

In genere, devi proteggere con cura le chiavi API (ad esempio, utilizzando un servizio di vault o impostando le chiavi come variabili di ambiente). Tuttavia, le chiavi API per i servizi Firebase possono essere incluse nel codice o nei file di configurazione archiviati.

Sebbene le chiavi API per i servizi Firebase possano essere incluse nel codice, devi esaminarle e applicare restrizioni e limiti appropriati.

Proteggi i tuoi dati Realtime Database, Cloud Firestore e Cloud Storage utilizzando Firebase Security Rules. Non fare affidamento solo sulla limitazione e/o sull'oscuramento delle chiavi API.

Creazione di chiavi API

Un progetto Firebase può avere molte chiavi API, ma ogni chiave API può essere associata a un solo progetto Firebase.

Firebase crea automaticamente le chiavi API per il tuo progetto quando esegui una delle seguenti operazioni:

• Crea un progetto Firebase > Browser key creato automaticamente
• Crea un'app Firebase per Apple > iOS key creata automaticamente
• Crea un'app Firebase per Android > Android key creata automaticamente

Importante: per impostazione predefinita, le chiavi API create automaticamente da Firebase sono limitate automaticamente a un elenco di API che richiedono al client di fornire una chiave API insieme alla chiamata. Consulta la domanda frequente Le chiavi API per i servizi Firebase sono limitate per impostazione predefinita?.

Puoi anche creare le tue chiavi API nella console Google Cloud, ad esempio per lo sviluppo o il debug. Scopri di più su quando questa opzione potrebbe essere consigliata più avanti in questa pagina.

Trovare le chiavi API

Puoi visualizzare e gestire tutte le chiavi API del tuo progetto nella pagina API e servizi > Credenziali della console Google Cloud.

Puoi anche trovare la chiave API abbinata automaticamente a un'app Firebase nelle seguenti posizioni. Per impostazione predefinita, tutte le app Firebase del progetto per la stessa piattaforma (Apple, Android o web) utilizzeranno la stessa chiave API.

• App Firebase per Apple: trova la chiave API con corrispondenza automatica nel file di configurazione di Firebase, GoogleService-Info.plist, nel campo API_KEY.

• App Firebase per Android: trova la chiave API con corrispondenza automatica nel file di configurazione di Firebase, google-services.json, nel campo current_key.

• App web Firebase: trova la chiave API con corrispondenza automatica nell'oggetto di configurazione Firebase, nel campo apiKey.

Utilizzo di una chiave API

Le chiavi API per Firebase vengono utilizzate per identificare il tuo progetto Firebase quando interagisci con i servizi Firebase o Google. In particolare, vengono utilizzate per associare le richieste API al tuo progetto per la quota e la fatturazione. Sono utili anche per accedere ai dati pubblici.

Per la stragrande maggioranza degli sviluppatori e dei casi d'uso, non interagisci direttamente con queste chiavi API. Invece, quando la tua app effettua una chiamata a un'API Firebase che richiede una chiave API fornita dal client web o mobile, l'app cercherà automaticamente una chiave API nella configurazione di Firebase dell'app. Questa configurazione è stata aggiunta al codebase della tua app quando l'hai collegata a Firebase.

Tieni presente che puoi fornire la chiave API della tua app all'interno dell'app utilizzando un meccanismo diverso, come le opzioni di Firebase o le variabili di ambiente.

Inoltre, per alcune API REST per i servizi Firebase, potresti dover passare esplicitamente il valore della chiave API nella chiamata come parametro di query. Questo esempio mostra come effettuare una richiesta utilizzando l'API Firebase Authentication:

https://identitytoolkit.googleapis.com/v1/accounts:signInWithCustomToken?key=API_KEY

Esamina e applica le restrizioni appropriate alle chiavi API

Per tutte le chiavi API del tuo progetto, è fondamentale assicurarsi che abbiano le limitazioni e le restrizioni API appropriate, come descritto in questa sezione.

Per le chiavi API utilizzate dalle app di produzione, fai attenzione a modificare le relative restrizioni o i relativi limiti. Prima di modificare le restrizioni o i limiti per la chiave API di produzione, devi testare le nuove impostazioni in un'app di test e con una chiave API di test.

Esamina le API aggiunte automaticamente alla lista consentita per le tue chiavi API Firebase

Quando Firebase crea una chiave API nel tuo progetto, aggiungiamo automaticamente le "limitazioni relative alle API" a quella chiave. Le API aggiunte a questa lista consentita sono API correlate a Firebase che richiedono al client di fornire una chiave API insieme alla chiamata. Tieni presente che la maggior parte delle API richieste per l'utilizzo dei servizi Firebase non deve necessariamente essere inclusa nella lista consentita per le tue chiavi API.

Nota: Se la chiave API che utilizzi per i servizi Firebase ha "restrizioni API" e ricevi un errore API_KEY_SERVICE_BLOCKED o Forbidden 403, assicurati che la chiave API includa tutte le API richieste nell'elenco consentito delle "restrizioni API" della chiave.

Poiché Firebase aggiunge le API necessarie per tutti i servizi Firebase, la lista consentita per una chiave API potrebbe includere API per prodotti che non utilizzi. Puoi rimuovere le API dalla lista consentita, ma devi fare molta attenzione a non rimuovere le API richieste per Firebase e i servizi Firebase che utilizzi (consulta l'elenco delle API correlate a Firebase che devono essere incluse nella lista consentita per ogni servizio/prodotto). In caso contrario, riceverai errori quando effettui chiamate ai servizi Firebase.

Nota: a maggio 2024, Firebase ha applicato automaticamente le restrizioni delle API a tutte le chiavi API esistenti e senza limitazioni di cui è stato eseguito il provisioning da Firebase. Scopri di più nelle domande frequenti Le chiavi API per i servizi Firebase sono limitate per impostazione predefinita?.

Riduci la quota se utilizzi Authentication basato su password

Indipendentemente dall'opzione di autenticazione utilizzata, proteggi i tuoi dati Realtime Database, Cloud Firestore e Cloud Storage utilizzando Firebase Security Rules.

Se utilizzi l'Firebase Authentication basata su password e qualcuno entra in possesso della tua chiave API, non potrà accedere ai dati del database o di Cloud Storage del tuo progetto Firebase, a condizione che questi dati siano protetti dalle Firebase Security Rules. Tuttavia, potrebbero utilizzare la tua chiave API per accedere agli endpoint di autenticazione di Firebase ed effettuare richieste di autenticazione per il tuo progetto.

Per ridurre la possibilità che qualcuno utilizzi in modo improprio una chiave API per tentare un attacco di forza bruta, puoi limitare la quota predefinita degli endpoint identitytoolkit.googleapis.com in modo che rifletta le normali aspettative di traffico della tua app. Tieni presente che se limiti questa quota e la tua app acquisisce improvvisamente utenti, potresti ricevere errori di accesso finché non aumenti la quota. Puoi modificare le quote API del tuo progetto nella console Google Cloud.

Utilizza chiavi API separate e limitate per qualsiasi servizio non Firebase

Sebbene le chiavi API utilizzate per i servizi Firebase non debbano generalmente essere trattate come segrete, devi adottare alcune precauzioni aggiuntive con le chiavi API che utilizzi con altre API Google Cloud.

Se utilizzi un'API Google Cloud (su qualsiasi piattaforma) che non è destinata a un servizio/prodotto Firebase, ti consigliamo vivamente di creare chiavi API separate e limitate da utilizzare con queste API. Questo è di fondamentale importanza se l'API è per un servizio Google Cloud fatturabile. In particolare, non includere mai Gemini Developer API nella lista consentita per una chiave API accessibile pubblicamente o una chiave utilizzata per altri servizi.

Utilizzando chiavi API separate e limitate per le API non Firebase, puoi ruotare o sostituire le chiavi quando necessario e aggiungere ulteriori limitazioni alle chiavi API senza interrompere l'utilizzo dei servizi Firebase.

Visualizza le istruzioni per la creazione di chiavi specifiche per l'API

Queste istruzioni descrivono come creare una chiave API separata e con restrizioni per un'API fittizia chiamata Super Service API.

Passaggio 1: configura le chiavi API esistenti in modo da non consentire l'accesso a Super Service API

1. Nella console Google Cloud, vai alla pagina API e servizi > Credenziali. Se richiesto, seleziona il progetto.

2. Per ogni chiave API esistente nell'elenco, apri la visualizzazione di modifica.

3. Nella sezione Restrizioni delle API, seleziona Limita chiave, quindi aggiungi all'elenco tutte le API a cui vuoi che la chiave API abbia accesso. Assicurati di non includere l'API per cui stai creando una chiave API separata (in questo esempio, Super Service API).

   Quando configuri le restrizioni API per una chiave API, dichiari esplicitamente le API a cui la chiave ha accesso. **Per impostazione predefinita, quando nella sezione Restrizioni delle API è selezionata l'opzione Non limitare la chiave, una chiave API può essere utilizzata per accedere a qualsiasi API abilitata per il progetto.**

Ora, le tue chiavi API esistenti non consentiranno l'accesso a Super Service API, ma ogni chiave continuerà a funzionare per tutte le API che hai aggiunto al relativo elenco di restrizioni delle API.

Importante: se in futuro abiliti altre API, devi aggiungerle all'elenco Restrizioni API per la chiave API applicabile.

Passaggio 2: crea e utilizza una nuova chiave API per accedere a Super Service API

1. Torna alla pagina API e servizi > Credenziali. Assicurati che il progetto Firebase sia ancora selezionato.

2. Fai clic su Crea credenziali > Chiave API. Prendi nota della nuova chiave API, quindi fai clic su Limita chiave.

3. Nella sezione Restrizioni delle API, seleziona Limita chiave, quindi aggiungi all'elenco solo Super Service API.

   Questa nuova chiave API concede l'accesso solo a Super Service API.

4. Configura l'app e i servizi in modo che utilizzino la nuova chiave API.

Utilizza chiavi API specifiche per l'ambiente

Se configuri progetti Firebase diversi per ambienti diversi, ad esempio staging e produzione, è importante che ogni istanza dell'app interagisca con il progetto Firebase corrispondente. Ad esempio, l'istanza dell'app di gestione temporanea non deve mai comunicare con il progetto Firebase di produzione. Ciò significa anche che l'app di gestione temporanea deve utilizzare le chiavi API associate al progetto Firebase di gestione temporanea.

Per ridurre i problemi di promozione delle modifiche al codice dallo sviluppo alla gestione temporanea e alla produzione, anziché includere le chiavi API nel codice stesso, impostale come variabili di ambiente o includile in un file di configurazione.

Domande frequenti e risoluzione dei problemi

Domande frequenti

Le chiavi API per i servizi Firebase sono limitate per impostazione predefinita?

Sì, per impostazione predefinita, a tutte le chiavi API di cui Firebase esegue il provisioning automatico per l'utilizzo con le API correlate a Firebase vengono applicate automaticamente le "Restrizioni delle API". Consulta l'elenco delle API correlate a Firebase presenti in questa lista consentita.

Le API aggiunte a questa lista consentita sono quelle chiamate dai servizi Firebase dal codice client e richiedono chiavi API per l'identificazione del progetto o dell'app Firebase. Tieni presente che la maggior parte delle API richieste per l'utilizzo dei servizi Firebase non deve necessariamente essere inclusa nella lista consentita per le tue chiavi API.

Poiché Firebase aggiunge le API necessarie per tutti i servizi Firebase, la lista consentita per una chiave API potrebbe includere API per prodotti che non utilizzi. Puoi rimuovere le API dalla lista consentita, ma devi fare molta attenzione a non rimuovere le API richieste per Firebase e i servizi Firebase che utilizzi (consulta l'elenco delle API correlate a Firebase che devono essere incluse nella lista consentita per ogni servizio/prodotto). In caso contrario, riceverai errori quando effettui chiamate ai servizi Firebase.

Importante: nessuna delle API correlate a Firebase utilizza una chiave API come autorizzazione per chiamare l'API. La chiave API passata con la chiamata API viene utilizzata solo per l'identificazione del progetto o dell'app Firebase.

Puoi visualizzare tutte le tue chiavi API e le relative "Restrizioni API" nella pagina API e servizi > Credenziali della console Google Cloud.

Tieni presente quanto segue in merito alla modalità di applicazione di queste "restrizioni API" da parte di Firebase:

• A partire da maggio 2024, tutte le nuove chiavi API di cui Firebase esegue il provisioning automatico sono limitate automaticamente all'elenco delle API correlate a Firebase.

• Nel corso del mese di maggio 2024, tutte le chiavi API esistenti e senza restrizioni di cui Firebase aveva eseguito il provisioning automatico in precedenza sono state limitate all'elenco delle API correlate a Firebase più tutte le API attualmente abilitate del progetto.

• Le chiavi API esistenti e già limitate di cui Firebase aveva eseguito il provisioning automatico in precedenza non sono state modificate.

• Le chiavi API esistenti di cui non è stato eseguito il provisioning automatico da parte di Firebase non sono state modificate.

Importante: se utilizzi un'API Google Cloud (su qualsiasi piattaforma) che non è destinata a un servizio/prodotto Firebase, ti consigliamo vivamente di creare chiavi API separate e limitate da utilizzare con queste API.

Come faccio a determinare quale chiave API è associata alla mia app Firebase?

Puoi utilizzare una delle seguenti opzioni per determinare quale chiave API è associata alla tua app Firebase:

Console Firebase

1. Vai a Impostazioni > scheda Generali.

2. Scorri verso il basso fino alla scheda Le tue app, quindi seleziona l'app che ti interessa.

3. Ottieni il file/oggetto di configurazione Firebase per l'app di interesse, quindi trova la relativa chiave API:

   • Apple: scarica il file GoogleService-Info.plist, quindi individua il campo API_KEY

   • Android: scarica il google-services.json, trova la configurazione per l'app di interesse (cerca il nome del pacchetto) e poi trova il campo current_key

   • Web: seleziona l'opzione Config, quindi individua il campo apiKey

Interfaccia a riga di comando Firebase

1. Ottieni il file/oggetto di configurazione Firebase per l'app di interesse eseguendo il seguente comando:

   firebase apps:sdkconfig PLATFORM FIREBASE_APP_ID

   • PLATFORM (uno tra): IOS | ANDROID | WEB
   • FIREBASE_APP_ID: l'identificatore univoco assegnato da Firebase alla tua app Firebase (trova il tuo ID app)

2. Nella configurazione Firebase stampata dell'app, trova la chiave API:

   • Apple: trova il campo API_KEY

   • Android: trova la configurazione dell'app di interesse (cerca il nome del pacchetto), quindi trova il campo current_key

   • Web: trova il campo apiKey

API REST

1. Ottieni il apiKeyId (l'UID) della chiave API chiamando l'endpoint applicabile per l'app di interesse, quindi passa il valore apiKeyId al passaggio successivo.

   • Apple: chiama il numero projects.iosApps.get
   • Android: chiama projects.androidApps.get
   • Web: chiama il numero projects.webApps.get

2. Ottieni la stringa della chiave API chiamando projects.locations.keys.getKeyString.

   Questo keyString è lo stesso valore che si trova nell'artefatto di configurazione dell'app (Apple | Android | Web).

Posso avere due chiavi API elencate per la stessa app Firebase nel mio file/oggetto di configurazione Firebase?

• App Firebase Apple: ogni app ha il proprio file di configurazione e può avere una sola chiave API elencata.

• App Firebase per Android: tutte le app per Android nel progetto Firebase sono elencate nello stesso file di configurazione e ogni app può avere una sola chiave API elencata. Tuttavia, ogni app in questo file di configurazione può avere una chiave diversa.

• App web Firebase: ogni app ha il proprio oggetto di configurazione e può avere una sola chiave API elencata.

Tuttavia, puoi utilizzare più chiavi API con un'app. Devi fornire un meccanismo per consentire alla tua app di accedere a queste altre chiavi API, ad esempio tramite una variabile di ambiente. Il meccanismo per accedere alle altre chiavi API non può dipendere dall'elenco di queste chiavi API nel file/oggetto di configurazione di Firebase.

In che modo Firebase sa quale chiave API deve essere associata a un'app (ad esempio nel file/oggetto di configurazione di Firebase)?

Quando ottieni per la prima volta il file/oggetto di configurazione Firebase della tua app, Firebase verifica se nel tuo progetto sono presenti chiavi API con "Restrizioni per le applicazioni" che corrispondono all'app (ad esempio, un ID pacchetto corrispondente per l'app Apple).

Se Firebase non trova chiavi limitate corrispondenti, elencherà nel file/oggetto di configurazione la iOS key per le app Apple, la Android key per le app per Android e la Browser key per le app web (supponendo che queste chiavi esistano e non abbiano "Restrizioni delle applicazioni " che impediscono la corrispondenza con l'app).

Posso eliminare manualmente la chiave API e il campo dal file/oggetto di configurazione di Firebase?

Sì, puoi eliminare manualmente la chiave API dal file/oggetto di configurazione. Tuttavia, devi fornire un altro meccanismo per consentire alla tua app di accedere a una chiave API (ad esempio tramite una variabile di ambiente). In caso contrario, le chiamate ai servizi Firebase non andranno a buon fine.

Posso modificare manualmente il file/oggetto di configurazione di Firebase con chiavi API diverse?

Sì, puoi modificare manualmente un file/oggetto di configurazione per associare una chiave API diversa a un'app.

È possibile modificare manualmente la chiave API nel file/oggetto di configurazione Firebase, ma in genere non è consigliato. Ciò aumenta le probabilità di problemi di accesso ai servizi Firebase. Tuttavia, se scegli di modificare il file/oggetto di configurazione, procedi nel seguente modo:

• Assicurati che la chiave API sia limitata all'ID progetto elencato nel file/oggetto di configurazione.
• Assicurati che non siano presenti "Restrizioni delle chiavi API" che impediscano l'utilizzo della chiave API con l'app.
• Assicurati che alla chiave API siano applicate le "restrizioni API" appropriate. Consulta l'elenco delle API correlate a Firebase che devono essere incluse nella lista consentita per ogni servizio/prodotto Firebase.

Tieni presente che se ottieni nuovamente il file/oggetto di configurazione della tua app dalla console Firebase, verranno sempre elencate le chiavi API che Firebase associa automaticamente a quell'app. Pertanto, dovrai ripetere le modifiche manuali, se necessario.

Posso spostare una chiave API da un progetto Firebase a un altro?

No, una chiave API identifica solo un progetto specifico e non può essere spostata in un altro progetto.

Che cosa succede se elimino una chiave API elencata nella console Google Cloud?

Se elimini una chiave API utilizzata da un'app, le chiamate API da quell'app non andranno a buon fine. Potresti ricevere report, email o errori che indicano che stai tentando di utilizzare una chiave API non valida.

L'eliminazione di una chiave API è definitiva e non può essere annullata.

Quali API sono richieste nella lista consentita "Restrizioni delle API" per una chiave API Firebase?

Per una chiave API Firebase, le uniche API che devono essere incluse nella lista consentita "Restrizioni delle API" della chiave sono quelle che richiedono al client di fornire una chiave API insieme alla chiamata. Tieni presente che pochissime API correlate a Firebase hanno questo requisito. La maggior parte delle API correlate a Firebase abilitate nel tuo progetto non deve essere inclusa nella lista consentita "Restrizioni API" della chiave.

Importante: nessuna delle API correlate a Firebase utilizza una chiave API come autorizzazione per chiamare l'API. La chiave API passata con la chiamata API viene utilizzata solo per l'identificazione del progetto o dell'app Firebase.

Utilizza la tabella seguente per determinare quali API correlate a Firebase devono essere incluse nella lista consentita "Restrizioni API" per una chiave API Firebase. Ricorda che le chiavi API di Firebase devono essere utilizzate solo per i servizi Firebase. Scopri di più sulla creazione di chiavi API separate e con limitazioni per tipi specifici di API.

Puoi visualizzare e gestire le chiavi API del tuo progetto nella pagina API e servizi > Credenziali della console Google Cloud.

Nota: se ricevi un errore API_KEY_SERVICE_BLOCKED o Forbidden 403 quando provi a chiamare un'API correlata a Firebase e la chiave API che utilizzi ha tutte le API richieste elencate in questa tabella, contatta l'assistenza Firebase.

Nome API (nome del servizio)	Nome visualizzato dell'API	Servizio/prodotto Firebase associato
firebase.googleapis.com	API Firebase Management	tutti i prodotti
logging.googleapis.com	API Cloud Logging	tutti i prodotti
firebaseinstallations.googleapis.com	API Firebase Installations	Cloud Messaging, Crashlytics, In-App Messaging, Performance Monitoring, Remote Config, Firebase ML
firebaseappcheck.googleapis.com	API Firebase App Check	App Check
firebaseappdistribution.googleapis.com	Firebase App Distribution API	App Distribution
firebaseapptesters.googleapis.com	API Firebase App Testers	App Distribution
identitytoolkit.googleapis.com	API Identity Toolkit	Authentication
securetoken.googleapis.com	API Token Service	Authentication
firebaserules.googleapis.com *	API Firebase Rules	Cloud Firestore, Cloud Storage, Realtime Database
datastore.googleapis.com	API Cloud Datastore	Cloud Firestore
firestore.googleapis.com	API Firestore di Google Cloud	Cloud Firestore
fcmregistrations.googleapis.com	API FCM Registration	Cloud Messaging
firebasestorage.googleapis.com	API Cloud Storage for Firebase	Cloud Storage
firebasedynamiclinks.googleapis.com	API Firebase Dynamic Links	Dynamic Links
firebasehosting.googleapis.com *	API Firebase Hosting	Hosting
firebaseinappmessaging.googleapis.com	API Firebase In-App Messaging	In-App Messaging
firebaseml.googleapis.com	API Firebase ML	Firebase ML
mlkit.googleapis.com **	API ML Kit	Firebase ML
mobilecrashreporting.googleapis.com	Mobile Crash Reporting API	Performance Monitoring
play.googleapis.com	API Google Play Android Developer	Performance Monitoring
firebaseremoteconfig.googleapis.com	API Firebase Remote Config	Performance Monitoring, Remote Config
firebaseremoteconfigrealtime.googleapis.com	API Firebase Remote Config Realtime	Performance Monitoring, Remote Config
cloudconfig.googleapis.com **	N/D	Remote Config
firebasedatabase.googleapis.com *	API Firebase Realtime Database	Realtime Database
firebasevertexai.googleapis.com	API Firebase AI Logic	SDK client Firebase AI Logic
fpnv.googleapis.com	API di verifica del numero di telefono di Firebase	Firebase Phone Number Verification

^{* Obbligatorio solo se utilizzi la chiave API Firebase con strumenti di terze parti o l'accesso REST diretto al servizio/prodotto Firebase.}

^{** Obbligatorio per le versioni precedenti dell'SDK del prodotto. Se utilizzi l'ultima versione dell'SDK, l'API non deve essere inclusa nella lista consentita della chiave.}

Risoluzione dei problemi

Come faccio a correggere un errore API_KEY_SERVICE_BLOCKED o Forbidden 403 che indica che le richieste a questa API sono bloccate?

Segui le indicazioni riportate in queste domande frequenti se ricevi un errore API_KEY_SERVICE_BLOCKED o un errore simile al seguente:

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 chiave API utilizzata dalla tua app per chiamare l'API probabilmente ha "Limitazioni relative alle API" applicate e la lista consentita della chiave non include l'API.

• Se ricevi questo errore quando provi a utilizzare un servizio o un prodotto correlato a Firebase, assicurati che la chiave API che utilizzi includa tutte le API richieste nella lista consentita "Limitazioni delle API" della chiave.

• Se ricevi questo errore quando provi a utilizzare un servizio non Firebase, ti consigliamo vivamente di creare una nuova chiave API specifica per quel servizio e quell'API. Le chiavi API Firebase devono essere utilizzate solo per i servizi/prodotti Firebase. Scopri di più sulla creazione di chiavi API separate e con limitazioni per tipi specifici di API.

Come faccio a risolvere questo errore? "Impossibile recuperare l'ID misurazione di questa app Firebase dal server."

La chiave API utilizzata dalla tua app web probabilmente ha delle "Limitazioni API" applicate. In questo caso, assicurati che l'API Firebase Management sia nell'elenco delle API consentite.

Ho ricevuto un'email o un errore che indica che la mia chiave API non è valida. Che cosa è successo e come faccio a risolvere il problema?

Di seguito sono riportate alcune delle cause più comuni di chiavi API non valide:

• Alla chiave API sono state applicate "Restrizioni delle chiavi API" che la rendono non abbinabile all'app che tenta di utilizzarla ("Restrizioni delle applicazioni") o inutilizzabile per l'API chiamata ("Restrizioni API").

• La chiave API è stata eliminata dal progetto nella console Google Cloud.

• La chiave API non è stata creata per l'ID progetto elencato nel file/oggetto di configurazione Firebase dell'app.

Un modo per risolvere questo problema è ottenere la versione aggiornata del file/oggetto di configurazione Firebase della tua app, quindi sostituire il vecchio file/oggetto di configurazione con il nuovo file/oggetto aggiornato. Prima di inviare un file di configurazione per il download o di visualizzare un oggetto di configurazione nella console Firebase, Firebase verifica che le chiavi API elencate corrispondano alle app.