Conecta un dominio personalizado

Con Firebase App Hosting, no tienes que renunciar a tus nombres de dominio únicos y centrados en la marca para las apps implementadas. Puedes usar un dominio personalizado (como example.com o app.example.com) en lugar de uno generado por Firebase para tu sitio alojado en Firebase. Firebase App Hosting aprovisiona un certificado SSL para cada uno de tus dominios.

En el resto de este documento, se explican los pasos para conectar un dominio personalizado de una de las siguientes maneras:

Para garantizar un servicio sin interrupciones, los registros DNS deben actualizarse en un orden determinado. Sigue las instrucciones para migrar un dominio y evitar el tiempo de inactividad de tu app.

Si no te preocupa el tiempo de inactividad, por ejemplo, cuando conectas un dominio nuevo a tu app web, sigue las instrucciones para conectar un dominio nuevo.

Antes de comenzar: Tipos de registros DNS

El asistente para App Hosting Configurar dominio podría solicitarte que agregues o quites de 1 a 5 registros DNS, según la configuración actual de tu dominio. El Tipo de un registro determina su función. Estos son los tipos de registros que App Hosting podría solicitar:

Tipo Descripción Exclusivo
A Estos registros contienen valores de IPv4 (p.ej., 8.8.8.8), que les indican a los navegadores qué dirección usar cuando intentan comunicarse con tu dominio.
AAAA Estos registros contienen valores de IPv6 (p.ej., 2001:4860:4860::8888), un tipo diferente de registro de dirección con aproximadamente la misma función que los registros A. Actualmente, App Hosting no usa registros AAAA, pero te pedirá que quites los existentes de nuestro dominio, si los hay.
CNAME Estos registros contienen un nombre de dominio independiente que se debe usar en lugar de tu dominio actual para resolver las consultas de DNS. Los registros CNAME solo se permiten en subdominios (p.ej., www.example.com). App Hosting usa registros CNAME por dos motivos:
  • Integración sencilla: Cuando es posible, App Hosting te pide que crees un CNAME para un dominio preconfigurado que comience con _custom-domain....
  • Verificación del certificado SSL: App Hosting usa Cloud Certificate Manager para aprovisionar certificados SSL para tu dominio personalizado. Un registro CNAME en un subdominio _acme-challenge... permite que Certificate Manager cree y renueve certificados por ti. Después de la incorporación, este registro no se debe quitar, ya que, de lo contrario, vencerá la cobertura de tu certificado.
TXT Estos registros te permiten adjuntar metadatos arbitrarios a tu dominio. App Hosting te permite usar un formato específico de registro TXT, fah-claim=[UUID], para indicar en qué dominio personalizado debe publicarse tu dominio. No
CAA Estos registros funcionan como una lista de entidades permitidas para especificar las autoridades certificadoras que están autorizadas a emitir certificados SSL para tu dominio. App Hosting solo solicita registros de CAA si, de lo contrario, no puede emitir certificados para tu dominio. No

Antes de comenzar: tu nombre de dominio personalizado

Cuando agregas o editas registros DNS, los diferentes proveedores de dominio esperan que ingreses diferentes entradas para el campo Host (o nombre de host) dentro de sus sitios de administración de DNS. El asistente de dominio personalizado de App Hosting requiere que ingreses este mismo valor en el campo Nombre.

A continuación, incluimos una compilación de entradas comunes de proveedores populares. Consulta la documentación de tu proveedor de dominio para obtener instrucciones detalladas.

Tipo de dominio Nombre de dominio personalizado
Dominio principal

Las entradas comunes incluyen las siguientes:

  • @
  • El nombre de dominio principal (por ejemplo, example.com)
  • Dejar el campo Host en blanco
Subdominio

Las entradas comunes incluyen las siguientes:

  • El nombre completo del subdominio (por ejemplo, app.example.com)
  • Solo la parte del subdominio (por ejemplo, solo app, sin incluir .example.com)

Proveedores comunes de dominio

Estos son algunos proveedores comunes de dominio y los tipos de entrada que cada uno podría requerir. Esta información se mantiene actualizada tanto como sea posible, pero consulta la documentación de tu proveedor de dominio para obtener instrucciones detalladas.

Migrar un dominio

Si quieres transferir tu dominio de otro proveedor a App Hosting sin tiempo de inactividad, puedes usar el flujo Migrate a domain en Firebase Console. Ese flujo te guía a través de un proceso de dos pasos que prepara App Hosting para entregar contenido en tu dominio antes de dirigir el tráfico a los servidores de App Hosting.

Paso 1: Agrega un dominio personalizado

  1. Abre la página App Hosting de tu proyecto.
  2. Selecciona un backend de App Hosting con la opción Ver panel.
  3. Selecciona la pestaña Configuración y, luego, haz clic en Agregar dominio personalizado.
  4. Ingresa el nombre del dominio personalizado que quieres conectar al sitio de App Hosting.
  5. (Opcional) Marca la casilla para redireccionar todas las solicitudes en el dominio personalizado a un segundo dominio especificado (de manera que example.com y www.example.com redirijan al mismo contenido).
  6. Haz clic en Continuar con la configuración para configurar tus registros DNS y terminar de configurar tu dominio personalizado.

Paso 2: Prepara el dominio

  1. Selecciona la pestaña Migrar un dominio del asistente para configurar un dominio.
  2. Sigue las instrucciones del primer paso, Prepara el dominio, que incluye el conjunto de cambios necesarios para que App Hosting entregue tu backend preferido y establezca conexiones TLS seguras para tu dominio. Agrega, quita y guarda registros de tu dominio en tu proveedor de DNS con las siguientes entradas para los registros requeridos:
    • Nombre: Ingresa tu nombre de dominio personalizado para los registros. El host que indiques corresponde al dominio en el que deseas entregar contenido, que puede ser un dominio principal o un subdominio. Tu proveedor de dominio puede incluir este término como “Nombre de host”, “Nombre” o “Dominio”.
    • Tipo de registro: Agrega el registro DNS proporcionado.
    • Valor: Asigna el valor proporcionado a tus registros. Tu proveedor de dominio puede incluir este término como “Datos”, “Dirige a”, “Contenido”, “Dirección” o “Dirección IP”. El contenido del campo de valor varía según el tipo de registro. Por ejemplo, los registros TXT son cadenas.
  3. Selecciona Verificar registros. App Hosting intentará detectar los cambios que realizaste en tu proveedor de dominio. Los cambios pueden tardar hasta 24 horas en propagarse. Puedes verificar el estado en la vista Configuración > Dominios del panel de backend.

Paso 3: Dirige a App Hosting

  1. Después de que App Hosting verifica las actualizaciones de registros del paso anterior, el asistente avanza al paso final Directo a App Hosting. En este paso, se muestran las actualizaciones de registros que debes realizar para dirigir el tráfico de tu dominio a los servidores de App Hosting. Al igual que antes, agrega, quita y guarda registros de tu dominio en tu proveedor de DNS con las siguientes entradas para los registros requeridos:
    • Nombre: Ingresa tu nombre de dominio personalizado para los registros. El host que indiques corresponde al dominio en el que deseas entregar contenido, que puede ser un dominio principal o un subdominio. Tu proveedor de dominio puede incluir este término como “Nombre de host”, “Nombre” o “Dominio”.
    • Tipo de registro: Agrega el registro DNS proporcionado.
    • Valor: Asigna el valor proporcionado a tus registros. Tu proveedor de dominio puede incluir este término como “Datos”, “Dirige a”, “Contenido”, “Dirección” o “Dirección IP”. El contenido del campo de valor varía según el tipo de registro. Por ejemplo, los registros TXT son cadenas.
  2. Selecciona Verificar registros. App Hosting intentará detectar los cambios que realizaste en tu proveedor de dominio. Los cambios pueden tardar hasta 24 horas en propagarse. Puedes verificar el estado en la vista Configuración > Dominios del panel de backend.

Conecta un dominio nuevo

Si no te preocupa el tiempo de inactividad, por ejemplo, cuando conectas un dominio nuevo a tu app web, sigue las instrucciones de esta sección.

Paso 1: Agrega un dominio personalizado

  1. Abre la página App Hosting de tu proyecto.
  2. Selecciona un backend de App Hosting con la opción Ver panel.
  3. Selecciona la pestaña Configuración y, luego, haz clic en Agregar dominio personalizado.
  4. Ingresa el nombre del dominio personalizado que quieres conectar al sitio de App Hosting.
  5. (Opcional) Marca la casilla para redireccionar todas las solicitudes en el dominio personalizado a un segundo dominio especificado (de manera que example.com y www.example.com redirijan al mismo contenido).
  6. Haz clic en Continuar con la configuración para configurar tus registros DNS y terminar de configurar tu dominio personalizado.

Paso 2: Verifica los registros DNS

  1. En el asistente Configurar dominio de Firebase console, se mostrarán los registros necesarios que se deben actualizar para dirigir tu página a Firebase App Hosting. Agrega, quita y guarda registros de tu dominio en tu proveedor de DNS con las siguientes entradas:
    • Nombre: Ingresa tu nombre de dominio personalizado para los registros. El host que indiques corresponde al dominio en el que deseas entregar contenido, que puede ser un dominio principal o un subdominio. Tu proveedor de dominio puede incluir este término como “Nombre de host”, “Nombre” o “Dominio”.
    • Tipo de registro: Agrega el registro DNS proporcionado.
    • Valor: Asigna el valor proporcionado a tus registros. Tu proveedor de dominio puede incluir este término como “Datos”, “Dirige a”, “Contenido”, “Dirección” o “Dirección IP”. El contenido del campo de valor varía según el tipo de registro. Por ejemplo, los registros TXT son cadenas.
  2. Selecciona Verificar registros. App Hosting intentará detectar los cambios que realizaste en tu proveedor de dominio. Los cambios pueden tardar hasta 24 horas en propagarse. Puedes verificar el estado en la vista Configuración > Dominios del panel de backend.

Espera el aprovisionamiento del certificado SSL

App Hosting puede tardar hasta algunas horas en aprovisionar un certificado SSL para tu dominio después de que actualices tus registros DNS. En algunos casos, puede tardar hasta 24 horas después de que apuntas tu DNS a Firebase App Hosting.

Puedes usar las herramientas de seguridad del navegador para ver el certificado. Mientras se aprovisiona el dominio, es posible que veas un certificado no válido o tengas problemas para conectarte a él. Esta es una parte normal del proceso y se resolverá cuando esté disponible el certificado de tu dominio.

Nota: Firebase App Hosting vuelve a aprovisionar los certificados SSL automáticamente, según sea necesario, para los dominios personalizados.

Descripciones de los estados de los dominios personalizados

Estado Descripción
Requiere configuración

Es posible que debas cambiar la configuración de los registros DNS.

  • En la mayoría de los casos, los registros A del DNS no se han propagado desde el proveedor de nombre de dominio hasta los servidores de Firebase App Hosting.
    Sugerencia para la solución de problemas: Si han transcurrido más de 24 horas, verifica si dirigiste los registros a Firebase App Hosting.

  • En casos menos frecuentes, es posible que las verificaciones de SSL fallen porque tus registros DNS tienen registros A o CNAME que dirigen a otros proveedores de hosting.
    Sugerencia para la solución de problemas: Comprueba que tus registros A solo estén dirigidos a Firebase App Hosting. También quita todos los registros CNAME.

Pendiente

La configuración del dominio personalizado se realizó sin problemas, pero Firebase App Hosting no ha aprovisionado un certificado SSL.

En ocasiones, los registros CAA demasiado restrictivos pueden detener la creación de un certificado SSL para un dominio personalizado. Asegúrate de que las autoridades certificadas `letsencrypt.org` y `pki.goog` puedan crear certificados SSL para tu dominio.

Certificado de creación

Se está produciendo un certificado SSL para tu dominio.

Conectado

El dominio personalizado tiene los registros DNS adecuados y un certificado SSL.
Puedes entregar el contenido de tu sitio.