Déclencheurs d'authentification Firebase

Vous pouvez déclencher Cloud Functions en réponse à la création et à la suppression de comptes utilisateur Firebase. Par exemple, vous pouvez envoyer un e-mail de bienvenue à un utilisateur qui vient de créer un compte dans votre application. Les exemples sur cette page sont basés sur un exemple qui fait exactement cela : envoyer des e-mails de bienvenue et d'adieu lors de la création et de la suppression du compte.

Pour plus d' exemples de cas d'utilisation, voir Que puis - je faire avec les fonctions Cloud?

Déclencher une fonction lors de la création d'un utilisateur

Vous pouvez créer une fonction qui déclenche lorsqu'un utilisateur Firebase est créée en utilisant l' functions.auth.user().onCreate() Gestionnaire d'événements:

exports.sendWelcomeEmail = functions.auth.user().onCreate((user) => {
  // ...
});

Les comptes Firebase déclenchent des événements de création d'utilisateurs pour Cloud Functions lorsque :

  • Un utilisateur crée un compte de messagerie et un mot de passe.
  • Un utilisateur se connecte pour la première fois à l'aide d'un fournisseur d'identité fédéré.
  • Le développeur crée un compte à l'aide du SDK Firebase Admin.
  • Un utilisateur se connecte à une nouvelle session d'authentification anonyme pour la première fois.

Un événement Fonctions Cloud ne se déclenche pas lorsqu'un utilisateur se connecte pour la première fois en utilisant un jeton personnalisé.

Accéder aux attributs utilisateur

A partir des données de l' utilisateur sont retournés à votre fonction, vous pouvez accéder à la liste des attributs de l' utilisateur disponible dans l'utilisateur nouvellement créé UserRecord l'objet. Par exemple, vous pouvez obtenir l'adresse e-mail et le nom d'affichage de l'utilisateur comme indiqué :

const email = user.email; // The email of the user.
const displayName = user.displayName; // The display name of the user.

Déclencher une fonction lors de la suppression d'un utilisateur

Tout comme vous pouvez déclencher une fonction lors de la création d'un utilisateur, vous pouvez répondre aux événements de suppression d'utilisateur. Utilisez la functions.auth.user().onDelete() Gestionnaire d'événements comme indiqué:

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