Questo prompt può aiutare il tuo assistente AI (come Google Antigravity) a generare e perfezionare Firebase Security Rules per la tua app. Puoi utilizzare il prompt per creare bozze di Security 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 Security Rules per:
- Cloud Firestore: proteggi raccolte e documenti in base alla logica della tua app.
- Cloud Storage for Firebase: convalida le autorizzazioni di accesso per i file archiviati.
L'utilizzo di questo prompt può aiutarti a iniziare con una security posture solida, ma devi sempre testare accuratamente Security Rules prima di eseguire il deployment in produzione. Per saperne di più sul test di Security Rules, consulta Inizia a utilizzare Firebase Security Rules: testa Security Rules.
Prerequisiti
- Acquisisci familiarità con le best practice di Firebase Security Rules.
- Per eseguire i test delle unità per Firebase Security Rules e utilizzare Firebase Local Emulator Suite, installa Node.js e l'interfaccia a riga di comando Firebase. Per istruzioni complete, consulta Installa, configura e integra Firebase Local Emulator Suite.
- Consigliato: se non l'hai ancora fatto,
installa Antigravity.
Le seguenti istruzioni spiegano come attivare e utilizzare le skill dell'agente Firebase e il server MCP per generare Security Rules. Se preferisci utilizzare un altro agente di programmazione AI, puoi copiare e incollare il prompt per Cloud Firestore o Cloud Storage for Firebase dal repository
firebase-toolsnell'agente di programmazione AI scelto. - Le skill dell'agente Firebase e il server MCP collaborano per accedere ai prompt che generano e convalidano Firebase Security Rules e aiutano con i test e il deployment di Security Rules. Installa il server MCP di Firebase prima di utilizzare questi strumenti per generare Firebase Security Rules.
Limitazioni
Stiamo lavorando attivamente per migliorare questa esperienza, pertanto questo elenco di limitazioni potrebbe cambiare. Controlla spesso per verificare la presenza di aggiornamenti.
Il prompt è progettato per generare Firebase Security Rules per Cloud Firestore e Cloud Storage for Firebase. Non è ancora in grado di generare Security Rules per Firebase Realtime Database.
Firebase Security Rules non vengono chiamate quando accedi al tuo database o bucket da un server o da un altro ambiente di backend, ad esempio quando utilizzi Firebase Admin SDK. Se utilizzi Admin SDK, sei responsabile della gestione dell'autorizzazione e della convalida dei dati nel codice di backend.
Gemini in Firebase all'interno della console Firebase non è in grado di generare Firebase Security Rules, anche quando utilizzi questo prompt. Utilizza invece un assistente AI alternativo che abbia accesso alla tua codebase, ad esempio Antigravity (descritto in questa pagina).
Usa il prompt
Questa funzionalità è disponibile quando utilizzi il server MCP Firebase e le skill dell'agente Firebase con un assistente AI compatibile (come Antigravity) per generare Security Rules e test. Questi strumenti analizzano il codice sorgente per aiutarti a identificare gli schemi di dati e i pattern di accesso per Cloud Firestore e Cloud Storage. Sono progettati per creare bozze di Security Rules
basate sul principio del privilegio minimo e tentano di scoprire
le vulnerabilità attraverso simulazioni di "attacco" iterative. Per facilitare la verifica finale, forniscono una suite di test di unità iniziale utilizzando @firebase/rules-unit-testing, che ti consente di verificare la logica di sicurezza localmente utilizzando Firebase Local Emulator Suite.
L'utilizzo di questi strumenti richiede tre passaggi, descritti in questa sezione:
Esamina i risultati della convalida e dei test di Security Rules.
Esegui il deployment di Security Rules nel tuo progetto Firebase.
Passaggio 1: genera Security Rules e test
Configura ed esegui gli strumenti:
Attiva le skill dell'agente Firebase:
Google Antigravity: consulta le istruzioni di configurazione per installare il plug-in Firebase dal Marketplace di Antigravity. Puoi anche installare le skill a livello di progetto eseguendo:
npx skills add firebase/agent-skills --agent=antigravityAltri agenti di programmazione AI: segui le istruzioni per le skill dell'agente e il server MCP.
Avvia l'assistente AI (ad esempio, esegui
agynel terminale per la CLI o apri l'applicazione desktop).Dalla directory principale del progetto, chiedi all'agente di generare Security Rules per Cloud Firestore o Cloud Storage in base a come l'agente di programmazione AI interagisce con i prompt MCP:
Per gli agenti di programmazione che utilizzano il linguaggio naturale (come Antigravity), esegui il prompt dell'agente utilizzando il linguaggio naturale.
Genera Security Rules per Cloud Firestore:
Generate Firestore security rules for this project, then run the unit tests.Nella directory principale, l'agente crea un file
firestore.rulese una nuova directorysecurity_rules_test_firestoreche contiene un progetto Node.js con test delle unità per il file Security Rules generato.Genera Security Rules per Cloud Storage for Firebase:
Generate Cloud Storage security rules for this project, then run the unit tests.Nella directory principale, l'agente crea un file
storage.rulese una nuova directorysecurity_rules_test_storageche contiene un progetto Node.js con test delle unità per il Security Rules generato.
Per gli agenti di programmazione che supportano i comandi slash (come Claude Code), utilizza i seguenti comandi.
Genera Security Rules per Cloud Firestore:
/firestore:generate_security_rulesGenera Security Rules per Cloud Storage for Firebase:
/storage:generate_security_rules
Per gli agenti di programmazione che non supportano l'integrazione dei prompt MCP, puoi copiare il template di prompt non elaborato dal repository
firebase-toolse incollarlo nella chat dell'agente.- Genera Security Rules per Cloud Firestore: copia il prompt da Cloud Firestore.
- Genera Security Rules per Cloud Storage for Firebase: copia il prompt da Cloud Storage for Firebase.
Passaggio 2: esamina i risultati della convalida e dei test di Security Rules
Assicurati che l'agente di programmazione AI esegua le seguenti operazioni. Dovresti ricevere un riepilogo generato dopo l'esecuzione degli strumenti.
Convalida della sintassi: dopo aver generato Security Rules, l'agente di programmazione AI convalida automaticamente la sintassi utilizzando il comando
firebase_validate_security_rulesdal server Firebase MCP.Test delle unità: dopo aver convalidato la sintassi, l'agente di programmazione AI tenta di eseguire i test delle unità generati utilizzando Firebase Local Emulator Suite.
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:
Opzione 1: chiedi all'assistente AI di eseguire i test:
Firebase Emulator Suite is running in a separate terminal. Please execute the tests.Opzione 2: esegui i test manualmente seguendo le istruzioni riportate nel file
README.mdnella directoryrules_testostorage_rules_test.
Passaggio 3: esegui il deployment di Security Rules nel tuo progetto Firebase
Quando il risultato del Security Rules generato ti soddisfa, utilizza i seguenti comandi dell'interfaccia a riga di comando Firebase per eseguire il deployment di Security Rules nel tuo progetto Firebase:
Cloud Firestore
firebase deploy --only firestore:rulesCloud Storage for Firebase
firebase deploy --only storage