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