يمكنك تشغيل الدوال استجابةً لإنشاء حسابات المستخدمين وحذفها في Firebase Authentication. على سبيل المثال، يمكنك إرسال رسالة إلكترونية ترحيبية إلى مستخدم أنشأ حسابًا للتو في تطبيقك. تستند الأمثلة في هذه الصفحة إلى نموذج يفعل ذلك تحديدًا، أي يرسل رسائل إلكترونية ترحيبية ووداعية عند إنشاء الحساب وحذفه.
لمزيد من الأمثلة عن حالات الاستخدام، يمكنك الاطّلاع على مقالة ما هي الإجراءات التي يمكنني تنفيذها باستخدام Cloud Functions؟.
تشغيل دالة عند إنشاء مستخدم
يمكنك إنشاء دالة يتم تشغيلها عند إنشاء مستخدم Authentication باستخدام
functions.auth.user().onCreate()
معالج الأحداث:
exports.sendWelcomeEmail = functions.runWith({secrets: [gmailPassword]}).auth.user().onCreate((user) => { // ... });
سيتم تشغيل أحداث إنشاء المستخدمين في Cloud Functions عندما:Authentication
- ينشئ مستخدم حسابًا باستخدام عنوان بريد إلكتروني وكلمة مرور.
- يسجِّل مستخدم الدخول لأول مرة باستخدام موفِّر هوية موحّدة.
- ينشئ المطوّر حسابًا باستخدام حزمة Firebase Admin SDK.
- يسجِّل مستخدم الدخول إلى جلسة مصادقة مجهولة جديدة لأول مرة.
لا يتم تشغيل حدث Cloud Functions في Cloud Functions عندما يسجِّل مستخدم الدخول للمرة الأولى باستخدام رمز مخصّص.
الوصول إلى سمات المستخدم
من بيانات المستخدم التي يتم عرضها على دالتك، يمكنك
الوصول إلى قائمة سمات المستخدم المتوفّرة في عنصر المستخدم الذي تم إنشاؤه حديثًا
UserRecord. على سبيل المثال، يمكنك الحصول على عنوان البريد الإلكتروني للمستخدم واسمه المعروض كما هو موضّح أدناه:
const email = user.email; // The email of the user. const displayName = user.displayName; // The display name of the user.
تشغيل دالة عند حذف مستخدم
تمامًا كما يمكنك تشغيل دالة عند إنشاء مستخدم، يمكنك الاستجابة لأحداث حذف المستخدمين. استخدِم معالج الأحداث
functions.auth.user().onDelete()
كما هو موضّح أدناه:
exports.sendByeEmail = functions.runWith({secrets: [gmailPassword]}).auth.user().onDelete((user) => { // ... });
تشغيل دوال الحظر
إذا كنت قد رقّيت إلى Firebase Authentication with Identity Platform، يمكنك توسيع نطاق Firebase Authentication باستخدام دوال الحظر في Cloud Functions.
تتيح لك دوال الحظر تنفيذ رمز مخصّص يعدِّل نتيجة تسجيل المستخدم أو تسجيل دخوله إلى تطبيقك. على سبيل المثال، يمكنك منع مستخدم من المصادقة إذا لم يستوفِ معايين معيّنة، أو تعديل معلومات المستخدم قبل عرضها على تطبيق العميل.