Pierwsze kroki z regułami zabezpieczeń Cloud Firestore

Dzięki Cloud Firestore Security Rules możesz skupić się na tworzeniu wrażeń użytkowników bez konieczności zarządzania infrastrukturą ani pisania kodu uwierzytelniania i autoryzacji po stronie serwera.

Reguły zabezpieczeń zapewniają kontrolę dostępu i weryfikację danych w prostym, ale jednocześnie wyrazistym formacie. Aby tworzyć systemy dostępu oparte na użytkownikach i rolach, które chronią dane użytkowników, musisz używać Uwierzytelniania Firebase z Cloud Firestore Security Rules.

Reguły zabezpieczeń (wersja 2)

Od maja 2019 roku dostępna jest wersja 2 reguł zabezpieczeń Cloud Firestore. Wersja 2 reguł zmienia działanie rekursywnych zaimków {name=**}. Jeśli planujesz używać zapytań dotyczących grup kolekcji, musisz użyć wersji 2. Musisz wyrazić zgodę na wersję 2, ustawiając rules_version = '2'; jako pierwszy wiersz w regułach bezpieczeństwa:

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {

Pisanie reguł

Napisz i zarządzaj Cloud Firestore Security Rules dostosowanymi do modelu danych utworzonych przez Ciebie w bazie danych domyślnej i każdej dodatkowej bazie danych w projekcie.

Wszystkie Cloud Firestore Security Rules składają się z instrukcji match, które identyfikują dokumenty w Twojej bazie danych, oraz wyrażeń allow, które kontrolują dostęp do tych dokumentów:

service cloud.firestore {
  match /databases/{database}/documents {
    match /<some_path>/ {
      allow read, write: if <some_condition>;
    }
  }
}

Każde żądanie bazy danych z biblioteki klienta mobilnego lub internetowego Cloud Firestore jest sprawdzane pod kątem zgodności z Twoimi regułami zabezpieczeń, zanim zostaną odczytane lub zapisane jakiekolwiek dane. Jeśli reguły odmawiają dostępu do ścieżki dowolnego z wybranych dokumentów, cała prośba kończy się niepowodzeniem.

Poniżej znajdziesz kilka przykładów podstawowych zestawów reguł. Te reguły są prawidłowe, ale nie zalecamy ich stosowania w przypadku aplikacji produkcyjnych:

Wymagane uwierzytelnianie

// Allow read/write access on all documents to any user signed in to the application
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if request.auth != null;
    }
  }
}

Odrzucaj wszystko

// Deny read/write access to all users under any conditions
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if false;
    }
  }
}

Zezwalaj na wszystkie

// Allow read/write access to all users under any conditions
// Warning: **NEVER** use this rule set in production; it allows
// anyone to overwrite your entire database.
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if true;
    }
  }
}

Ścieżka {document=**} użyta w przykładach powyżej pasuje do dowolnego dokumentu w całej bazie danych. Aby dowiedzieć się, jak dopasowywać konkretne ścieżki danych i pracować z danymi hierarchicznymi, zapoznaj się z instrukcjami tworzenia reguł zabezpieczeń.

Reguły testowania

Cloud Firestore udostępnia symulator reguł, którego możesz użyć do przetestowania zbioru reguł. Dostęp do symulatora uzyskasz na karcie Reguły w sekcji Cloud Firestore konsoli Firebase.

Symulacja reguł umożliwia symulowanie odczytów, zapisów i usunięcia uwierzytelnionych i nieuwierzytelnionych. Podczas symulowania uwierzytelnionego żądania możesz tworzyć i wyświetlać podgląd tokenów uwierzytelniania od różnych dostawców. Symulowane żądania są wykonywane na podstawie zestawu reguł w Twoim edytorze, a nie na podstawie aktualnie wdrożonego zestawu reguł.

Wdrażanie reguł

Zanim zaczniesz korzystać z Cloud Firestore w aplikacji mobilnej, musisz wdrożyć reguły bezpieczeństwa. Reguły możesz wdrażać w konsoli Firebase, za pomocą interfejsu wiersza poleceń Firebase lub za pomocą interfejsu REST API do zarządzania Cloud Firestore.

Zmiany w Cloud Firestore Security Rules mogą wpływać na nowe zapytania i słuchaczy przez maksymalnie minutę. Pełne rozpowszechnienie zmian i ich wpływ na aktywnych słuchaczy mogą jednak potrwać do 10 minut.

Korzystanie z konsoli Firebase

Aby skonfigurować i wdrażać pierwszy zestaw reguł w przypadku domyślnej bazy danych w projekcie, otwórz w konsoli Firebase sekcję Cloud Firestore i kliknij kartę Reguły.

Wpisz reguły w edytorze internetowym, a potem kliknij Opublikuj.

Korzystanie z wiersza poleceń Firebase

Możesz też wdrażać reguły za pomocą interfejsu wiersza poleceń Firebase. Za pomocą interfejsu wiersza poleceń możesz kontrolować wersje reguł razem z kodem aplikacji i wdrażać reguły w ramach istniejącego procesu wdrażania.

// Set up Firestore in your project directory, creates a .rules file
firebase init firestore

// Edit the generated .rules file to your desired security rules
// ...

// Deploy rules for all configured databases
firebase deploy --only firestore

Zwiększanie bezpieczeństwa w Cloud Storage

Twoje aplikacje będą korzystać z solidnych funkcji bazy danych Cloud Firestore oraz funkcji przechowywania plików i zarządzania nimi w usłudze Cloud Storage. Korzystanie z tych usług wzmacnia też bezpieczeństwo aplikacji, ponieważ Cloud Firestore może rejestrować wymagania dotyczące autoryzacji, które mogą być używane przez reguły zabezpieczeń Firebase w obu usługach. Więcej informacji znajdziesz w przewodniku Cloud Storage.

Dalsze kroki