Prompt AI: scrivi regole di sicurezza Firebase

Attenzione: l'estensione Gemini CLI e il prompt descritti in questa pagina sono una versione beta. Ciò significa che la funzionalità potrebbe cambiare rendendola non compatibile con le versioni precedenti o avere supporto limitato. Una release beta non è soggetta a SLA (accordo sul livello del servizio) o norme sul ritiro.

Questo prompt può aiutare l'assistente AI, ad esempio Gemini CLI, a generare e perfezionare Firebase Security Rules per la tua app. Puoi utilizzare il prompt per creare bozze di Rules per casi d'uso comuni, come la concessione di accesso specifico per l'utente, l'implementazione di autorizzazioni basate sui ruoli e la convalida dei dati.

Questo prompt si concentra sulla generazione di Rules per:

• Cloud Firestore: proteggi raccolte e documenti in base alla logica della tua app.
• Cloud Storage for Firebase: verifica le autorizzazioni di accesso per i file archiviati.

L'utilizzo di questo prompt può aiutarti a iniziare con una solida postura di sicurezza, ma devi sempre testare a fondo Rules prima di eseguire il deployment in produzione. Per ulteriori informazioni sul test di Rules, consulta la sezione Guida introduttiva all'utilizzo di Firebase Security Rules: testa le regole.

Importante:

I tuoi Firebase Security Rules non vengono aggiornati automaticamente. L'estensione Gemini CLI descritta in questa guida viene eseguita una sola volta per creare Rules in base allo stato attuale del progetto. Non monitora continuamente l'app o il file system. Non aggiornerà automaticamente il file delle regole durante lo sviluppo di nuove funzionalità.

Devi aggiornare manualmente il tuo Rules ogni volta che:

• Aggiungi una nuova raccolta o un nuovo percorso di database
• Modificare la struttura o lo schema dei dati
• Modificare la struttura di archiviazione dei file

Per aggiornare Rules, devi eseguire nuovamente il prompt per ricompilare Rules o modificarli manualmente.

Se aggiungi nuove funzionalità senza aggiornare il tuo Rules, rischi di creare:

• Lacune di sicurezza: i nuovi dati potrebbero rimanere non protetti e pubblicamente leggibili/modificabili.
• Funzionalità non funzionanti: l'app potrebbe non riuscire ad accedere ai nuovi dati, causando un errore.

Prerequisiti

• Acquisisci familiarità con le best practice per le regole di sicurezza.
• Per eseguire i test delle unità per Firebase Security Rules e utilizzare Firebase Local Emulator Suite, installa Node.js e la CLI Firebase. Per istruzioni complete, consulta Installare, configurare e integrare Local Emulator Suite.
• Consigliato:se non l'hai ancora fatto, installa Gemini CLI. Le seguenti istruzioni spiegano come installare e utilizzare un'estensione Gemini CLI per generare Rules. Se preferisci utilizzare un altro assistente AI, puoi copiare e incollare il prompt dal repository nell'assistente AI che preferisci.
• Questa estensione Gemini CLI utilizza il server Firebase MCP per convalidare il Firebase Security Rules che genera. Il server MCP può essere utilizzato anche per semplificare il test e l'implementazione del tuo Rules. Installa il server MCP Firebase prima di utilizzare l'estensione per generare Firebase Security Rules.

Limitazioni

Stiamo migliorando attivamente questa esperienza, quindi questo elenco di limitazioni potrebbe cambiare. Controlla spesso per verificare la presenza di aggiornamenti.

• Gemini in Firebase non è in grado di generare Firebase Security Rules. Utilizza un assistente AI alternativo, come Gemini CLI.
• Il prompt è progettato per generare Firebase Security Rules per Cloud Firestore e Cloud Storage for Firebase. Non è ancora in grado di generare Rules per Firebase Realtime Database.
• Firebase Security Rules non vengono chiamate quando si accede al database o al bucket da un server o da un altro ambiente di backend, ad esempio quando si utilizza Firebase Admin SDK. Se utilizzi Admin SDK, sei responsabile della gestione dell'autorizzazione e della convalida dei dati nel codice di backend.

Utilizzare il prompt

Importante:

Quando utilizzi l'AI generativa con la tua app, tieni presente quanto segue:

• L'AI generativa può commettere errori. Controlla sempre le modifiche o l'output prima di eseguire il deployment in produzione.
• Esegui spesso il commit degli snapshot del codice, soprattutto prima di apportare modifiche importanti alla tua app.
• Utilizza questo approccio basato sull'AI a tuo rischio. Google e Firebase non sono responsabili di eventuali vulnerabilità della sicurezza nel Rules generato dall'AI. È tua responsabilità rivedere e testare i Rules generati prima di eseguirne il deployment in produzione.

1. Utilizza l'estensione sperimentale Gemini CLI per Firebase Security Rules per generare le regole e i test.

   Questa estensione analizza il codice sorgente per identificare gli schemi di dati e i pattern di accesso per Cloud Firestore e Cloud Storage. È progettato per creare Rules in base al principio del privilegio minimo e tenta di scoprire le vulnerabilità tramite simulazioni di "attacco" iterative. Per facilitare la verifica finale, fornisce una suite di test unitari iniziali utilizzando @firebase/rules-unit-testing, che ti consente di verificare la logica di sicurezza localmente utilizzando Firebase Local Emulator Suite.

   Nota: questa estensione è in anteprima. Accettiamo feedback e contributi. Se hai suggerimenti o miglioramenti, invia un problema o una richiesta di pull nel repository GitHub.

   Per installare e utilizzare l'estensione:

   1. Installa l'estensione Gemini CLI:

      gemini extensions install https://github.com/firebase/snippets-rules
      

   2. Apri Gemini CLI.

      gemini
      

   Nota: prima di generare le regole, assicurati di essere connesso al server MCP Firebase.

   1. Dalla radice del progetto, esegui l'estensione per generare regole per Cloud Firestore:

      /firebase-rules:firestore Generate rules using PROJECT ID PROJECT_ID
      

      In alternativa, genera regole per Cloud Storage:

      /firebase-rules:storage Generate rules using PROJECT ID PROJECT_ID and BUCKET NAME BUCKET_NAME
      

   L'estensione crea una directory rules_test per Cloud Firestore o una directory storage_rules_test per Cloud Storage nella radice del progetto. Questa nuova directory contiene il file .rules generato insieme a un progetto Node.js con test delle unità.

   Nota: se preferisci utilizzare un altro assistente AI o se vuoi esaminare il prompt completo alla base di questa estensione, puoi visualizzare i prompt nel repository.

2. Esamina i risultati della convalida e del test delle regole:

   • Convalida della sintassi: dopo aver generato le regole, Gemini CLI convalida automaticamente la sintassi utilizzando il comando firebase_validate_security_rules dal server Firebase MCP.
   • Test delle unità: dopo aver convalidato la sintassi, Gemini CLI tenta di eseguire i test delle unità generati utilizzando Firebase Local Emulator Suite. Per eseguire i test, devi eseguire Firebase Local Emulator Suite in un terminale separato.

   Se i test non vengono eseguiti automaticamente, avvia Firebase Local Emulator Suite in un terminale separato, quindi utilizza una delle seguenti opzioni per eseguire i test:

   *   Instruct Gemini CLI to run tests:
       ```none
       Firebase Emulator Suite is running in a separate terminal. Please
       execute the tests.
       ```
   *   Run tests manually by following the instructions in the `README.md`
       file in the `rules_test` or `storage_rules_test` directory.
   

3. Quando sei soddisfatto del risultato del Rules generato, utilizza il seguente comando CLI Firebase per eseguire il deployment del Rules.

   Cloud Firestore

   firebase deploy --only firestore:rules

   Cloud Storage

   firebase deploy --only storage

Risorse aggiuntive

• Per ulteriore assistenza con la tua strategia di sicurezza, puoi anche utilizzare l'estensione di sicurezza per Gemini CLI, un'estensione open source che analizza le modifiche al codice per identificare rischi e vulnerabilità di sicurezza.