Déclencheurs Firebase Authentication

Vous pouvez déclencher des fonctions 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 figurant sur cette page sont basés sur un exemple qui effectue cette opération. Cette fonction envoie des e-mails de bienvenue et de d'au revoir lors de la création et de la suppression de comptes.

Pour plus d'exemples de cas d'utilisation, consultez la section Que puis-je faire avec Cloud Functions ?.

Remarque : Cloud Functions for Firebase (2e génération) n'est pas compatible avec les événements et déclencheurs décrits dans ce guide. Étant donné que les fonctions de 1re et de 2e génération peuvent coexister dans le même fichier source, vous pouvez toujours développer et déployer cette fonctionnalité avec les fonctions de 2e génération.

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

Vous pouvez créer une fonction qui se déclenche lorsqu'un utilisateur Firebase est créé à l'aide du gestionnaire d'événements functions.auth.user().onCreate():

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

Les comptes Firebase déclenchent des événements de création d'utilisateurs pour Cloud Functions dans les cas suivants :

• 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 Admin.
• Un utilisateur se connecte à une nouvelle session d'authentification anonyme pour la première fois.

Un événement Cloud Functions n'est pas déclenché lorsqu'un utilisateur se connecte pour la première fois à l'aide d'un jeton personnalisé.

Accéder aux attributs utilisateur

À partir des données utilisateur renvoyées à votre fonction, vous pouvez accéder à la liste des attributs utilisateur disponibles dans l'objet UserRecord de l'utilisateur nouvellement créé. Par exemple, vous pouvez obtenir l'adresse e-mail et le nom à afficher de l'utilisateur comme suit :

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

Déclencher une fonction à 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 le gestionnaire d'événements functions.auth.user().onDelete() comme indiqué ci-dessous :

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

Attention :La suppression de plusieurs utilisateurs à la fois à l'aide du SDK Admin Firebase (par exemple, admin.auth().deleteUsers([uid1, uid2]) dans Node.js) ne déclenche pas d'événements de suppression d'utilisateurs. Par conséquent, les gestionnaires d'événements configurés à l'aide de functions.auth.user().onDelete() ne seront pas déclenchés. Supprimez les utilisateurs un par un si vous souhaitez que des événements de suppression d'utilisateurs se déclenchent pour chaque utilisateur supprimé.

Déclencher des fonctions de blocage

Si vous êtes passé à Firebase Authentication with Identity Platform, vous pouvez étendre Firebase Authentication à l'aide du blocage de Cloud Functions.

Les fonctions de blocage vous permettent d'exécuter un code personnalisé qui modifie le résultat d'un utilisateur qui s'enregistre ou se connecte à votre application. Par exemple, vous pouvez empêcher un utilisateur de s'authentifier s'il ne répond pas à certains critères ou mettre à jour les informations d'un utilisateur avant de le renvoyer à votre application cliente.