Anda dapat memicu Cloud Functions sebagai respons terhadap pembuatan dan penghapusan akun pengguna Firebase. Misalnya, Anda dapat mengirimkan email selamat datang kepada pengguna yang baru saja membuat akun di aplikasi Anda. Contoh di halaman ini didasarkan pada contoh yang melakukan persis seperti ini—mengirimkan email selamat datang dan perpisahan setelah pembuatan dan penghapusan akun.
Untuk contoh kasus penggunaan lainnya, lihat Apa yang dapat saya lakukan dengan Cloud Functions?
Memicu fungsi pada pembuatan pengguna
Anda bisa membuat fungsi yang terpicu saat pengguna Firebase dibuat menggunakan event handler functions.auth.user().onCreate()
:
exports.sendWelcomeEmail = functions.auth.user().onCreate((user) => { // ... });
Akun Firebase akan memicu peristiwa pembuatan pengguna untuk Cloud Functions saat:
- Seorang pengguna membuat akun email dan kata sandi.
- Pengguna masuk untuk pertama kali menggunakan penyedia identitas federasi.
- Pengembang membuat akun menggunakan Firebase Admin SDK.
- Pengguna masuk ke sesi autentikasi anonim baru untuk pertama kalinya.
Peristiwa Cloud Functions tidak terpicu saat pengguna masuk untuk pertama kali menggunakan token khusus.
Akses atribut pengguna
Dari data pengguna yang dikembalikan ke fungsi Anda, Anda dapat mengakses daftar atribut pengguna yang tersedia di objek UserRecord
pengguna yang baru dibuat. Misalnya, Anda bisa mendapatkan email pengguna dan nama tampilan seperti yang ditunjukkan:
const email = user.email; // The email of the user. const displayName = user.displayName; // The display name of the user.
Memicu fungsi pada penghapusan pengguna
Sama seperti Anda dapat memicu fungsi pada pembuatan pengguna, Anda dapat merespons peristiwa penghapusan pengguna. Gunakan event handler functions.auth.user().onDelete()
seperti yang ditunjukkan:
exports.sendByeEmail = functions.auth.user().onDelete((user) => { // ... });
Memicu fungsi pemblokiran
Jika Anda telah mengupgrade ke Firebase Authentication dengan Identity Platform, Anda dapat memperluas Firebase Authentication menggunakan Cloud Functions pemblokiran .
Fungsi pemblokiran memungkinkan Anda mengeksekusi kode khusus yang mengubah hasil pendaftaran atau login pengguna ke aplikasi Anda. Misalnya, Anda dapat mencegah pengguna mengautentikasi jika mereka tidak memenuhi kriteria tertentu, atau memperbarui informasi pengguna sebelum mengembalikannya ke aplikasi klien Anda.