Estendi l'autenticazione Firebase con le funzioni cloud

Puoi attivare funzioni in risposta alla creazione e all'eliminazione degli account utente Firebase. Ad esempio, potresti inviare un'e-mail 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 ulteriori esempi di casi d'uso, consulta Cosa posso fare con Cloud Functions? .

Nota: Cloud Functions for Firebase (2ª generazione) non fornisce supporto per gli eventi e i trigger descritti in questa guida. Poiché le funzioni di prima e seconda generazione possono coesistere fianco a fianco nello stesso file di origine, puoi comunque sviluppare e distribuire questa funzionalità insieme alle funzioni di seconda generazione.

Attiva 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 eventi di creazione utente per Cloud Functions quando:

• Un utente crea un account e-mail e una password.
• Un utente accede per la prima volta utilizzando un provider di identità federato.
• Lo sviluppatore crea un account utilizzando Firebase 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 accede per la prima volta utilizzando un token personalizzato.

Accedi 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'e-mail dell'utente e il nome visualizzato come mostrato:

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

Attiva una funzione sulla cancellazione dell'utente

Proprio come puoi attivare una funzione al momento della creazione dell'utente, puoi rispondere agli eventi di eliminazione dell'utente. Utilizza il gestore functions.auth.user().onDelete() come mostrato:

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

Attenzione: l'eliminazione di più utenti contemporaneamente utilizzando Firebase Admin SDK (ad esempio, admin.auth().deleteUsers([uid1, uid2]) in Node.js) non attiva eventi di eliminazione degli utenti, quindi i gestori eventi vengono configurati utilizzando functions.auth.user().onDelete() non verrà attivato . Elimina gli utenti uno alla volta se desideri che gli eventi di eliminazione utente vengano attivati ​​per ciascun utente eliminato.

Attivare le funzioni di blocco

Se hai eseguito l'upgrade a Firebase Authentication con 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 all'app client.