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. É possível usar um domínio personalizado (como yourdomain.com ou app.yourdomain.com) em vez de um domínio gerado pelo Firebase para seu site hospedado pela plataforma.

O Firebase Hosting provisiona um certificado SSL, assinado pela Let's Encrypt, 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.

Configure 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 Hosting do seu projeto, abra o assistente para conectar um domínio personalizado:

    • Se você tiver apenas um site do Hosting, clique em Conectar domínio.
    • Se você tiver mais de um site do Hosting, clique em Exibir no site desejado e selecione Conectar domínio.
  2. Insira o nome de domínio personalizado que você quer conectar a seu site do Hosting.

  3. (Opcional) Marque a caixa se quiser redirecionar todas as solicitações no domínio personalizado para um segundo domínio especificado (de modo que yourdomain.com e www.yourdomain.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 está 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 certificados SSL para 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ê deverá 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 ao clicar em Verificar for exibida uma mensagem de erro, isso significa que seus registros não foram propagados ou talvez os valores estejam 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 implantaremos 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 é uma parte normal do 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 distintas para o 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 ver instruções mais detalhadas.

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

Entradas comuns incluem o seguinte:

  • @

  • O nome de domínio apex (yourdomain.com)

  • O campo Host em branco

Subdomínio

Entradas comuns incluem o seguinte:

  • O nome do subdomínio (app.yourdomain.com)
  • Apenas a parte do subdomínio (app, deixando de fora .yourdomain.com)
    • Um caso de uso comum é inserir www como sua chave para o subdomínio www.yourdomain.com.

Configure descrições de status para os 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 de DNS A 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ê apontou 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 de DNS TXT ou o arquivo enviado por upload para seu site) agora é 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 a autoridade de certificação Let's Encrypt tem 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 falhar, 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 pode exigir que você verifique novamente a propriedade do domínio manualmente caso ocorra uma das seguintes situações:

  • O registro TXT incluído inicialmente quando você verificou a propriedade do domínio foi alterado ou removido das configurações de DNS do seu domínio.
    • Vários registros TXT com um token de verificação do 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.
  • A pessoa que comprovou a propriedade do domínio não é mais membro do seu projeto do Firebase.
Dica para solução de problemas: acesse a página do Hosting do projeto para concluir o processo de revalidação dentro da janela especificada (geralmente 30 dias) para que o domínio personalizado seja desconectado automaticamente do Firebase Hosting.