Prompt AI: napisz reguły zabezpieczeń Firebase

Ten prompt może pomóc asystentowi AI (np. Google Antigravity) wygenerować i ulepszyć Firebase Security Rules dla Twojej aplikacji. Możesz użyć prompta, aby utworzyć wersję roboczą Security Rules dla typowych przypadków użycia, takich jak przyznawanie dostępu konkretnym użytkownikom, wdrażanie uprawnień opartych na rolach i sprawdzanie poprawności danych.

Ten prompt skupia się na generowaniu Security Rules dla:

  • Cloud Firestore: zabezpiecz kolekcje i dokumenty na podstawie logiki aplikacji.
  • Cloud Storage for Firebase: sprawdź uprawnienia dostępu do przechowywanych plików.

Ten prompt może pomóc Ci zacząć od silnego stanu zabezpieczeń, ale zawsze należy dokładnie przetestować Security Rules przed wdrożeniem w środowisku produkcyjnym. Więcej informacji o testowaniu Security Rules znajdziesz w artykule Pierwsze kroki z Firebase Security Rules: testowanie Security Rules.

Wymagania wstępne

Ograniczenia

Stale ulepszamy tę funkcję, więc ta lista ograniczeń może się zmienić. Sprawdzaj regularnie, czy nie pojawiły się nowe informacje.

  • Prompt jest przeznaczony do generowania Firebase Security Rules dla Cloud Firestore i Cloud Storage for Firebase. Nie może jeszcze generować Security Rules dla: Firebase Realtime Database.

  • Reguły Firebase Security Rules nie są wywoływane, gdy uzyskujesz dostęp do bazy danych lub zasobnika z serwera lub innego środowiska backendu, np. gdy używasz Firebase Admin SDK. Jeśli używasz Admin SDK, odpowiadasz za zarządzanie autoryzacją i weryfikacją danych w kodzie backendu.

  • Gemini w Firebase w konsoli Firebase nie może wygenerować Firebase Security Rules, nawet gdy używasz tego prompta. Zamiast tego użyj alternatywnego asystenta AI, który ma dostęp do Twojej bazy kodu, takiego jak Antigravity (opisany na tej stronie).

Użyj prompta

Ta funkcja jest dostępna, gdy używasz serwera MCP Firebase i umiejętności agenta Firebase ze zgodnym asystentem AI (takim jak Antigravity) do generowania Security Rules i testów. Te narzędzia analizują kod źródłowy, aby pomóc w identyfikacji schematów danych i wzorców dostępu dla Cloud Firestore i Cloud Storage. Są one zaprojektowane tak, aby tworzyć wersje robocze Security Rules na podstawie zasady jak najmniejszych uprawnień i próbować wykrywać luki w zabezpieczeniach za pomocą iteracyjnych symulacji „ataków”. Aby ułatwić ostateczną weryfikację, udostępniają początkowy zestaw testów jednostkowych przy użyciu @firebase/rules-unit-testing, co pozwala na lokalne zweryfikowanie logiki zabezpieczeń za pomocą Firebase Local Emulator Suite.

Korzystanie z tych narzędzi wymaga wykonania 3 czynności, które opisujemy w tej sekcji:

  1. Wygeneruj Security Rules i testy.

  2. Sprawdź wyniki weryfikacji i testów Security Rules.

  3. Wdróż Security Rules w projekcie w Firebase.

Krok 1. Wygeneruj Security Rules i testy

Skonfiguruj i uruchom narzędzia:

  1. Włącz umiejętności agenta Firebase:

    • Google Antigravity: zapoznaj się z instrukcjami konfiguracji, aby zainstalować wtyczkę Firebase z Antigravity Marketplace. Możesz też zainstalować umiejętności na poziomie projektu, uruchamiając polecenie:

      npx skills add firebase/agent-skills --agent=antigravity
    • Inne agenty AI do kodowania: postępuj zgodnie z instrukcjami dotyczącymi umiejętności agenta i serwera MCP.

  2. Uruchom asystenta AI (np. uruchom agy w terminalu, aby otworzyć interfejs wiersza poleceń, lub otwórz aplikację komputerową).

  3. W głównym katalogu projektu poproś agenta o wygenerowanie Security Rules dla Cloud Firestore lub Cloud Storage w zależności od tego, jak agent AI do kodowania wchodzi w interakcje z promptami MCP:

    • W przypadku agentów do kodowania, którzy używają języka naturalnego (takich jak Antigravity), używaj promptów w języku naturalnym.

      • Wygeneruj Security Rules dla Cloud Firestore:

        Generate Firestore security rules for this project, then run the unit tests.
        

        W katalogu nadrzędnym agent tworzy plik firestore.rules i nowy katalog security_rules_test_firestore, który zawiera projekt Node.js z testami jednostkowymi wygenerowanego pliku Security Rules.

      • Wygeneruj Security Rules dla: Cloud Storage for Firebase

        Generate Cloud Storage security rules for this project, then run the unit tests.
        

        W katalogu nadrzędnym agent tworzy plik storage.rules i nowy katalog security_rules_test_storage, który zawiera projekt Node.js z testami jednostkowymi wygenerowanego pliku Security Rules.

    • W przypadku agentów kodujących, którzy obsługują polecenia po ukośniku (takich jak Claude Code), użyj tych poleceń.

      • Wygeneruj Security Rules dla Cloud Firestore:

        /firestore:generate_security_rules
        
      • Wygeneruj Security Rules dla: Cloud Storage for Firebase

        /storage:generate_security_rules
        
    • W przypadku agentów kodujących, którzy nie obsługują integracji promptów MCP, możesz skopiować nieprzetworzony szablon prompta z repozytorium firebase-tools i wkleić go na czacie agenta.

Krok 2. Sprawdź wyniki weryfikacji i testów Security Rules

  1. Upewnij się, że asystent kodowania AI wykonał te czynności. Po uruchomieniu narzędzi powinno zostać wygenerowane podsumowanie.

    • Sprawdzanie składni: po wygenerowaniu Security Rules agent AI do kodowania automatycznie sprawdza składnię za pomocą polecenia firebase_validate_security_rules z serwera MCP Firebase.

    • Testy jednostkowe: po sprawdzeniu składni agent AI do kodowania próbuje uruchomić wygenerowane testy jednostkowe za pomocą Firebase Local Emulator Suite.

  2. Jeśli testy nie uruchamiają się automatycznie, uruchom Firebase Local Emulator Suite w osobnym terminalu, a następnie użyj jednej z tych opcji, aby uruchomić testy:

    • Opcja 1. Poproś asystenta AI o przeprowadzenie testów:

      Firebase Emulator Suite is running in a separate terminal. Please execute the tests.
      
    • Opcja 2. Przeprowadź testy ręcznie, postępując zgodnie z instrukcjami podanymi w pliku README.md w katalogu rules_test lub storage_rules_test.

Krok 3. Wdróż Security Rules w projekcie w Firebase

Gdy uznasz, że wygenerowany element Security Rules jest gotowy, użyj tych poleceń interfejsu wiersza poleceń Firebase, aby wdrożyć Security Rules w projekcie w Firebase:

  • Cloud Firestore

    firebase deploy --only firestore:rules
  • Cloud Storage for Firebase

    firebase deploy --only storage