Puoi attivare le funzioni in risposta alla creazione e all'eliminazione di account utenteFirebase. Ad esempio, potresti inviare un'email di benvenuto a un utente che ha appena creato un account nella tua app. Gli esempi in questa pagina sono basati su un esempio che esegue proprio questa operazione: invia email di benvenuto e di addio al momento della creazione e dell'eliminazione dell'account.
Per altri esempi di casi d'uso, vedi Cosa posso fare con Cloud Functions?.
Attiva una funzione alla creazione di un utente
Puoi creare una funzione che si attiva quando viene creato un utente Firebase utilizzando il gestore di eventi functions.auth.user().onCreate()
:
exports.sendWelcomeEmail = functions.auth.user().onCreate((user) => { // ... });
Gli account Firebase attiveranno gli eventi di creazione utente perCloud Functions quando:
- Un utente crea un account email e una password.
- Un utente accede per la prima volta utilizzando un provider di identità federato.
- Lo sviluppatore crea un account utilizzando l'SDK Admin.
- Un utente accede per la prima volta a una nuova sessione di autenticazione anonima.
Un evento Cloud Functions non viene attivato quando un utente accede per la prima volta utilizzando un token personalizzato.
Accedere agli attributi utente
Dai dati utente restituiti alla tua funzione, puoi accedere all'elenco di attributi utente disponibili nell'oggetto UserRecord
dell'utente appena creato. Ad esempio, puoi ottenere l'email e il nome visualizzato dell'utente come mostrato di seguito:
const email = user.email; // The email of the user. const displayName = user.displayName; // The display name of the user.
Attivare una funzione all'eliminazione di un utente
Proprio come puoi attivare una funzione alla creazione di un utente, puoi rispondere agli eventi di eliminazione degli utenti. Utilizza il gestore di eventi functions.auth.user().onDelete()
come mostrato di seguito:
exports.sendByeEmail = functions.auth.user().onDelete((user) => { // ... });
Attivare le funzioni di blocco
Se hai eseguito l'upgrade a Firebase Authentication with Identity Platform, puoi estendere Firebase Authentication utilizzando il blocco di Cloud Functions.
Le funzioni di blocco ti consentono di eseguire codice personalizzato che modifica il risultato della registrazione o dell'accesso di un utente alla tua app. Ad esempio, puoi impedire a un utente di autenticarsi se non soddisfa determinati criteri o aggiornare le informazioni di un utente prima di restituirle alla tua app client.