Fique por dentro dos destaques do Firebase no Google I/O 2023. Saiba mais

Conectar um domínio personalizado

Com o Firebase Hosting, você não precisa desistir dos nomes de domínio exclusivos e que têm a cara da sua marca. Você tem a opção de usar um domínio personalizado, como example.com ou app.example.com, em vez de um domínio gerado pelo Firebase para seu site hospedado pela plataforma.

O Firebase Hosting provisiona um certificado SSL para cada um dos seus domínios e exibe o conteúdo em uma CDN global.

No restante deste documento, você verá as etapas para conectar seu domínio personalizado.

Configurar seu domínio para o Hosting

Verifique se você tem um site do Firebase Hosting no seu projeto do Firebase. Para isso, é necessário ter concluído o assistente "Primeiros passos" na página do Firebase Hosting do seu projeto.

Etapa 1: adicionar um domínio

  1. Na página do Hosting do seu projeto, abra o assistente para conectar um domínio personalizado:

    • Se você tiver apenas um site do Hosting, clique em Adicionar domínio personalizado.
    • Se você tiver mais de um, clique em Ver no site desejado e selecione Adicionar domínio personalizado.

  2. Insira o nome de domínio personalizado que você quer conectar a seu site do Hosting.

  3. (Opcional) Marque a caixa para redirecionar todas as solicitações no domínio personalizado para um segundo domínio especificado, de modo que example.com e www.example.com redirecionem para o mesmo conteúdo.

  4. Clique em Continuar para iniciar o processo de validação.

Etapa 2: confirmar propriedade de domínio

Caso seja solicitado no assistente de configuração da opção Conectar domínio, verifique seu domínio apex.

Essas etapas garantem que seu domínio ainda não foi vinculado a um projeto do Firebase e que você é o proprietário do domínio especificado.

  1. No site do seu provedor de domínio, localize a página de gerenciamento de DNS.

  2. Adicione e salve um novo registro com as seguintes entradas:

    • Tipo: adicionar um registro TXT.

      O Firebase Hosting exige que você mantenha esse registro TXT sempre presente nas suas configurações de DNS para comprovar sua propriedade do domínio e autorizar o Firebase a atribuir e renovar os certificados SSL do seu site.

      Seu provedor de domínio pode listar esse termo como "Tipo de registro".

    • Host: insira sua chave de domínio apex.

      Ao provar sua propriedade de um domínio apex, ou domínio raiz, você também comprova que detém todos os subdomínios dele.

      Seu provedor de domínio pode listar esse termo como "Nome do host", "Nome" ou "Domínio".

    • Valor: copie o valor de verificação exclusivo no campo.

      O Firebase Hosting verifica esse valor para provar a propriedade do seu domínio.

      Seu provedor de domínio pode listar esse termo como "Dados".

  3. Aguarde até 24 horas para a propagação de seus registros TXT atualizados e clique em Verificar.

    É possível clicar em Cancelar para fechar com segurança a janela Conectar domínio e a reabrir posteriormente. Isso não afeta o tempo de propagação, mas você precisará inserir novamente seu nome de domínio ao reabrir a janela.

    Após um longo tempo de propagação, é possível clicar em Verificar na janela Conectar domínio do Console do Firebase para iniciar o processo de provisionamento do certificado SSL.

    Na maioria dos casos, a propagação dos seus registros e a verificação do seu domínio acontecerão em algumas horas, dependendo do seu provedor de domínio. Consulte a documentação do provedor para ter instruções detalhadas sobre como adicionar registros TXT e os tempos de propagação.

    Se uma mensagem de erro aparecer depois que você clicar em Verificar, isso significa que seus registros não foram propagados ou seus valores podem estar incorretos.

Etapa 3: ativar

Na janela Conectar domínio do Console do Firebase, selecione Configuração rápida para um novo site ou Configuração avançada se você já tiver um site em execução em outro provedor de hospedagem e precisar de uma migração sem inatividade.

Aguarde o provisionamento do certificado SSL

Depois de verificarmos a propriedade do domínio, provisionamos um certificado SSL para seu domínio e o implantamos na nossa CDN global em 24 horas após você direcionar seus registros de DNS A ao Firebase Hosting.

Seu domínio será listado como um dos nomes alternativos do assunto (SAN, na sigla em inglês) no certificado SSL do FirebaseApp. Visualize este certificado usando as ferramentas de segurança do navegador. Durante o provisionamento do domínio, talvez você veja um certificado inválido que não inclui seu nome de domínio. Isso é normal no processo e será resolvido depois que o certificado do seu domínio estiver disponível.

Para usuários da Configuração avançada, o site será hospedado por seu provedor anterior até que o status de configuração na página do Firebase Hosting do seu projeto seja atualizado para Conectado.

Sua chave de domínio personalizada

Ao adicionar ou editar registros DNS, diferentes provedores de domínio esperam que você insira entradas alternativas no campo Host nos seus sites de gerenciamento de DNS. Compilamos abaixo entradas comuns dos provedores mais usados. Consulte a documentação do seu provedor de domínio para instruções detalhadas.

Tipo de domínio Chave de domínio personalizada
Domínio apex

Entradas comuns incluem o seguinte:

  • @
  • O nome de domínio apex (por exemplo, example.com)
  • O campo Host em branco
Subdomínio

Entradas comuns incluem o seguinte:

  • O nome completo do subdomínio (por exemplo, app.example.com)
  • Somente a parte do subdomínio (por exemplo, apenas app e deixando de fora .example.com)
  • Somente www para o subdomínio de www.example.com

Provedores de domínio comuns

Veja alguns provedores de domínio comuns e os tipos de entrada que cada um pode exigir. Essas informações são mantidas atualizadas o máximo possível. Ainda assim, consulte a documentação do seu provedor de domínio para ver instruções detalhadas.

Configurar descrições de status para domínios personalizados

Status Descrição
Configuração necessária

Pode ser necessário alterar uma configuração dos registros DNS.

  • Na maioria dos casos, os registros A de DNS não se propagaram do provedor de nome de domínio para os servidores do Firebase Hosting.
    Dica de solução de problemas: se já se passaram mais de 24 horas, verifique se você direcionou seus registros para o Firebase Hosting.

  • Em casos mais raros, principalmente se você estiver usando o fluxo de configuração avançada, os desafios do SSL podem apresentar falha porque:

    • seus registros de DNS têm registros A ou CNAME que apontam para outros provedores de hospedagem;
      Dica de solução de problemas: verifique se os registros A apontam apenas para o Firebase Hosting e remova todos os registros CNAME.
    • A migração falhou, e o token (registros TXT de DNS ou o arquivo enviado por upload para seu site) é inválido.
      Dica de solução de problemas: clique na opção Ver do domínio e forneça o novo token ao seu domínio existente.
Pendente

Você configurou corretamente seu domínio personalizado, mas o Firebase Hosting não provisionou um certificado SSL.

Às vezes, os seguintes problemas podem interromper a emissão de um certificado SSL para um domínio personalizado:

  • Seus registros da CAA são muito restritivos.
    Dica de solução de problemas: verifique se as autoridades de certificação "letsencrypt.org" and "pki.goog" têm permissão para criar certificados SSL para seu domínio.
  • Seu código de desafio é inválido.
    Se você estiver usando o fluxo de configuração avançada e a migração falhou, seu token e o código de desafio serão inválidos.
    Dica de solução de problemas: clique na opção Ver do domínio e forneça o novo token ao seu domínio existente.
  • Você solicitou certificados para muitos subdomínios.
    Dica de solução de problemas: em geral, o Firebase Hosting recomenda no máximo 20 subdomínios em um domínio apex personalizado, devido aos limites de emissão de certificados SSL.
Conectado

Seu domínio personalizado tem os registros de DNS apropriados e recebeu um certificado SSL.
É possível exibir o conteúdo do seu site.

Requer nova verificação

O Firebase vai exigir que você verifique novamente a propriedade do domínio manualmente se o registro TXT adicionado quando você verificou a propriedade do domínio for alterado ou removido das configurações de DNS do domínio.

  • Lembe que vários registros TXT com um token de verificação de site Google são permitidos em um único domínio.
  • É preciso que você mantenha esse registro TXT sempre presente nas suas configurações de DNS para comprovar sua propriedade do domínio e nos autorizar a atribuir e renovar certificados SSL para seu site.
Dica de solução de problemas: acesse a página do Hosting do projeto para concluir o processo de revalidação dentro do período especificado (geralmente 30 dias) para evitar que o domínio personalizado seja desconectado automaticamente do Firebase Hosting.