Trigger di Firebase Authentication

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 si basano su un sample che fa esattamente 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 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 funzioni di 1ª e 2ª generazione possono coesistere nello stesso file di origine, puoi comunque sviluppare e implementare questa funzionalità insieme alle funzioni di 2ª 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 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 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.
index.js

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:

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

Attenzione: l'eliminazione di più utenti contemporaneamente utilizzando l'SDK Firebase Admin (ad esempio 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.

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