Вы можете запускать функции в ответ на создание и удаление учетных записей пользователей 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 .
Блокирующие функции позволяют вам выполнять пользовательский код, который изменяет результат регистрации или входа пользователя в ваше приложение. Например, вы можете запретить пользователю проходить аутентификацию, если он не соответствует определенным критериям, или обновить информацию о пользователе перед ее возвратом в ваше клиентское приложение.