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
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.
Insira o nome de domínio personalizado que você quer conectar a seu site do Hosting.
(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.
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.
No site do seu provedor de domínio, localize a página de gerenciamento de DNS.
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".
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".
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.
Configuração rápida
Volte ao site de gerenciamento de DNS do provedor de nome de domínio para criar
registros DNS A que direcionam sua página ao Firebase Hosting. Adicione e salve registros com as seguintes entradas:
O host que você indicar é o domínio em que você quer exibir conteúdo. Ele pode ser um domínio ou um subdomínio apex.
Seu provedor de domínio pode listar esse termo como "Nome do host", "Nome" ou "Domínio".
Valor: atribua um valor a cada registro DNS A para direcionar seu domínio aos endereços IP especificados.
Seu provedor de domínio pode listar este termo como "Dados", "Direciona para", "Conteúdo", "Endereço" ou "Endereço IP".
Aguarde o provisionamento do certificado SSL.
Isso pode levar até 24 horas após você direcionar seus registros A para o Firebase Hosting.
Na maioria dos casos, a propagação de registros e o provisionamento do certificado SSL acontecerão em algumas horas, dependendo do seu provedor de domínio.
Configuração avançada
Na janela Conectar domínio do Console do Firebase
você precisará fornecer um token para migrar seu site atual. Para isso, basta concluir uma das seguintes etapas:
Atualizar os registros TXT do DNS: acesse o site de gerenciamento de DNS
do seu provedor de domínio. Adicione um registro TXT com sua chave de domínio e o valor fornecido.
Aguarde até 24 horas para a propagação dos seus registros TXT.
Fazer upload de um arquivo para um site atual: faça upload do
token no seu site atual no URL especificado e verifique a existência
dele.
É necessário que esta página seja exibida por HTTPS e não precisa ser válida ou
segura. O token criptografado é válido apenas por uma tentativa. Se a migração falhar, um novo token será gerado para seus registros.
Aguarde o provisionamento do certificado SSL.
Isso poderá levar até 24 horas.
Na maioria dos casos, a propagação de registros e o provisionamento do certificado SSL acontecerão em algumas horas, dependendo do seu provedor de domínio.
Depois que seu certificado SSL for provisionado, volte ao site de gerenciamento de DNS do provedor para adicionar registros DNS A que direcionam sua página para o Firebase Hosting. Adicione e salve registros com as seguintes entradas:
O host que você indicar é o domínio em que você quer exibir conteúdo. Ele pode ser um domínio ou um subdomínio apex.
Seu provedor de domínio pode listar esse termo como "Nome do host", "Nome" ou "Domínio".
Valor: atribua um valor a cada registro DNS A para direcionar seu domínio aos endereços IP especificados.
Seu provedor de domínio pode listar esse termo como "Dados", "Direciona para", "Conteúdo", "Endereço" ou "Endereço IP".
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.
Cloudflare
Tipo
Host
Valor
Entradas de registro TXT do DNS
TXT
example.com
Valor de verificação fornecido no Console do Firebase
Entradas de registros A do DNS
A
example.com
199.36.158.100
A
www
199.36.158.100
Google Domains
Tipo
Host
Valor
Entradas de registro TXT do DNS
TXT
@
Valor de verificação fornecido no Console do Firebase
Entradas de registros A do DNS
A
@
199.36.158.100
A
www
199.36.158.100
Google Cloud DNS
Tipo
Host
Valor
Entradas de registro TXT do DNS
TXT
example.com
Valor de verificação fornecido no Console do Firebase
Entradas de registros A do DNS
A
example.com
199.36.158.100
A
www
199.36.158.100
NameCheap
Tipo
Host
Valor
Entradas de registro TXT do DNS
TXT
@
Valor de verificação fornecido no Console do Firebase
Entradas de registros A do DNS
A
@
199.36.158.100
A
@
199.36.158.100
Squarespace
Tipo
Host
Valor
Entradas de registro TXT do DNS
TXT
@
Valor de verificação fornecido no Console do Firebase
Entradas de registros A do DNS
A
@
199.36.158.100
A
www
199.36.158.100
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.