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