Możesz aktywować funkcje w odpowiedzi na utworzenie lub usunięcie kont użytkowników Firebase. Na przykład możesz wysłać e-maila powitalnego do użytkownika, który właśnie utworzył konto w Twojej aplikacji. Przykłady na tej stronie oparte są na przykładzie, który ma pomóc w osiągnięciu tego celu – po utworzeniu lub usunięciu konta wysyłane są e-maile powitalne i pożegnalne.
Więcej przykładów zastosowań znajdziesz w artykule Co mogę zrobić przy użyciu Cloud Functions?.
Aktywowanie funkcji podczas tworzenia użytkownika
Możesz utworzyć funkcję, która uruchamia się po utworzeniu użytkownika Firebase za pomocą modułu obsługi zdarzeń functions.auth.user().onCreate():
exports.sendWelcomeEmail = functions.auth.user().onCreate((user) => { // ... });
Konta Firebase będą wywoływać zdarzenia dotyczące tworzenia użytkowników w przypadku kont Cloud Functions, gdy:
- Użytkownik tworzy konto e-mail i hasło.
- Użytkownik loguje się po raz pierwszy za pomocą dostawcy tożsamości sfederowanej.
- Deweloperzy tworzą konto za pomocą pakietu SDK Admin.
- Użytkownik po raz pierwszy loguje się w nowej sesji uwierzytelniania anonimowego.
Zdarzenie Cloud Functions nie jest wywoływane, gdy użytkownik loguje się po raz pierwszy przy użyciu tokena niestandardowego.
Dostęp do atrybutów użytkownika
Na podstawie danych użytkownika zwróconych do funkcji możesz uzyskać dostęp do listy atrybutów użytkownika dostępnych w nowo utworzonym obiekcie UserRecord. Możesz na przykład uzyskać adres e-mail i nazwę wyświetlaną użytkownika w taki sposób:
const email = user.email; // The email of the user. const displayName = user.displayName; // The display name of the user.
Uruchamianie funkcji po usunięciu użytkownika
Podobnie jak możesz wywołać funkcję podczas tworzenia użytkownika, możesz też reagować na zdarzenia usuwania użytkowników. Użyj modułu obsługi zdarzeń functions.auth.user().onDelete() w następujący sposób:
exports.sendByeEmail = functions.auth.user().onDelete((user) => { // ... });
Funkcja blokowania
Jeśli korzystasz z usługi Firebase Authentication with Identity Platform, możesz przedłużyć czas Firebase Authentication, blokując subskrypcję Cloud Functions.
Funkcje blokowania umożliwiają uruchamianie niestandardowego kodu, który zmienia wynik rejestracji lub logowania się użytkownika w aplikacji. Możesz na przykład uniemożliwić użytkownikowi uwierzytelnianie, jeśli nie spełnia określonych kryteriów, lub zaktualizować informacje o użytkowniku przed zwróceniem go do aplikacji klienckiej.