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

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

Ao configurar domínios personalizados para e-mails de autenticação, os usuários verão o mesmo domínio para seu endereço da web e para os e-mails de gerenciamento de usuários.

Existem basicamente duas etapas para configurar isso:

  • Adicione o domínio aos seus modelos de e-mail no Firebase console.
  • Verifique seu domínio adicionando registros DNS em seus registros de domínio.

Adicionando o domínio aos seus modelos de e-mail

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

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

    1. Clique no ícone de edição ( ).
    2. Clique em personalizar domínio .
    3. Digite o domínio que deseja usar.

Você verá então uma tabela de registros DNS para adicionar ao seu registrador de domínio para verificar se você é o proprietário do domínio.

Verifique 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 v=spf1... TXT para um domínio específico. Se você precisar 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. Quando estiver, a página Modelos no console do Firebase mostrará uma mensagem verde "Verificação concluída". Em seguida, você pode clicar no botão Aplicar domínio personalizado para colocar suas alterações em vigor.

Projetos multilocatários

Se você tiver atualizado para o Firebase Authentication com Identity Platform e ativado 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 SMTP personalizadas. Caso contrário, os usuários ainda receberão emails do domínio padrão, mesmo que o domínio personalizado seja verificado e aplicado com êxito.

Você pode verificar se a multilocação está habilitada examinando o URL incluído nas mensagens de e-mail do Auth. Se a URL incluir um parâmetro tenant , você precisará atualizar os metadados de locatário do seu projeto.

Para fazer isso, execute o seguinte comando:

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