Aktywatory uwierzytelniania Firebase

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?.

Uwaga: usługa Cloud Functions dla Firebase (2 generacji) nie obsługuje zdarzeń ani aktywatorów opisanych w tym przewodniku. Funkcje 1 generacji i 2 generacji mogą współistnieć obok siebie w tym samym pliku źródłowym, więc nadal możesz programować i wdrażać te funkcje razem z funkcjami 2 generacji.

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 wywołują zdarzenia tworzenia użytkowników w Cloud Functions, gdy:

• Użytkownik tworzy konto e-mail i hasło.
• Użytkownik loguje się po raz pierwszy przy użyciu dostawcy tożsamości sfederowanego.
• Programista tworzy konto za pomocą pakietu Firebase Admin SDK.
• Użytkownik po raz pierwszy loguje się w nowej anonimowej sesji uwierzytelniania.

Zdarzenie Cloud Functions nie jest wywoływane, gdy użytkownik zaloguje się po raz pierwszy przy użyciu tokena niestandardowego.

Dostęp do atrybutów użytkownika

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

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

Aktywowanie funkcji przy usuwaniu użytkownika

Tak samo jak możesz aktywować funkcję podczas tworzenia konta użytkownika, możesz odpowiadać na zdarzenia usunięcia użytkownika. Użyj modułu obsługi zdarzeń functions.auth.user().onDelete() w następujący sposób:

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

Uwaga: usunięcie wielu użytkowników naraz za pomocą pakietu Firebase Admin SDK (np. admin.auth().deleteUsers([uid1, uid2]) w Node.js) nie powoduje wywołania zdarzeń usuwania użytkowników, więc moduły obsługi zdarzeń skonfigurowane za pomocą functions.auth.user().onDelete() nie będą wywoływane. Usuwaj konta użytkowników pojedynczo, jeśli chcesz, aby zdarzenia usuwania kont użytkowników były uruchamiane w przypadku każdego usuniętego konta użytkownika.

Aktywowanie funkcji blokujących

Po przejściu na Uwierzytelnianie Firebase z Identity Platform możesz przedłużyć działanie uwierzytelniania Firebase, blokując 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.