Trigger di Firebase Authentication
Cloud Functions può essere attivato dagli eventi di Firebase Authentication nello stesso progetto Google Cloud della funzione. Questi eventi includono la creazione e l'eliminazione dell'utente. Ad esempio, potresti inviare un'email di benvenuto a un utente che ha appena creato un account nella tua app.
Tipi di evento
Firebase Authentication può attivare funzioni in risposta agli eventi create
e delete
degli utenti.
Tipo di evento | Trigger |
---|---|
providers/firebase.auth/eventTypes/user.create |
Si attiva quando viene creato un account utente. |
providers/firebase.auth/eventTypes/user.delete |
Si attiva quando viene eliminato un account utente. |
Creazione utente
Gli account Firebase attivano eventi di creazione utenti per Cloud 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 Firebase Admin.
Un utente accede a una nuova sessione di autenticazione anonima per la prima volta.
Eliminazione utente
Puoi anche configurare una funzione da attivare dopo l'eliminazione dell'utente.
Struttura dell'evento
I dati sugli eventi vengono forniti come oggetto UserRecord
.
Di seguito è riportato un esempio di evento di creazione di account basato su password:
{ "email": "me@example.com", "metadata": { "createdAt": "2018-10-19T19:29:16Z" }, "uid": "XXXXX" }
Alcune proprietà di questo oggetto vengono definite solo quando si utilizzano determinati metodi di autenticazione. Ad esempio, gli eventi dell'account basati su password definiscono una proprietà email
contenente l'indirizzo email dell'utente. La proprietà uid
(che contiene un ID utente univoco per il tuo progetto) viene sempre definita.
Codice di esempio
Node.js
Python
Go
Java
C#
Ruby
PHP
Deployment della funzione
Per eseguire il deployment della funzione, devi specificare il tipo di evento e il progetto per cui hai configurato Firebase Auth. Nella console Google Cloud è presente un singolo campo per Tipo di evento, in quanto si presume che il progetto sia uguale al progetto che contiene la funzione.
Nella riga di comando, tuttavia, devi utilizzare stringhe specifiche per specificare questi due parametri. Il seguente comando gcloud
esegue il deployment di una funzione che viene attivata dagli eventi create
dell'utente:
gcloud functions deploy FUNCTION_NAME \ --entry-point ENTRY_POINT \ --trigger-event providers/firebase.auth/eventTypes/user.create \ --trigger-resource YOUR_PROJECT_ID \ --runtime RUNTIME
Argomento | Descrizione |
---|---|
FUNCTION_NAME |
Il nome registrato della Cloud Function di cui stai eseguendo il deployment.
Può essere il nome di una funzione nel codice sorgente o una stringa arbitraria. Se FUNCTION_NAME è una stringa arbitraria, devi includere il flag --entry-point .
|
--entry-point ENTRY_POINT |
Il nome di una funzione o di una classe nel codice sorgente. Facoltativo, a meno che
tu non abbia utilizzato FUNCTION_NAME
per specificare la funzione
nel codice sorgente da eseguire durante il deployment. In questo caso, devi utilizzare --entry-point per fornire il nome della funzione eseguibile.
|
--trigger-event NAME |
Il nome del tipo di evento che attiva la funzione. In questo caso, deve essere di tipo Crea o Elimina, come indicato sopra. |
--trigger-resource NAME |
L'ID del progetto (in questo esempio, YOUR_PROJECT_ID ) che contiene la tua funzione e Firebase Authentication.
|
--runtime RUNTIME |
Il nome del runtime in uso. Per un elenco completo, consulta la documentazione di riferimento di gcloud .
|