אפשר להפעיל פונקציות בתגובה ליצירה ולמחיקה של Firebase חשבונות משתמשים. לדוגמה, תוכלו לשלוח הודעת אימייל של קבלת פנים למשתמש שזה עתה יצר חשבון באפליקציה. הדוגמאות בדף הזה מבוססות על דוגמה שמבצעת בדיוק את הפעולה הזו – שולחת הודעות אימייל של קבלת פנים ושל פרידה בזמן יצירת החשבון ובזמן המחיקה שלו.
דוגמאות נוספות של תרחישים לדוגמה זמינות בכתובת מה אפשר לעשות עם Cloud Functions?.
הפעלת פונקציה בזמן יצירת משתמש
אפשר ליצור פונקציה שמופעלת כשמשתמש של 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.
הפעלת פונקציה במחיקת משתמש
בדיוק כמו שאפשר להפעיל פונקציה ביצירת משתמשים, אפשר
להגיב לאירועי מחיקה של משתמשים. משתמשים בגורם שמטפל באירועים functions.auth.user().onDelete() כפי שמוצג:
exports.sendByeEmail = functions.auth.user().onDelete((user) => { // ... });
הפעלת פונקציות חסימה
אם שדרגתם ל-Firebase Authentication with Identity Platform, תוכלו להאריך את Firebase Authentication באמצעות חסימת Cloud Functions.
פונקציות חסימה מאפשרות להריץ קוד מותאם אישית שמשנה את התוצאה של רישום משתמש או כניסה של משתמש לאפליקציה. לדוגמה, אפשר למנוע ממשתמש לבצע אימות אם הוא לא עומד בקריטריונים מסוימים, או לעדכן את פרטי המשתמש לפני שהם מוחזרים לאפליקציית הלקוח.