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

You can trigger functions in response to the creation and deletion of Firebase user accounts. For example, you could send a welcome email to a user who has just created an account in your app. Examples on this page are based on a sample that does exactly this—sends welcome and farewell emails upon account creation and deletion.

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

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

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

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

exports.sendWelcomeEmail = functions.runWith({secrets: [gmailPassword]}).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.runWith({secrets: [gmailPassword]}).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 با استفاده از blocking Cloud Functions گسترش دهید.

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