Pemicu Firebase Authentication

Anda dapat memicu fungsi 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, baca Apa yang dapat dilakukan dengan Cloud Functions?.

Memicu fungsi pada 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 Firebase 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.

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) => {
  // ...
});

Memicu fungsi pemblokiran

Jika telah mengupgrade ke Firebase Authentication dengan 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 mengembalikannya ke aplikasi klien.