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 pela plataforma. 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 seu domínio personalizado.
Configurar seu domínio para App Hosting
Verifique se você concluiu as tarefas básicas de configuração do App Hosting para ter um site Firebase App Hosting no seu projeto do Firebase.
Etapa 1: adicionar um domínio personalizado
- Abra a página App Hosting do projeto.
- Selecione um back-end App Hosting usando a opção Ver painel.
- Selecione a guia Configurações e clique em Adicionar domínio personalizado.
- Insira o nome de domínio personalizado que você quer conectar ao seu site do App 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
ewww.example.com
redirecionem para o mesmo conteúdo. - Clique em Continuar para configurar os registros DNS e concluir a configuração do domínio personalizado.
Etapa 2: configurar o domínio personalizado
O assistente Adicionar domínio personalizado 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:
- Tipo: adicione o registro DNS fornecido.
Host: insira sua chave de domínio personalizada 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".
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 de valor varia de acordo com o tipo de registro, sendo que os registros A e AAAA têm endereços IP como valores, enquanto os registros TXT são strings.
Aguarde o provisionamento do certificado SSL. Isso normalmente leva algumas horas, mas pode exigir até 24 horas após você apontar o DNS para Firebase App Hosting. Na maioria dos casos, a propagação de registros e o provisionamento do certificado SSL vão acontecer em uma hora, dependendo do seu provedor de domínio.
Aguarde o provisionamento do certificado SSL
O App Hosting pode levar até algumas horas para provisionar um certificado SSL para seu domínio após a atualização dos registros de DNS. Em alguns casos, pode ser necessário esperar até 24 horas após 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 ao seu domínio. 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.
Tipos de registro DNS
O assistente de domínio personalizado App Hosting pode pedir que você adicione de 1 a 5 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 solicitar:
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 vai pedir que você remova os registros existentes do nosso domínio, se houver. | Sim |
CNAME | Esses registros contêm um nome de domínio separado que precisa ser usado em vez
do seu domínio atual para resolver consultas DNS. Os registros CNAME só são permitidos em subdomínios (por exemplo, www.example.com). App Hosting usa registros CNAME por
dois motivos:
|
Sim |
TXT | Esses registros permitem que você anexe metadados arbitrários ao seu domínio. 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 criar certificados SSL para seu domínio. O App Hosting só solicita registros CAA se estiver bloqueado para a criação de certificados do seu domínio. | Não |
Sua chave de domínio personalizada
Ao adicionar ou editar registros DNS, diferentes provedores de domínio esperam que você insira entradas diferentes no campo Host nos 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:
|
Subdomínio | Entradas comuns incluem o seguinte:
|
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 provedor de domínio para instruções detalhadas.
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.
|
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. |