Firebase 身份驗證觸發器

您可以觸發函數以響應 Firebase 用戶帳戶的創建和刪除。例如，您可以向剛剛在您的應用中創建帳戶的用戶發送一封歡迎電子郵件。此頁面上的示例基於執行此操作的示例——在創建和刪除帳戶時發送歡迎和告別電子郵件。

有關用例的更多示例，請參閱我可以使用 Cloud Functions 做什麼？ .

注意： Cloud Functions for Firebase（第 2 代）不支持本指南中描述的事件和触發器。由於第一代和第二代功能可以在同一個源文件中並存，您仍然可以將此功能與第二代功能一起開發和部署。

在用戶創建時觸發函數

您可以使用functions.auth.user().onCreate()事件處理程序創建一個在創建 Firebase 用戶時觸發的函數：

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.
index.js

觸髮用戶刪除功能

正如您可以在用戶創建時觸發函數一樣，您可以響應用戶刪除事件。使用functions.auth.user().onDelete()事件處理程序，如下所示：

exports.sendByeEmail = functions.auth.user().onDelete((user) => {
  // ...
});

注意：使用 Firebase Admin SDK 一次刪除多個用戶（例如，Node.js 中的admin.auth().deleteUsers([uid1, uid2]) ）不會觸髮用戶刪除事件，因此事件處理程序使用functions.auth.user().onDelete()不會被觸發。如果您希望為每個已刪除的用戶觸髮用戶刪除事件，則一次刪除一個用戶。

觸發攔截功能

如果您已升級到 Firebase Authentication with Identity Platform，則可以使用阻塞式 Cloud Functions擴展 Firebase Authentication。

阻止函數讓您可以執行自定義代碼來修改用戶註冊或登錄到您的應用程序的結果。例如，您可以阻止不滿足特定條件的用戶進行身份驗證，或者在將用戶信息返回到您的客戶端應用程序之前更新用戶信息。