Menggunakan ekstensi Hapus Data Pengguna

Dengan ekstensi Hapus Data Pengguna (delete-user-data), Anda dapat menghapus data pengguna saat pengguna tersebut dihapus dari project Firebase. Anda dapat mengonfigurasi ekstensi ini untuk menghapus data pengguna dari salah satu atau semua penyimpanan berikut: Cloud Firestore, Realtime Database, atau Cloud Storage. Setiap pemicu ekstensi untuk menghapus data terikat pada UserId pengguna.

Ekstensi ini berguna untuk menjaga privasi pengguna dan memenuhi persyaratan kepatuhan. Namun, penggunaan ekstensi ini tidak menjamin bahwa Anda mematuhi peraturan pemerintah atau industri.

Prasyarat

Menginstal ekstensi

Untuk menginstal ekstensi, ikuti langkah-langkah di halaman Menginstal Firebase Extension. Singkatnya, lakukan salah satu langkah berikut:

  • Firebase console: Klik tombol berikut:

    Instal ekstensi Hapus Data Pengguna

  • CLI: Jalankan perintah berikut:

    firebase ext:install firebase/delete-user-data --project=projectId-or-alias

Selama penginstalan ekstensi, Anda akan diminta untuk menentukan sejumlah parameter konfigurasi:

  • Lokasi Cloud Functions:

    Pilih lokasi tempat Anda ingin men-deploy fungsi yang dibuat untuk ekstensi ini. Sebaiknya pilih lokasi yang dekat dengan database Anda. Untuk mendapatkan bantuan dalam memilih lokasi, baca panduan memilih lokasi.

  • Jalur Cloud Firestore:

    Jalur mana yang berisi data pengguna di instance Cloud Firestore Anda? Biarkan kosong jika Anda tidak menggunakan Cloud Firestore. Masukkan jalur lengkap yang dipisahkan dengan koma. Anda dapat menandakan User ID pengguna yang dihapus dengan {UID}. Misalnya, jika Anda memiliki koleksi users dan admins, dan setiap koleksi memiliki dokumen dengan User-ID sebagai ID dokumen, Anda dapat memasukkan users/{UID},admins/{UID}.

  • Mode hapus Cloud Firestore:

    (Hanya berlaku jika Anda menggunakan parameter Cloud Firestore paths.) Bagaimana Anda ingin menghapus dokumen Cloud Firestore? Untuk juga menghapus dokumen yang berada di subkoleksi, tetapkan parameter ini ke recursive.

  • Instance Realtime Database:

    Dari instance Realtime Database mana Anda ingin menghapus data pengguna?

  • Lokasi Realtime Database:

    (Hanya berlaku jika Anda memberikan parameter Realtime Database instance.) Dari lokasi Realtime Database mana Anda ingin menghapus data pengguna?

  • Jalur-jalur Realtime Database:

    Jalur mana yang berisi data pengguna di instance Realtime Database Anda? Biarkan kosong jika Anda tidak menggunakan Realtime Database. Masukkan jalur lengkap yang dipisahkan dengan koma. Anda dapat menandakan User ID pengguna yang dihapus dengan {UID}. Contoh: users/{UID},admins/{UID}.

  • Jalur Cloud Storage:

    Di mana dalam Google Cloud Storage Anda menyimpan data pengguna? Biarkan kosong jika Anda tidak menggunakan Cloud Storage. Masukkan jalur lengkap ke file atau direktori di bucket Storage Anda yang dipisahkan dengan koma. Gunakan {UID} untuk menandakan User ID pengguna yang dihapus, dan gunakan {DEFAULT} untuk menandakan bucket Storage default Anda.

    Berikut ini rangkaian contohnya:

    • Untuk menghapus semua file dalam bucket default dengan skema penamaan file {UID}-pic.png, masukkan {DEFAULT}/{UID}-pic.png.
    • Untuk juga menghapus semua file dalam bucket lain yang disebut my-app-logs dengan skema penamaan file {UID}-logs.txt, masukkan {DEFAULT}/{UID}-pic.png,my-app-logs/{UID}-logs.txt.
    • Untuk juga menghapus direktori berlabel ID Pengguna dan semua filenya (seperti media/{UID}), masukkan {DEFAULT}/{UID}-pic.png,my-app-logs/{UID}-logs.txt,{DEFAULT}/media/{UID}.

Menemukan data untuk dihapus

Ada beberapa mekanisme yang digunakan ekstensi ini untuk menemukan data yang akan dihapus. Mekanisme ini harus dikonfigurasi secara eksplisit agar ekstensi dapat menghapus data. Ekstensi hanya akan menghapus data yang secara eksplisit dikonfigurasi untuk dihapus berdasarkan mekanisme yang diberikan.

Perhatikan perbedaan perilaku berikut di antara setiap layanan:

  • Cloud Firestore: perilaku default-nya adalah menghapus dokumen secara dangkal (sub-koleksi tidak akan dihapus). Untuk menghapus semua subkoleksi dokumen secara rekursif, tetapkan opsi "Mode hapus Cloud Firestore" ke "Rekursif".
  • Realtime Database: semua data di node yang ditentukan akan dihapus.
  • Penyimpanan: jika jalur direktori ditentukan, semua file dan subdirektori akan dihapus.

Menurut jalur

Saat mengonfigurasi jalur Cloud Firestore, Realtime Database & Cloud Storage, Anda dapat menentukan variabel UID di jalur yang akan diganti dengan UID pengguna terautentikasi. Saat pengguna dihapus, ekstensi akan menghapus semua data yang terkait dengan UID tersebut pada jalur tertentu, misalnya:

  • Jalur Cloud Firestore: users/{UID},admins/{UID}
  • Jalur Realtime Database: likes/{UID}
  • Jalur Cloud Storage: {DEFAULT}/uploads/{UID},{DEFAULT}/avatars/{UID}.jpeg

Penemuan Otomatis (Cloud Firestore)

Agar ekstensi dapat otomatis menemukan dokumen Firestore yang akan dihapus, tetapkan parameter konfigurasi "Enable auto discovery" ke "Yes".

Penemuan otomatis bekerja dengan menjelajahi database secara otomatis untuk menemukan koleksi dan dokumen yang harus dihapus sesuai dengan konfigurasi Anda. Ekstensi mengidentifikasi koleksi dan dokumen tersebut dengan metodologi berikut:

  1. Pertama, ekstensi akan menemukan semua koleksi root di database. Jika ID koleksi cocok dengan UID pengguna, seluruh koleksi akan dihapus (penghapusan bersifat rekursif atau dangkal, bergantung pada konfigurasi ekstensi untuk "mode hapus Cloud Firestore").
  2. Kedua, jika ID koleksi tidak cocok, ekstensi akan mencoba mengidentifikasi dan menghapus dokumen jika ID dokumennya cocok dengan ID UID pengguna.
  3. Terakhir, untuk setiap dokumen: a. Jika kedalaman penelusuran saat ini (lihat di bawah) kurang dari atau sama dengan kedalaman penelusuran yang dikonfigurasi, proses akan diulang untuk semua subkoleksi dokumen saat ini. b. Jika kolom penelusuran telah dikonfigurasi, ekstensi akan memeriksa apakah kolom yang diberikan cocok dengan UID pengguna. Jika kecocokan ditemukan, dokumen akan dihapus.

Kedalaman Penelusuran

Ekstensi ini menawarkan nilai kedalaman penelusuran yang dapat dikonfigurasi (default-nya adalah 3). Traversal hanya akan dijalankan jika kedalaman penelusuran saat ini kurang dari atau sama dengan kedalaman penelusuran yang dikonfigurasi. Kedalaman penelusuran saat ini didasarkan pada kedalaman koleksi saat ini atau koleksi induk dokumen, misalnya

/users = 1
/users/<document-id> = 1
/users/<document-id>/comments = 2
/users/<document-id>/comments/<document-id> = 2

Ekstensi ini TIDAK akan otomatis menghapus UID yang disimpan dalam array atau peta, dan tidak akan menelusuri data yang terkait dengan ID pengguna yang disimpan dalam subkoleksi bertingkat yang dalam setelah kedalaman yang ditentukan di atas.