Puoi attivare funzioni in risposta alla creazione e all'eliminazione di account utente Firebase. 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 si basano su un campione che fa esattamente questo: invia email di benvenuto e di addio al momento della creazione ed eliminazione dell'account.
Per altri esempi di casi d'uso, vedi Cosa posso fare con Cloud Functions?.
Attivare una funzione alla creazione dell'utente
Puoi creare una funzione che viene attivata 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 eventi di creazione utente per Cloud Functions quando:
- Un utente crea un account email e una password.
- Un utente esegue l'accesso per la prima volta utilizzando un provider di identità federato.
- Lo sviluppatore crea un account utilizzando l'Admin SDK.
- Un utente accede per la prima volta a una nuova sessione di autenticazione anonima.
Un evento Cloud Functions non viene attivato quando un utente esegue l'accesso per la prima volta utilizzando un token personalizzato.
Accedere agli attributi utente
Dai dati utente restituiti alla tua funzione, puoi
accedere all'elenco degli 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 dell'utente
Proprio come puoi attivare una funzione alla creazione di un utente, puoi
rispondere agli eventi di eliminazione dell'utente. Utilizza il
gestore di eventi functions.auth.user().onDelete()
come mostrato:
exports.sendByeEmail = functions.auth.user().onDelete((user) => { // ... });
Funzioni di blocco dei trigger
Se hai eseguito l'upgrade a Firebase Authentication with Identity Platform, puoi estendere Firebase Authentication utilizzando il blocco 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 l'autenticazione di un utente se non soddisfa determinati criteri o aggiornare le informazioni di un utente prima di restituirle all'app client.