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?.
Funktion beim Erstellen eines Nutzers auslösen
Sie können eine Funktion erstellen, die ausgelöst wird, wenn ein Firebase-Nutzer mit dem Ereignis-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.
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) => {
// ...
});
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.