عوامل تشغيل مصادقة 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 عندما يسجّل مستخدم الدخول للمرة الأولى باستخدام رمز مميّز مخصّص.

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

من بيانات المستخدم التي يتم عرضها في الدالة، يمكنك الوصول إلى قائمة سمات المستخدم المتاحة في عنصر 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.

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