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