Como personalizar o fluxo de autenticação usando funções assíncronas
Este documento mostra como estender a autenticação do Identity Platform usando funções assíncronas do Cloud Run.
Funções assíncronas permitem que você acione tarefas sem bloqueio em resposta à criação e exclusão de usuários. Eles são úteis para iniciar operações de longa duração ou executar tarefas auxiliares, como enviar um e-mail de boas-vindas.
Para modificar diretamente o resultado de uma operação de autenticação, consulte Como estender a autenticação com funções de bloqueio. O objeto do usuário que uma função assíncrona recebe não contém atualizações da função de bloqueio.
Antes de começar
Crie um app com o Identity Platform. Consulte o Guia de início rápido para saber como.
Como criar uma função assíncrona
Para criar e implantar uma função assíncrona, siga as etapas em Primeiros passos: gravar, testar e implantar suas primeiras funções.
Como responder à criação de usuários
O evento onCreate
é acionado sempre que uma conta de usuário é criada. Isso inclui
sessões anônimas e contas criadas com o SDK Admin. A função
não é acionada quando um usuário faz login pela primeira vez usando um token personalizado.
O exemplo a seguir mostra como registrar um gerenciador para onCreate
.
Node.js
exports.myFunction = functions.auth.user().onCreate((user) => {
// TODO.
});
Como responder à exclusão de um usuário
O evento onDelete
é acionado sempre que uma conta de usuário é excluída. O exemplo
a seguir mostra como registrar um gerenciador para onDelete
.
Node.js
exports.myFunction = functions.auth.user().onDelete((user) => {
// TODO.
});
Como acessar informações do usuário
Os eventos onCreate
e onDelete
fornecem objetos User
e EventContext
que contêm informações sobre o usuário criado ou excluído. Exemplo:
Node.js
exports.myFunction = functions.auth.user().onCreate((user, context) => {
const email = user.email; // The email of the user.
const displayName = user.displayName; // The display name of the user.
});
Consulte a
referência da API UserRecord
e a
referência da API EventContext
para uma lista de campos disponíveis.
A seguir
- Estender a autenticação com funções de bloqueio.
- Saiba mais sobre as funções do Cloud Run.