Erweitern Sie die Firebase-Authentifizierung mit Cloud-Funktionen

Sie können Funktionen als Reaktion auf das Erstellen und Löschen von Firebase-Benutzerkonten auslösen. Sie könnten beispielsweise eine Willkommens-E-Mail an einen Benutzer senden, der gerade ein Konto in Ihrer App erstellt hat. Die Beispiele auf dieser Seite basieren auf einem Beispiel, das genau dies tut: Begrüßungs- und Abschieds-E-Mails beim Erstellen und Löschen eines Kontos senden.

Weitere Beispiele für Anwendungsfälle finden Sie unter Was kann ich mit Cloud Functions tun? .

Hinweis: Cloud Functions für Firebase (2. Generation) bietet keine Unterstützung für die in diesem Handbuch beschriebenen Ereignisse und Auslöser. Da Funktionen der 1. und 2. Generation nebeneinander in derselben Quelldatei vorhanden sein können, können Sie diese Funktionalität weiterhin zusammen mit Funktionen der 2. Generation entwickeln und bereitstellen.

Lösen Sie eine Funktion bei der Benutzererstellung aus

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

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

Firebase-Konten lösen Benutzererstellungsereignisse für Cloud Functions aus, wenn:

• Ein Benutzer erstellt ein E-Mail-Konto und ein Passwort.
• Ein Benutzer meldet sich zum ersten Mal mit einem föderierten Identitätsanbieter an.
• Der Entwickler erstellt ein Konto mit dem Firebase Admin SDK.
• Ein Benutzer meldet sich zum ersten Mal bei einer neuen anonymen Authentifizierungssitzung an.

Ein Cloud Functions-Ereignis wird nicht ausgelöst, wenn sich ein Benutzer zum ersten Mal mit einem benutzerdefinierten Token anmeldet.

Greifen Sie auf Benutzerattribute zu

Über die an Ihre Funktion zurückgegebenen Benutzerdaten können Sie auf die Liste der Benutzerattribute zugreifen, die im UserRecord Objekt des neu erstellten Benutzers verfügbar sind. Sie können beispielsweise die E-Mail-Adresse und den Anzeigenamen des Benutzers wie folgt abrufen:

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

Lösen Sie beim Löschen des Benutzers eine Funktion aus

So wie Sie bei der Benutzererstellung eine Funktion auslösen können, können Sie auf Benutzerlöschereignisse reagieren. Verwenden Sie den Event-Handler functions.auth.user().onDelete() wie gezeigt:

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

Achtung: Das gleichzeitige Löschen mehrerer Benutzer mithilfe des Firebase Admin SDK (z. B. admin.auth().deleteUsers([uid1, uid2]) in Node.js) löst keine Benutzerlöschereignisse aus, daher werden Ereignishandler mithilfe von functions.auth.user().onDelete() wird nicht ausgelöst . Löschen Sie Benutzer einzeln, wenn Sie möchten, dass Benutzerlöschereignisse für jeden gelöschten Benutzer ausgelöst werden.

Sperrfunktionen auslösen

Wenn Sie mit Identity Platform auf Firebase Authentication aktualisiert haben, können Sie Firebase Authentication mithilfe blockierender Cloud Functions erweitern.

Mit Blockierungsfunktionen können Sie benutzerdefinierten Code ausführen, der das Ergebnis der Registrierung oder Anmeldung eines Benutzers bei Ihrer App ändert. Sie können beispielsweise verhindern, dass sich ein Benutzer authentifiziert, wenn er bestimmte Kriterien nicht erfüllt, oder die Informationen eines Benutzers aktualisieren, bevor Sie sie an Ihre Client-App zurückgeben.