Conectar um domínio personalizado

Com o Firebase App Hosting, você não precisa desistir dos nomes de domínio exclusivos e que têm a cara da sua marca para apps implantados. Você pode 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 pelo Firebase. O Firebase App Hosting provisiona um certificado SSL para cada um dos seus domínios.

No restante deste documento, você vai conferir as etapas para conectar um domínio personalizado de uma destas maneiras:

• Migrar um domínio
• Conectar um novo domínio

Para evitar interrupções no serviço, seus registros DNS precisam ser atualizados em uma determinada ordem. Siga as instruções para migrar um domínio e evitar a inatividade do app.

Se a inatividade não for um problema, como quando você está conectando um domínio novo ao seu web app, siga as instruções para conectar um novo domínio.

Antes de começar: tipos de registros DNS

O assistente Configurar domínio App Hosting pode pedir que você adicione ou remova de um a cinco registros DNS, dependendo da configuração atual do seu domínio. O tipo de um registro determina a função dele. Estes são os tipos de registros que o App Hosting pode pedir:

Tipo	Descrição	Exclusivo
A	Esses registros contêm valores IPv4 (por exemplo, 8.8.8.8), que informam aos navegadores qual endereço usar ao tentar entrar em contato com seu domínio.	Sim
AAAA	Esses registros contêm valores IPv6 (por exemplo, 2001:4860:4860::8888), um tipo diferente de registro de endereço com aproximadamente a mesma função dos registros A. No momento, o App Hosting não usa registros AAAA, mas pede que você remova os registros atuais do nosso domínio, se houver.	Sim
CNAME	Esses registros contêm um nome de domínio separado que deve ser usado em vez do seu domínio atual para resolver consultas de DNS. Os registros CNAME só são permitidos em subdomínios (por exemplo, www.example.com). O App Hosting usa registros CNAME por dois motivos: Integração fácil:quando possível, o App Hosting pede que você crie um CNAME para um domínio pré-configurado que começa com _custom-domain.... Verificação de certificado SSL:o App Hosting usa o Gerenciador de certificados do Cloud para provisionar certificados SSL para seu domínio personalizado. Um registro CNAME em um subdomínio _acme-challenge... permite que o Gerenciador de certificados crie e renove certificados para você. Depois da integração, este registro não pode ser removido, ou a cobertura do certificado vai expirar.	Sim
TXT	Esses registros permitem anexar metadados arbitrários ao seu domínio. O App Hosting permite usar um formato específico de registro TXT, fah-claim=[UUID], para indicar qual domínio personalizado ele deve veicular no seu domínio.	Não
CAA	Esses registros funcionam como uma lista de permissões para especificar as autoridades de certificação autorizadas a emitir certificados SSL para seu domínio. O App Hosting só solicita registros CAA se estiver bloqueado de outra forma para emitir certificados para seu domínio.	Não

Antes de começar: seu nome de domínio personalizado

Ao adicionar ou editar registros DNS, diferentes provedores de domínio esperam que você insira entradas alternativas no campo Host (ou nome do host) nos seus sites de gerenciamento de DNS. O assistente de domínio personalizado App Hosting exige que você insira o mesmo valor no campo Nome.

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	Nome do domínio personalizado
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)

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

Host	Entrada
example.com.	@
www.example.com.	www

Google Cloud DNS

Host	Entrada
example.com.	.example.com.
www.example.com.	www.example.com.

NameCheap

Host	Entrada
example.com.	@
www.example.com.	www

Squarespace

Host	Entrada
example.com.	@
www.example.com.	www

Migrar um domínio

Se você quiser transferir seu domínio de outro provedor para App Hosting sem tempo de inatividade, use o fluxo Migrar um domínio no Console do Firebase. Esse fluxo orienta você em um processo de duas etapas que prepara o App Hosting para veicular conteúdo no seu domínio antes de direcionar o tráfego para os servidores do App Hosting.

Etapa 1: adicionar um domínio personalizado

1. Abra a página do App Hosting do projeto.
2. Selecione um back-end App Hosting usando a opção Ver painel.
3. Selecione a guia Configurações e clique em Adicionar domínio personalizado.
4. Insira o nome de domínio personalizado que você quer conectar ao seu site do App Hosting.
5. (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.
6. Clique em Continuar para configurar e configurar os registros DNS e concluir a configuração do domínio personalizado.

Etapa 2: preparar o domínio

1. Selecione a guia Migrar um domínio do assistente Configurar domínio.
2. Siga as instruções na primeira etapa, Preparar domínio, que inclui o conjunto de mudanças necessárias para que o App Hosting veicule seu back-end preferido e estabeleça conexões TLS seguras para seu domínio. Adicione, remova e salve registros do seu domínio no provedor de DNS com as seguintes entradas para os registros necessários:
   • Nome: insira seu nome de domínio personalizado para os registros. 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".
   • Tipo de registro: adicione o registro DNS fornecido.
   • Valor: atribua o valor fornecido aos seus registros. Seu provedor de domínio pode listar esse termo como "Dados", "Direciona para", "Conteúdo", "Endereço" ou "Endereço IP". O conteúdo do campo "Valor" varia de acordo com o tipo de registro. Por exemplo, os registros TXT são strings.
3. Selecione Verificar registros. O App Hosting vai tentar detectar as mudanças feitas no seu provedor de domínio. A propagação das mudanças pode levar até 24 horas. Verifique o status na visualização Configurações > Domínios no painel do back-end.

Etapa 3: ir direto para App Hosting

1. Depois que o App Hosting verificar as atualizações de registro da etapa anterior, o assistente vai para a etapa final Direcionar para App Hosting. Esta etapa mostra as atualizações de registro que você precisa fazer para direcionar o tráfego do seu domínio aos servidores App Hosting. Como antes, adicione, remova e salve registros do seu domínio no provedor de DNS com as seguintes entradas para os registros obrigatórios:
   • Nome: insira seu nome de domínio personalizado para os registros. 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".
   • Tipo de registro: adicione o registro DNS fornecido.
   • Valor: atribua o valor fornecido aos seus registros. Seu provedor de domínio pode listar esse termo como "Dados", "Direciona para", "Conteúdo", "Endereço" ou "Endereço IP". O conteúdo do campo "Valor" varia de acordo com o tipo de registro. Por exemplo, os registros TXT são strings.
2. Selecione Verificar registros. O App Hosting vai tentar detectar as mudanças feitas no seu provedor de domínio. A propagação das mudanças pode levar até 24 horas. Verifique o status na visualização Configurações > Domínios no painel do back-end.

Conectar um novo domínio

Se a inatividade não for um problema, como ao conectar um domínio novo ao seu web app, siga as instruções nesta seção.

Etapa 1: adicionar um domínio personalizado

1. Abra a página do App Hosting do projeto.
2. Selecione um back-end App Hosting usando a opção Ver painel.
3. Selecione a guia Configurações e clique em Adicionar domínio personalizado.
4. Insira o nome de domínio personalizado que você quer conectar ao seu site do App Hosting.
5. (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.
6. Clique em Continuar para configurar e configurar os registros DNS e concluir a configuração do domínio personalizado.

Etapa 2: verificar os registros DNS

1. O assistente Configurar domínio do Console do Firebase vai mostrar os registros necessários que precisam ser atualizados para direcionar sua página ao Firebase App Hosting. Adicione, remova e salve registros do seu domínio no provedor de DNS com as seguintes entradas:
   • Nome: insira seu nome de domínio personalizado para os registros. 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".
   • Tipo de registro: adicione o registro DNS fornecido.
   • Valor: atribua o valor fornecido aos seus registros. Seu provedor de domínio pode listar esse termo como "Dados", "Direciona para", "Conteúdo", "Endereço" ou "Endereço IP". O conteúdo do campo "Valor" varia de acordo com o tipo de registro. Por exemplo, os registros TXT são strings.
2. Selecione Verificar registros. O App Hosting vai tentar detectar as mudanças feitas no seu provedor de domínio. A propagação das mudanças pode levar até 24 horas. Verifique o status na visualização Configurações > Domínios no painel do back-end.

Aguarde o provisionamento do certificado SSL

O App Hosting pode levar algumas horas para provisionar um certificado SSL para seu domínio depois que você atualizar os registros DNS. Em alguns casos, isso pode levar até 24 horas depois que você apontar o DNS para Firebase App Hosting.

Visualize este certificado usando as ferramentas de segurança do navegador. Durante o provisionamento do domínio, talvez você veja um certificado inválido ou tenha problemas para se conectar a ele. Isso é normal no processo e será resolvido depois que o certificado do seu domínio estiver disponível.

Observação:o Firebase App Hosting faz automaticamente um novo provisionamento dos certificados SSL para os domínios personalizados, conforme necessário.

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 App Hosting. Dica de solução de problemas: se já se passaram mais de 24 horas, verifique se você direcionou seus registros para Firebase App Hosting. Em casos mais raros, as verificações de SSL podem falhar porque seus registros 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 Firebase App Hosting e remova todos os registros CNAME.
Pendente	Você configurou corretamente seu domínio personalizado, mas o Firebase App Hosting não provisionou um certificado SSL. Às vezes, registros CAA excessivamente restritivos podem interromper a emissão de um certificado SSL para um domínio personalizado. Verifique se as autoridades de certificação `letsencrypt.org` e `pki.goog` têm permissão para criar certificados SSL para seu domínio.
Estamos criando o certificado	Um certificado SSL está sendo produzido para seu domínio.
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.