Catch up on everthing we announced at this year's Firebase Summit. Learn more

Memulai Aturan Keamanan Cloud Firestore

Dengan Aturan Keamanan Cloud Firestore, Anda dapat fokus membangun pengalaman pengguna yang menyenangkan, tanpa harus mengelola infrastruktur atau menulis autentikasi sisi server dan kode otorisasi.

Aturan keamanan memberikan kontrol akses dan validasi data dalam format yang sederhana namun ekspresif. Untuk membuat sistem akses berbasis pengguna dan berbasis peran yang mempertahankan keamanan data pengguna, Anda harus menggunakan Firebase Authentication dengan Aturan Keamanan Cloud Firestore.

Aturan keamanan versi 2

Aturan keamanan Cloud Firestore versi 2 sudah tersedia sejak bulan Mei 2019. Versi 2 aturan mengubah perilaku karakter pengganti rekursif {name=**}. Anda harus menggunakan versi 2 jika berencana untuk menggunakan kueri grup koleksi. Anda harus memilih versi 2 dengan menerapkan rules_version = '2'; di baris pertama dalam aturan keamanan Anda:

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

Menulis aturan

Semua Aturan Keamanan Cloud Firestore terdiri dari pernyataan match, yang mengidentifikasi dokumen di database Anda, dan ekspresi allow, yang mengontrol akses ke dokumen tersebut:

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

Sebelum membaca atau menulis data, setiap permintaan database dari library klien seluler/web Cloud Firestore dievaluasi terhadap aturan keamanan Anda. Apabila aturan tersebut menolak akses ke salah satu lokasi dokumen yang ditentukan, seluruh permintaan akan gagal.

Berikut adalah beberapa contoh kumpulan aturan dasar. Meskipun valid, aturan ini tidak direkomendasikan untuk aplikasi produksi:

Auth diperlukan

// 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;
    }
  }
}

Tolak semua

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

Izinkan semua

// 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;
    }
  }
}

Jalur {document=**} yang digunakan dalam contoh di atas cocok dengan dokumen apa pun di seluruh database. Lanjutkan ke panduan membuat struktur aturan keamanan untuk mempelajari cara mencocokkan jalur data tertentu dan menangani data hierarkis.

Aturan pengujian

Cloud Firestore menyediakan simulator aturan yang dapat Anda gunakan untuk menguji kumpulan aturan Anda. Anda dapat mengakses simulator dari tab Aturan di bagian Cloud Firestore di Firebase console.

Dengan simulator aturan, Anda dapat menyimulasikan pembacaan, penulisan, dan penghapusan yang diautentikasi dan tidak diautentikasi. Saat menyimulasikan permintaan terautentikasi, Anda dapat membuat dan melihat pratinjau token autentikasi dari berbagai penyedia. Permintaan yang disimulasikan berjalan melawan kumpulan aturan di editor Anda, bukan aturan yang saat ini digunakan.

Menerapkan aturan

Agar dapat menggunakan Cloud Firestore dari aplikasi seluler, Anda harus menerapkan aturan keamanan. Anda dapat menerapkan aturan di Firebase console atau menggunakan Firebase CLI.

Pembaruan untuk Aturan Keamanan Firestore Cloud dapat memakan waktu hingga satu menit untuk memengaruhi permintaan dan listener baru. Namun, diperlukan waktu hingga 10 menit untuk sepenuhnya menerapkan perubahan dan memengaruhi pemroses aktif mana pun.

Menggunakan Firebase console

Untuk menyiapkan dan men-deploy rangkaian aturan yang pertama, buka tab Aturan di bagian Cloud Firestore di Firebase console.

Tulis aturan Anda di editor online, lalu klik Publikasikan.

Menggunakan Firebase CLI

Anda juga dapat menerapkan aturan menggunakan Firebase CLI. Dengan CLI, Anda dapat mempertahankan aturan dalam kontrol versi bersama kode aplikasi Anda, serta menerapkan aturan sebagai bagian dari proses penerapan yang sudah ada.

// 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 your .rules file
firebase deploy --only firestore:rules

Langkah berikutnya