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