Trigger di Firebase Authentication
L'attivazione di Cloud Functions può avvenire da eventi di Firebase Authentication nello stesso progetto Google Cloud della funzione. Questi eventi includono la creazione e l'eliminazione di utenti. 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 le funzioni in risposta agli eventi utente create
e delete
.
Tipo di evento | Attivatore |
---|---|
providers/firebase.auth/eventTypes/user.create |
Si attiva quando viene creato un account utente. |
providers/firebase.auth/eventTypes/user.delete |
Si attiva quando un account utente viene eliminato. |
Creazione utente
Gli account Firebase attivano eventi di creazione utente 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 al momento dell'eliminazione dell'utente.
Struttura di eventi
I dati sugli eventi vengono forniti come oggetto UserRecord
.
Di seguito è riportato un evento di creazione di account basato su password di esempio:
{ "email": "me@example.com", "metadata": { "createdAt": "2018-10-19T19:29:16Z" }, "uid": "XXXXX" }
Alcune proprietà di questo oggetto sono definite solo quando si utilizzano determinati metodi di autenticazione. Ad esempio, gli eventi degli 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) è sempre definita.
Codice di esempio
Node.js
Python
Go
Java
C#
Ruby
PHP
Deployment della funzione in corso...
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 lo stesso del progetto che contiene la tua 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 classe nel tuo codice sorgente. Facoltativo, a meno che non utilizzi 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 create o delete, come indicato sopra. |
--trigger-resource NAME |
L'ID progetto (in questo esempio, YOUR_PROJECT_ID ) del progetto che contiene la funzione e l'autenticazione Firebase.
|
--runtime RUNTIME |
Il nome del runtime che stai utilizzando. Per un elenco completo, consulta il
riferimento gcloud .
|