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

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

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

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

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

exports.sendWelcomeEmail = functions.runWith({secrets: [gmailPassword]}).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.runWith({secrets: [gmailPassword]}).auth.user().onDelete((user) => {
  // ...
});

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

إذا رقّيت إلى Firebase Authentication with Identity Platform، يمكنك توسيع نطاق Firebase Authentication باستخدام دوال الحظر في Cloud Functions.

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