Usar um domínio personalizado para e-mails de autenticação

Se você usa um domínio personalizado no seu projeto, considere também usá-lo nos e-mails enviados para eventos de autenticação, como alteração de endereço, fluxos de recuperação de senha e verificação do e-mail. É possível configurar seu projeto para usar o domínio personalizado no campo From e nos links de ação dos e-mails.

Se você configurar domínios personalizados para e-mails de autenticação, os usuários verão o mesmo domínio no seu endereço da Web e nos e-mails de gerenciamento de usuários.

Há duas etapas para configurar isso:

  • Adicione o domínio aos seus modelos de e-mail no Console do Firebase.
  • Verifique seu domínio adicionando registros DNS ao registrador dele.

Como adicionar o domínio aos seus modelos de e-mail

  1. No console do Firebase, abra a página Modelos da seção Authentication.

  2. Para cada modelo de e-mail, faça o seguinte:

    1. Clique no ícone de edição ().
    2. Selecione Personalizar domínio.
    3. Insira o domínio que você quer usar.

Você verá uma tabela de registros DNS que podem ser adicionados ao registrador do domínio para confirmar que você tem a propriedade dele.

Verificar o domínio

Adicione ou atualize os registros DNS TXT e CNAME fornecidos no Console do Firebase. O procedimento para fazer isso depende do registrador.

Você pode ter apenas um registro TXT v=spf1... em um domínio. Se você precisa especificar vários endereços de e-mail, combine-os em um único registro.

Pode levar até 24 horas para que o domínio seja verificado. Depois disso, a mensagem "Verificação concluída" em verde será exibida na página "Modelos" no Console do Firebase. Em seguida, clique no botão Aplicar domínio personalizado para ativar suas mudanças imediatamente.

Projetos multilocatário

Se você fez upgrade para o Firebase Authentication with Identity Platform e ativou a multilocação, será necessário atualizar os metadados do locatário para permitir que ele herde domínios personalizados, modelos de e-mail e configurações de SMTP personalizadas. Caso contrário, os usuários ainda receberão e-mails do domínio padrão, mesmo se o domínio personalizado for verificado e aplicado.

Para verificar se a multilocação está ativada, examine o URL incluído nas mensagens de e-mail do Auth. Se o URL incluir um parâmetro tenant, será necessário atualizar os metadados de locatário do seu projeto.

Para isso, execute o comando a seguir:

curl -X PATCH -d "{'inheritance':{'emailSendingConfig': true}}" \
  -H "X-Goog-User-Project: PROJECT_ID"                          \
  -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
  -H 'Content-Type:application/json'                            \
  https://identitytoolkit.googleapis.com/v2/projects/PROJECT_ID/tenants/TENANT_ID?updateMask=inheritance.emailSendingConfig