عوامل تشغيل مصادقة 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.

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