Elenco di controllo della sicurezza per l'utilizzo di Firebase AI Logic

Quando chiami l'Gemini API direttamente dalle tue app web e mobile, la protezione dell'infrastruttura di backend, della quota e dei prompt proprietari richiede un approccio di difesa in profondità multilivello. Consulta questo elenco di controllo per implementare le best practice per la sicurezza consigliate per Firebase AI Logic.

Verifica di app, dispositivi e utenti

Verifica che le richieste in arrivo provengano da istanze legittime e non manomesse della tua app in esecuzione su dispositivi autentici, nonché da utenti autentici.

Applica Firebase App Check

Applica Firebase App Check per proteggere Gemini API da usi impropri quando viene chiamata direttamente dalla tua app. Quando App Check viene applicata, verifica che le richieste in arrivo provengano dalla tua app autentica e/o da un dispositivo non manomesso.

App Check supporta i provider di attestazione per le piattaforme Apple (DeviceCheck, App Attest o reCAPTCHA Enterprise), Android (Play Integrity o reCAPTCHA Enterprise) e Web (reCAPTCHA Enterprise). Supporta tutti questi provider anche per le app Flutter e Unity.

A partire dall'inizio di luglio 2026, Firebase applica automaticamente App Check per Firebase AI Logic durante la configurazione guidata nella console Firebase. Se hai configurato Firebase AI Logic in precedenza, assicurati di applicare App Check in modo esplicito. Per lo sviluppo locale, puoi configurare il App Check provider di debug, quindi registrare la tua app con un provider di attestazioni di produzione prima del rilascio agli utenti finali.

Attiva la protezione da replay con token a uso limitato

Nell'ambito della configurazione di App Check, valuta la possibilità di applicare la protezione di riproduzione in modo che i token App Check siano monouso. Questa opzione offre una protezione avanzata che va oltre la protezione di base e ti consente di impostare un livello di protezione appropriato per la tua app e i tuoi casi d'uso.

Configura le limitazioni per le chiavi API Firebase

Le chiavi API Firebase identificano il progetto e l'app Firebase quando effettui le richieste. Per impedire l'utilizzo non autorizzato delle tue chiavi API:

  • Imposta "Limitazioni delle applicazioni" nella console Google Cloud per limitare l'utilizzo della chiave solo alle richieste provenienti dall'ID pacchetto specifico della tua app (Apple), dal nome del pacchetto e dall'impronta SHA-1 (Android) o dal referrer HTTP (web).

  • Esamina la lista consentita "Restrizioni delle API" di ogni chiave:

    • Assicurati che l'API Firebase AI Logic (firebasevertexai.googleapis.com) sia inclusa nella lista consentita.
    • Assicurati che le uniche altre API nella lista consentita siano i servizi Firebase specifici richiesti dalla tua app. Consulta l'elenco delle API richieste per le chiavi Firebase limitate.

Tieni presente che le API correlate a Firebase utilizzano le chiavi API solo per identificare il progetto o l'app Firebase, non per l'autorizzazione a chiamare l'API.

Limita le richieste ai soli utenti autenticati

Valuta la possibilità di applicare la modalità utenti autenticati in modo che tutte le richieste tramite Firebase AI Logic debbano includere credenziali valide di Firebase Authentication. Se una richiesta proviene da un utente finale non autenticato, viene rifiutata con un errore 401: unauthenticated.

Protezione dei prompt e protezione avanzata delle richieste

Impedisci che la decompilazione del client esponga i tuoi prompt design e blocca il backend in modo che gli utenti malintenzionati non possano eseguire prompt arbitrari.

Utilizza i template di prompt del server

Utilizza i template di prompt del server per conservare prompt, istruzioni di sistema e configurazioni dei modelli in modo sicuro nel cloud, anziché impostarli come hardcoded nel codice dell'app client, dove possono essere estratti utilizzando la decompilazione binaria.

La tua app fa riferimento solo a un ID modello e trasmette variabili di input dinamiche. I template di prompt del server ti consentono anche di aggiornare i prompt o di cambiare modello on demand senza rilasciare una nuova versione dell'app.

Convalida e sanifica le variabili del modello fornite dal client

I template di prompt del server proteggono il design dei prompt, ma i template che accettano variabili dinamiche possono comunque essere soggetti a prompt injection. Poiché i template concatenano le variabili di input dell'utente nel prompt finale, assicurati di:

  • Convalida e sanifica tutti gli input utente sul client prima di passare le variabili a un modello (ad esempio, applicando limiti di caratteri e formati previsti).
  • Includi nei tuoi template istruzioni di sistema chiare che definiscano i guardrail per l'elaborazione dell'input utente.

Applica la modalità solo template

Valuta la possibilità di applicare la modalità solo template una volta che tutte le funzionalità della tua app utilizzano i template di prompt del server. Quando viene applicato, Firebase AI Logic blocca tutte le richieste dirette e senza template al Gemini API (403: unauthorized), impedendo ad utenti malintenzionati di inviare prompt arbitrari o di abusare della tua quota.

Monitoraggio, limiti e fatturazione

Ottieni visibilità sul traffico in entrata e sulle anomalie di sicurezza e proteggi il tuo progetto da picchi di utilizzo imprevisti o costi fuori controllo.

Configura il monitoraggio AI nella console Firebase

Configura il monitoraggio AI nella console Firebase per ottenere visibilità su metriche chiave, come il numero di richieste, la latenza, l'utilizzo dei token e le percentuali di errore (tra cui gli errori di autenticazione 401 e i blocchi solo per i modelli 403). Puoi anche esaminare singole tracce nella console Google Cloud.

Imposta i limiti di frequenza e gestisci le quote

Proteggi il tuo progetto da picchi di utilizzo imprevisti e attacchi denial-of-wallet:

Evita sorprese in fattura con avvisi e limiti di spesa

Se il tuo progetto Firebase è nel piano tariffario Blaze con pagamento a consumo:

Passaggi successivi