محرک های احراز هویت Firebase

می‌توانید عملکردهایی را در پاسخ به ایجاد و حذف حساب‌های کاربری Firebase فعال کنید. به عنوان مثال، می توانید یک ایمیل خوش آمدگویی برای کاربری ارسال کنید که به تازگی یک حساب کاربری در برنامه شما ایجاد کرده است. نمونه‌های موجود در این صفحه بر اساس نمونه‌ای است که دقیقاً این کار را انجام می‌دهد - ایمیل‌های خوشامدگویی و خداحافظی را پس از ایجاد و حذف حساب ارسال می‌کند.

برای مثال‌های بیشتر از موارد استفاده، ببینید با Cloud Functions چه کاری می‌توانم انجام دهم؟ .

توجه: Cloud Functions for Firebase (نسل دوم) از رویدادها و محرک‌های توضیح داده شده در این راهنما پشتیبانی نمی‌کند. از آنجایی که توابع نسل اول و نسل دوم می توانند در کنار هم در یک فایل منبع وجود داشته باشند، شما همچنان می توانید این عملکرد را همراه با توابع نسل دوم توسعه و اجرا کنید.

فعال کردن یک تابع در ایجاد کاربر

می‌توانید تابعی ایجاد کنید که هنگام ایجاد کاربر Firebase با استفاده از کنترل‌کننده رویداد functions.auth.user().onCreate() فعال شود:

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

حساب‌های Firebase رویدادهای ایجاد کاربر را برای Cloud Functions هنگامی که:

• کاربر یک حساب ایمیل و رمز عبور ایجاد می کند.
• یک کاربر برای اولین بار با استفاده از یک ارائه دهنده هویت فدرال وارد سیستم می شود.
• توسعه دهنده یک حساب کاربری با استفاده از Admin SDK ایجاد می کند.
• یک کاربر برای اولین بار به یک جلسه احراز هویت ناشناس جدید وارد می شود.

هنگامی که کاربر برای اولین بار با استفاده از یک نشانه سفارشی وارد سیستم می شود، رویداد Cloud Functions فعال نمی شود.

دسترسی به ویژگی های کاربر

از داده‌های کاربر که به عملکرد شما بازگردانده شده‌اند، می‌توانید به فهرست ویژگی‌های کاربر موجود در شی UserRecord کاربر تازه ایجاد شده دسترسی داشته باشید. به عنوان مثال، می توانید ایمیل و نام نمایشی کاربر را مطابق شکل دریافت کنید:

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

فعال کردن یک تابع در هنگام حذف کاربر

همانطور که می توانید یک تابع را در ایجاد کاربر فعال کنید، می توانید به رویدادهای حذف کاربر نیز پاسخ دهید. همانطور که نشان داده شده است از کنترل کننده رویداد functions.auth.user().onDelete() استفاده کنید:

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

احتیاط: حذف چند کاربر به طور همزمان با استفاده از Firebase Admin SDK (به عنوان مثال، admin.auth().deleteUsers([uid1, uid2]) در Node.js) رویدادهای حذف کاربر را فعال نمی کند، بنابراین کنترل کننده رویداد با استفاده از functions.auth.user().onDelete() فعال نخواهد شد . اگر می خواهید رویدادهای حذف کاربر برای هر کاربر حذف شده فعال شود، کاربران را یکی یکی حذف کنید.

توابع مسدود کردن را فعال کنید

اگر Firebase Authentication with Identity Platform ارتقا داده اید، می توانید Firebase Authentication با استفاده از مسدود کردن Cloud Functions گسترش دهید.

توابع مسدود کردن به شما امکان می دهند کد سفارشی را اجرا کنید که نتیجه ثبت نام یا ورود کاربر به برنامه شما را تغییر می دهد. برای مثال، می‌توانید از احراز هویت کاربر در صورت عدم رعایت معیارهای خاص جلوگیری کنید یا اطلاعات کاربر را قبل از بازگرداندن آن به برنامه مشتری خود به‌روزرسانی کنید.