Gatilhos de autenticação do Firebase

Você pode acionar funções em resposta à criação e exclusão de contas de usuário do Firebase. Por exemplo, você pode enviar um e-mail de boas-vindas a um usuário que acabou de criar uma conta no seu aplicativo. Os exemplos nesta página são baseados em um exemplo que faz exatamente isso: envia e-mails de boas-vindas e de despedida após a criação e exclusão da conta.

Para ver mais exemplos de casos de uso, consulte O que posso fazer com o Cloud Functions? .

Observação: o Cloud Functions para Firebase (2ª geração) não oferece suporte para os eventos e gatilhos descritos neste guia. Como as funções de 1ª e 2ª geração podem coexistir lado a lado no mesmo arquivo de origem, você ainda pode desenvolver e implantar essa funcionalidade junto com funções de 2ª geração.

Acione uma função na criação do usuário

Você pode criar uma função que é acionada quando um usuário do Firebase é criado usando o manipulador de eventos functions.auth.user().onCreate() :

exports.sendWelcomeEmail = functions.auth.user().onCreate((user) => {
  // ...
});

As contas do Firebase acionarão eventos de criação de usuários para Cloud Functions quando:

• Um usuário cria uma conta de e-mail e uma senha.
• Um usuário entra pela primeira vez usando um provedor de identidade federado.
• O desenvolvedor cria uma conta usando o SDK Admin do Firebase.
• Um usuário entra em uma nova sessão de autenticação anônima pela primeira vez.

Um evento do Cloud Functions não é acionado quando um usuário faz login pela primeira vez usando um token personalizado.

Acessar atributos do usuário

A partir dos dados do usuário retornados para sua função, você pode acessar a lista de atributos do usuário disponíveis no objeto UserRecord do usuário recém-criado. Por exemplo, você pode obter o e-mail e o nome de exibição do usuário conforme mostrado:

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

Acionar uma função na exclusão do usuário

Assim como você pode acionar uma função na criação de um usuário, você pode responder a eventos de exclusão de usuário. Use o manipulador de eventos functions.auth.user().onDelete() conforme mostrado:

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

Cuidado: excluir vários usuários de uma vez usando o SDK Admin do Firebase (por exemplo, admin.auth().deleteUsers([uid1, uid2]) em Node.js) não aciona eventos de exclusão de usuário, portanto, os manipuladores de eventos são configurados usando functions.auth.user().onDelete() não será acionado . Exclua um usuário por vez se desejar que eventos de exclusão de usuário sejam acionados para cada usuário excluído.

Funções de bloqueio de gatilho

Se você tiver atualizado para o Firebase Authentication com Identity Platform, poderá estender o Firebase Authentication usando o bloqueio do Cloud Functions .

As funções de bloqueio permitem executar código personalizado que modifica o resultado do registro ou login de um usuário em seu aplicativo. Por exemplo, você pode impedir que um usuário se autentique se ele não atender a determinados critérios ou atualizar as informações de um usuário antes de devolvê-las ao seu aplicativo cliente.