您可以根據 Firebase 使用者帳戶的建立和刪除作業,觸發對應的函式。舉例來說,您可以向剛在應用程式中建立帳戶的使用者傳送歡迎電子郵件。本頁的範例正是以這類範例為基礎,在建立和刪除帳戶時傳送歡迎和告別電子郵件。
如需更多用途範例,請參閱「Cloud Functions 有哪些用途?」。
在建立使用者時觸發函式
您可以建立函式,在使用 functions.auth.user().onCreate()
事件處理常式建立 Firebase 使用者時觸發:
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,可以使用封鎖 Cloud Functions 來延伸 Firebase Authentication。
封鎖函式可讓您執行自訂程式碼,藉此修改使用者註冊或登入應用程式的結果。舉例來說,您可以防止使用者在未符合特定條件時進行驗證,或是在將使用者資訊傳回至用戶端應用程式前更新該資訊。