Firebase Authentication-Trigger

Sie können Funktionen als Reaktion auf das Erstellen und Löschen von Firebase-Nutzerkonten auslösen. Sie haben beispielsweise die Möglichkeit, eine Begrüßungs-E-Mail an einen Nutzer zu senden, der gerade ein Konto in Ihrer Anwendung erstellt hat. Die Beispiele auf dieser Seite basieren auf einem Beispiel für genau diesen Anwendungsfall: das Versenden von Begrüßungs- und Abschieds-E-Mails beim Erstellen und Löschen von Konten.

Weitere Anwendungsbeispiele finden Sie unter Was kann ich mit Cloud Functions tun?.

Hinweis: Cloud Functions for Firebase (2. Generation) unterstützt die in diesem Leitfaden beschriebenen Ereignisse und Trigger nicht. Da Funktionen der 1. Generation und der 2. Generation in derselben Quelldatei nebeneinander existieren können, können Sie diese Funktion weiterhin zusammen mit Funktionen der 2. Generation entwickeln und bereitstellen.

Funktion beim Erstellen eines Nutzers auslösen

Sie können eine Funktion erstellen, die ausgelöst wird, wenn ein Firebase-Nutzer mit dem Event-Handler functions.auth.user().onCreate() erstellt wird:

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

Firebase-Konten lösen in den folgenden Fällen Nutzererstellungsereignisse für Cloud Functions aus:

• Ein Nutzer erstellt ein E-Mail-Konto und ein Passwort
• Ein Nutzer meldet sich zum ersten Mal über einen Anbieter föderierter Identitäten an.
• Der Entwickler erstellt mithilfe des Admin SDK ein Konto.
• Ein Nutzer meldet sich zum ersten Mal bei einer neuen anonymen Authentifizierungssitzung an

Ein Cloud Functions-Ereignis wird nicht ausgelöst, wenn sich ein Nutzer zum ersten Mal über ein benutzerdefiniertes Token anmeldet.

Auf Nutzerattribute zugreifen

Über die Nutzerdaten, die an die Funktion zurückgegeben werden, können Sie auf die Liste der Nutzerattribute zugreifen, die im Objekt UserRecord des neu erstellten Nutzers verfügbar sind. So können Sie beispielsweise die E-Mail-Adresse und den Anzeigenamen des Nutzers abrufen:

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

Funktion beim Löschen eines Nutzers auslösen

So wie sich eine Funktion beim Erstellen von Nutzern auslösen lässt, können Sie auf Ereignisse beim Löschen von Nutzern reagieren. Verwenden Sie dazu den Ereignis-Handler functions.auth.user().onDelete(), wie hier gezeigt:

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

Achtung: Wenn Sie mehrere Nutzer gleichzeitig mit dem Firebase Admin SDK löschen (z. B. admin.auth().deleteUsers([uid1, uid2]) in Node.js), werden keine Ereignisse zum Löschen von Nutzern ausgelöst. Ereignishandler, die mit functions.auth.user().onDelete() eingerichtet wurden, werden also nicht ausgelöst. Löschen Sie einzelne Nutzer, wenn diese für jeden gelöschten Nutzer ausgelöst werden sollen.

Blockierfunktionen auslösen

Wenn Sie ein Upgrade auf Firebase Authentication with Identity Platform durchgeführt haben, können Sie Firebase Authentication durch Cloud Functions blockieren verlängern.

Mit Blockierfunktionen können Sie benutzerdefinierten Code ausführen, der das Ergebnis einer Nutzerregistrierung oder Anmeldung bei Ihrer Anwendung ändert. Sie können beispielsweise verhindern, dass ein Nutzer sich authentifizieren kann, wenn er bestimmte Kriterien nicht erfüllt, oder seine Informationen aktualisieren, bevor sie an die Clientanwendung zurückgegeben werden.