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 accomplir avec Cloud Functions ?.
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.
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) => {
// ...
});
Déclencher des fonctions de blocage
Si vous êtes passé à Firebase Authentication with Identity Platform, vous pouvez étendre Firebase Authentication à l'aide d'un Cloud Functions bloquant.
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.