Pemicu Firebase Authentication

Anda dapat memicu Cloud Functions sebagai respons terhadap pembuatan dan penghapusan akun pengguna Firebase. Misalnya, Anda dapat mengirim email sambutan kepada pengguna yang baru saja membuat akun di aplikasi Anda. Contoh di halaman ini didasarkan pada contoh fungsi yang melakukan hal tersebut, yaitu mengirimkan email sambutan saat akun dibuat dan email perpisahan saat akun dihapus.

Untuk mengetahui contoh kasus penggunaan lainnya, lihat artikel Apa yang dapat saya lakukan dengan Cloud Functions?.

Catatan: Cloud Functions for Firebase (generasi ke-2) tidak memberikan dukungan untuk peristiwa dan pemicu yang dijelaskan dalam panduan ini. Karena fungsi generasi ke-1 dan generasi ke-2 dapat berdampingan dalam file sumber yang sama, Anda masih dapat mengembangkan dan men-deploy fungsi ini bersama dengan fungsi generasi ke-2.

Memicu fungsi pada saat pembuatan pengguna

Anda dapat membuat fungsi yang memicu saat pengguna Firebase dibuat menggunakan pengendali peristiwa functions.auth.user().onCreate():

exports.sendWelcomeEmail = functions.auth.user().onCreate((user) => {
  // ...
});

Akun Firebase akan memicu peristiwa pembuatan pengguna untuk Cloud Functions saat:

• Pengguna membuat akun email dan sandi.
• Pengguna login untuk pertama kalinya menggunakan penyedia identitas gabungan.
• Developer membuat akun menggunakan Admin SDK.
• Pengguna login ke sesi autentikasi anonim baru untuk pertama kalinya.

Peristiwa Cloud Functions tidak dipicu ketika pengguna login untuk pertama kali menggunakan token kustom.

Mengakses atribut pengguna

Dari data pengguna yang ditampilkan ke fungsi, Anda dapat mengakses daftar atribut pengguna yang tersedia di objek UserRecord pengguna yang baru dibuat. Misalnya, Anda dapat memperoleh email dan nama tampilan pengguna, seperti ditunjukkan berikut ini:

const email = user.email; // The email of the user.
const displayName = user.displayName; // The display name of the user.
index.js

Memicu fungsi pada saat penghapusan pengguna

Seperti halnya Anda dapat memicu fungsi pada saat pembuatan pengguna, Anda dapat merespons peristiwa penghapusan pengguna. Gunakan pengendali peristiwa functions.auth.user().onDelete() seperti yang ditunjukkan di bawah ini:

exports.sendByeEmail = functions.auth.user().onDelete((user) => {
  // ...
});

Perhatian: Menghapus beberapa pengguna sekaligus menggunakan Firebase Admin SDK (misalnya, admin.auth().deleteUsers([uid1, uid2]) di Node.js) tidak mengaktifkan peristiwa penghapusan pengguna, sehingga pengendali peristiwa yang disiapkan menggunakan functions.auth.user().onDelete() tidak akan dipicu. Hapus pengguna satu per satu jika Anda ingin mengaktifkan peristiwa penghapusan pengguna untuk setiap pengguna yang dihapus.

Memicu fungsi pemblokiran

Jika telah mengupgrade ke Firebase Authentication with Identity Platform, Anda dapat memperluas Firebase Authentication menggunakan fungsi pemblokiran Cloud Functions.

Fungsi pemblokiran dapat Anda gunakan untuk mengeksekusi kode kustom yang mengubah hasil pendaftaran atau login pengguna ke aplikasi Anda. Misalnya, Anda dapat mencegah pengguna melakukan autentikasi jika tidak memenuhi kriteria tertentu, atau memperbarui informasi pengguna sebelum menampilkannya ke aplikasi klien.