Déclencheurs Firebase Authentication

Vous pouvez déclencher des fonctions en réponse à la création et à la suppression Firebase comptes utilisateur. 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 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. Comme les appareils 1re et 2e génération fonctions peuvent coexister côte à côte dans le même fichier source, vous pouvez toujours développer et déployer cette fonctionnalité en association avec des 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 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 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 à à 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 simultanée de plusieurs utilisateurs à 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. Supprimer les utilisateurs un à une heure si vous souhaitez que les événements de suppression de comptes utilisateur se déclenchent pour chaque compte utilisateur supprimé.

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.