Pierwsze kroki z regułami zabezpieczeń Firebase

Firebase Security Rules zapewnia niezawodną, w pełni konfigurowalną ochronę danych w Cloud Firestore, Realtime Database i Cloud Storage. Możesz łatwo rozpocząć korzystanie z Security Rules, wykonując czynności opisane w tym przewodniku, aby zabezpieczyć dane i chronić aplikację przed złośliwymi użytkownikami.

Aby uzyskać pomoc AI, skopiuj poniższy prompt do swojego agenta kodowania AI (takiego jak Gemini w Android Studio, Antigravity, Claude Code, Codex czy Cursor). Możesz dostosować prompta i wprowadzać zmiany z agentem. Szczegółowe informacje o instalacji znajdziesz w artykule Umiejętności agenta Firebase.

Help me use Firebase in my app.
1. Make sure that **Firebase agent skills** are installed and updated. For Claude Code, Codex, or Cursor agents, help me install the Firebase plugin. For other agents, run `npx skills add firebase/agent-skills`. Always try to use **Firebase agent skills** for Firebase-related tasks.
2. Help me write, validate, and deploy Firebase Security Rules to protect my app's Cloud Storage data.

Zrozumieć język Firebase Security Rules

Zanim zaczniesz pisać reguły, warto poświęcić trochę czasu na zapoznanie się z językiem Firebase Security Rules używanym w usługach Firebase, z których korzystasz. Cloud Storage wykorzystuje nadzbiór języka Common Expression Language (CEL), który opiera się na instrukcjach match i allow, które określają warunek dostępu do zdefiniowanej ścieżki.

Zacznij od poznania podstawowej składni języka Firebase Security Rules.

Skonfiguruj usługę Authentication

Jeśli jeszcze nie masz dodanej usługi Firebase Authentication do aplikacji, dodaj ją. Firebase Authentication obsługuje wiele popularnych metod uwierzytelniania i integruje się z Firebase Security Rules, aby zapewnić kompleksowe możliwości weryfikacji.

Możesz skonfigurować dodatkowe, niestandardowe informacje uwierzytelniające dla aplikacji.

Dowiedz się więcej o Firebase Security Rules i Firebase Authentication.

Definiowanie struktur danych i reguł

Starannie ustrukturyzuj dane, aby spełniały Twoje wymagania dotyczące bezpieczeństwa.

Sposób, w jaki uporządkujesz dane, może wpłynąć na sposób, w jaki uporządkujesz i wdrożysz reguły. Definiując struktury danych, weź pod uwagę ich wpływ na strukturę Security Rules.

Na przykład w Cloud Storage możesz dodać pole, które określa konkretną rolę każdego użytkownika. Następnie reguły mogą odczytywać to pole i używać go do przyznawania dostępu opartego na rolach. Możesz też utworzyć bazę danych Cloud Firestore, zapisać kryteria dostępu w dokumentach Cloud Firestore, a następnie uzyskać dostęp do tych dokumentów z Cloud Storage Security Rules.

Podczas definiowania architektury danych i reguł pamiętaj o tym, jak reguły są stosowane kaskadowo lub nie, w zależności od usługi. W przypadku Realtime Database reguły działają od góry do dołu, przy czym reguły na płytszym poziomie zastępują reguły na głębszym poziomie. Jeśli reguła przyznaje uprawnienia do odczytu lub zapisu w określonej ścieżce, przyznaje też dostęp do wszystkich węzłów podrzędnych. W przypadku Cloud Firestore i Cloud Storage reguły są stosowane tylko na określonych poziomach hierarchii danych, a Ty piszesz wyraźne reguły, aby kontrolować dostęp do różnych poziomów.

Dostęp do reguł

Aby wyświetlić istniejące Security Rules, użyj interfejsu wiersza poleceń Firebase lub konsoli Firebase. Upewnij się, że edytujesz reguły, używając tej samej metody, aby uniknąć przypadkowego zastąpienia aktualizacji. Jeśli nie masz pewności, czy lokalnie zdefiniowane reguły odzwierciedlają najnowsze aktualizacje, konsola Firebase zawsze pokazuje najnowszą wdrożoną wersję Firebase Security Rules.

Aby uzyskać dostęp do reguł z konsoli Firebase, wybierz projekt, a następnie w panelu nawigacyjnym po lewej stronie kliknij Storage. Gdy znajdziesz się we właściwej bazie danych lub zasobniku na dane, kliknij Security Rules.

Aby uzyskać dostęp do reguł z interfejsu wiersza poleceń Firebase, przejdź do pliku reguł wskazanego w pliku firebase.json.

Tworzenie podstawowych reguł

Podczas tworzenia aplikacji i poznawania Security Rules spróbuj wdrożyć Security Rules, aby rozwiązać kilka podstawowych przypadków użycia, w tym:

  • Tylko właściciel treści: ogranicza dostęp do treści według użytkownika.
  • Dostęp mieszany: ogranicz dostęp do zapisu według użytkownika, ale zezwól na publiczny dostęp do odczytu.
  • Dostęp na podstawie atrybutów: ogranicz dostęp do grupy lub typu użytkownika.

Testowanie reguł

Jeśli konfigurujesz Firebase Security Rules w konsoli Firebase, możesz użyć Firebase Rules Playground, aby szybko sprawdzić działanie. Zalecamy jednak dokładniejsze przetestowanie za pomocą Local Emulator Suite przed wdrożeniem zmian w środowisku produkcyjnym.

Reguły wdrażania

Aby wdrożyć reguły w środowisku produkcyjnym, użyj konsoli Firebase lub interfejsu wiersza poleceń Firebase. Wykonaj czynności opisane w artykule Zarządzanie i wdrażanie Firebase Security Rules.