אפשר להפעיל פונקציות בתגובה ליצירה ולמחיקה של 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.
פונקציות חסימה מאפשרות להריץ קוד מותאם אישית שמשנה את התוצאה של רישום משתמש או כניסה של משתמש לאפליקציה. לדוגמה, אפשר למנוע ממשתמש לבצע אימות אם הוא לא עומד בקריטריונים מסוימים, או לעדכן את הפרטים של משתמש לפני שהם מוחזרים לאפליקציית הלקוח.