عوامل تشغيل مصادقة Firebase

يمكنك تنشيط الدوالّ استجابةً لإنشاء حسابات مستخدمين Firebase وحذفها. على سبيل المثال، يمكنك إرسال رسالة إلكترونية ترحيبية إلى مستخدم أنشأ للتو حسابًا في تطبيقك. تستند الأمثلة الواردة في هذه الصفحة إلى نموذج يفعل ذلك بالضبط، أي إرسال رسائل إلكترونية ترحيبية ورسائل إلكترونية عند الخروج عند إنشاء الحساب وحذفه.

لمزيد من الأمثلة على حالات الاستخدام، يمكنك الاطّلاع على مقالة ما الذي يمكنني فعله باستخدام Cloud Functions؟.

ملاحظة: لا يتوافق "الجيل الثاني" مع "Cloud Functions for Firebase" والأحداث والعوامل المشغلة الموضحة في هذا الدليل. لأنّ الجيل الأول والجيل الثاني جنبًا إلى جنب في نفس الملف المصدر، فلا يزال بإمكانك وتطوير هذه الوظيفة ونشرها مع وظائف الجيل الثاني.

تشغيل دالة عند إنشاء المستخدم

يمكنك إنشاء دالة يتم تشغيلها عندما يكون مستخدم Firebase تم إنشاؤه باستخدام functions.auth.user().onCreate() معالج الحدث:

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

ستؤدي حسابات Firebase إلى بدء أحداث إنشاء مستخدمين في Cloud Functions في الحالات التالية:

• ينشئ المستخدم حساب بريد إلكتروني وكلمة مرور.
• يسجِّل مستخدم الدخول لأول مرة باستخدام موفِّر هوية مُوحَّد.
• ينشئ المطوّر حسابًا باستخدام حزمة تطوير البرامج (SDK) للمشرف.
• يسجِّل المستخدم الدخول إلى جلسة مصادقة جديدة مجهولة المصدر لأول مرة.

لا يتم تشغيل حدث Cloud Functions عندما يسجِّل المستخدم الدخول إلى باستخدام رمز مميّز مخصّص للمرة الأولى.

الوصول إلى سمات المستخدمين

من بيانات المستخدم التي يتم إرجاعها إلى الدالة، يمكنك الوصول إلى قائمة سمات المستخدمين المتوفرة في ملف CSV 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) => {
  // ...
});

ملاحظة: لا يؤدي حذف عدة مستخدمين في آنٍ واحد باستخدام حزمة تطوير البرامج (SDK) للمشرف في Firebase (مثل admin.auth().deleteUsers([uid1, uid2]) في Node.js) إلى بدء أحداث حذف المستخدمين، لذا لن يتم بدء معالجات الأحداث التي تم إعدادها باستخدام functions.auth.user().onDelete(). يمكنك حذف المستخدمين واحدًا تلو الآخر إذا كنت تريد بدء أحداث حذف المستخدمين لكل مستخدم تم حذفه.

تشغيل دوال الحظر

في حال الترقية إلى Firebase Authentication with Identity Platform، يمكنك تمديد فترة Firebase Authentication باستخدام حظر Cloud Functions

تتيح لك وظائف الحظر تنفيذ رمز مخصّص يُعدّل نتيجة تسجيل أحد المستخدمين أو تسجيل الدخول إلى تطبيقك. على سبيل المثال، يمكنك منع أحد المستخدمين من المصادقة إذا لم يستوفِ معايير معيّنة، أو تعديل معلومات أحد المستخدمين قبل إعادتها إلى تطبيق العميل.