Trigger di Firebase Authentication

Puoi attivare le funzioni in risposta alla creazione e all'eliminazione di Firebase account utente. Ad esempio, puoi inviare un'email di benvenuto a un utente che ha appena creato un account nella tua app. Gli esempi in questa pagina sono basato su un campione che funziona esattamente come questo: invia email di benvenuto e di addio al momento della creazione e dell'eliminazione dell'account.

Per altri esempi di casi d'uso, vedi Che cosa posso fare con Cloud Functions?.

Nota: Cloud Functions for Firebase (2ª gen.) non supporta gli eventi e gli attivatori descritti in questa guida. Poiché le versioni di 1a e 2a gen. possono coesistere fianco a fianco nello stesso file sorgente, sviluppare ed eseguire il deployment di questa funzionalità insieme alle funzioni di 2a generazione.

Attivare una funzione alla creazione dell'utente

Puoi creare una funzione che si attiva quando viene creato un utente Firebase utilizzando il gestore 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 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 all'evento la prima volta con un token personalizzato.

Accedi agli attributi utente

Dai dati utente restituiti alla tua funzione, puoi accedere all'elenco di attributi disponibili nel campo UserRecord . 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.
index.js

Attiva una funzione all'eliminazione di un utente

Così come puoi attivare una funzione per la creazione di utenti, Rispondere agli eventi di eliminazione degli utenti. Utilizza il gestore di eventi functions.auth.user().onDelete() come mostrato:

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

Attenzione: l'eliminazione di più utenti contemporaneamente utilizzando l'SDK Firebase Admin (ad es. admin.auth().deleteUsers([uid1, uid2]) in Node.js) non attiva gli eventi di eliminazione degli utenti, pertanto i gestori degli eventi configurati utilizzando functions.auth.user().onDelete() non verranno attivati. Elimina gli utenti uno alla volta se vuoi che gli eventi di eliminazione degli utenti vengano attivati per ogni utente eliminato.

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 utente che si registra o accede alla tua app. Ad esempio, puoi impedire a un utente dall'autenticazione se non soddisfano determinati criteri o aggiornano le informazioni prima di restituirle all'app client.