Wyzwalacze uwierzytelniania Firebase

Możesz uruchamiać funkcje w odpowiedzi na tworzenie i usuwanie kont użytkowników Firebase. Możesz na przykład wysłać wiadomość powitalną do użytkownika, który właśnie utworzył konto w Twojej aplikacji. Przykłady na tej stronie opierają się na przykładzie, który dokładnie to robi — wysyła wiadomości powitalne i pożegnalne po utworzeniu i usunięciu konta.

Więcej przykładów zastosowań znajdziesz w artykule Co mogę zrobić z Cloud Functions? .

Uwaga: Cloud Functions dla Firebase (2. generacji) nie obsługuje zdarzeń i wyzwalaczy opisanych w tym przewodniku. Ponieważ funkcje pierwszej i drugiej generacji mogą współistnieć obok siebie w tym samym pliku źródłowym, nadal można rozwijać i wdrażać tę funkcjonalność razem z funkcjami drugiej generacji.

Wywołaj funkcję podczas tworzenia użytkownika

Możesz utworzyć funkcję, która będzie uruchamiana po utworzeniu użytkownika Firebase za pomocą procedury obsługi zdarzeńfunctions.auth.user functions.auth.user().onCreate() :

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

Konta Firebase będą wyzwalać zdarzenia tworzenia użytkowników dla Cloud Functions, gdy:

• Użytkownik tworzy konto e-mail i hasło.
• Użytkownik loguje się po raz pierwszy przy użyciu federacyjnego dostawcy tożsamości.
• Deweloper tworzy konto przy użyciu pakietu Firebase Admin SDK.
• Użytkownik po raz pierwszy loguje się do nowej sesji uwierzytelniania anonimowego.

Zdarzenie Cloud Functions nie jest wyzwalane, gdy użytkownik loguje się po raz pierwszy przy użyciu tokena niestandardowego.

Dostęp do atrybutów użytkownika

Z danych użytkownika zwróconych do Twojej funkcji możesz uzyskać dostęp do listy atrybutów użytkownika dostępnych w obiekcie UserRecord nowo utworzonego użytkownika. Na przykład możesz uzyskać adres e-mail użytkownika i nazwę wyświetlaną, jak pokazano:

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

Wywołaj funkcję po usunięciu użytkownika

Podobnie jak możesz uruchomić funkcję podczas tworzenia użytkownika, możesz reagować na zdarzenia usunięcia użytkownika. Użyj procedury obsługi zdarzeńfunctions.auth.user functions.auth.user().onDelete() , jak pokazano:

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

Uwaga: jednoczesne usunięcie wielu użytkowników za pomocą pakietu Firebase Admin SDK (na przykład admin.auth().deleteUsers([uid1, uid2]) w Node.js) nie powoduje uruchomienia zdarzeń usunięcia użytkownika, dlatego procedury obsługi zdarzeń konfiguruje się przy użyciu functions.auth.user().onDelete() nie zostanie wywołane . Usuń użytkowników pojedynczo, jeśli chcesz, aby zdarzenia usunięcia użytkownika były uruchamiane dla każdego usuniętego użytkownika.

Funkcje blokowania wyzwalania

Jeśli dokonałeś aktualizacji do uwierzytelniania Firebase z platformą tożsamości, możesz rozszerzyć uwierzytelnianie Firebase za pomocą blokowania Cloud Functions .

Funkcje blokujące umożliwiają wykonanie niestandardowego kodu, który modyfikuje wynik rejestracji lub logowania użytkownika do Twojej aplikacji. Można na przykład uniemożliwić użytkownikowi uwierzytelnianie, jeśli nie spełnia on określonych kryteriów, lub zaktualizować informacje o użytkowniku przed zwróceniem ich do aplikacji klienckiej.