Conecta un dominio personalizado

No tienes que renunciar a tus nombres de dominio únicos y centrados en la marca para las apps que se implementan en Firebase App Hosting. 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 tu dominio personalizado.

Configura tu dominio para App Hosting

Asegúrate de haber completado las tareas básicas de configuración de App Hosting para tener un sitio de Firebase App Hosting en tu proyecto de Firebase.

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 para configurar los registros DNS y terminar de configurar el dominio personalizado.

Paso 2: Configura el dominio personalizado

  1. En el asistente Agregar dominio personalizado 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:

    • Tipo: Agrega el registro DNS proporcionado.

    • Host: Ingresa tu clave de dominio personalizado para los registros. El host que indiques es el 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”.

    • 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, ya que los registros A y AAAA tienen direcciones IP como valores, mientras que los registros TXT son cadenas.

Da tiempo para que se aprovisione tu certificado SSL. Por lo general, este proceso tarda unas horas, pero, en ocasiones, puede requerir hasta 24 horas después de que apuntas tu DNS a Firebase App Hosting. En la mayoría de los casos, la propagación de tus registros y el aprovisionamiento de tu certificado SSL ocurrirán en una hora, dependiendo de tu proveedor de dominio.

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, es posible que se requieran hasta 24 horas después de que apuntas tu DNS a Firebase App Hosting.

Puedes ver este certificado usando las herramientas de seguridad del navegador. Mientras se aprovisiona el dominio, es posible que veas un certificado no válido o que 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 automáticamente los certificados SSL, según sea necesario, para los dominios personalizados.

Tipos de registros DNS

Es posible que el asistente de dominio personalizado App Hosting te solicite que agregues 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 podría solicitar App Hosting:

Tipo Descripción Exclusivo
A Estos registros contienen valores IPv4 (por ejemplo, 8.8.8.8), que indican a los navegadores qué dirección deben usar cuando intenten comunicarse con tu dominio. Sí
AAAA Estos registros contienen valores IPv6 (p.ej., 2001:4860:4860::8888), un tipo diferente de registro de dirección con más o menos 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. Sí
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 sea posible, App Hosting te pedirá que crees un CNAME para un dominio preconfigurado que comience con _custom-domain....
  • Verificación de certificados SSL: App Hosting usa el Administrador de certificados de Cloud 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 integración, no se debe quitar este registro, o se vencerá la cobertura de tu certificado.
 Sí
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 qué dominio personalizado debe publicar en tu dominio. No
CAA Estos registros funcionan como una lista de entidades permitidas para especificar las autoridades certificadoras que tienen autorización para emitir certificados SSL para tu dominio. App Hosting solo solicita registros de CAA si, de otro modo, se le impide emitir certificados para tu dominio. No

Tu clave de dominio personalizado

Cuando agregas o editas registros DNS, los diferentes proveedores de dominio esperan que ingreses diferentes entradas para el campo Host dentro de sus sitios de administración de DNS. 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 Clave 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.

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 más raros, es posible que las verificaciones de SSL fallen porque tus registros DNS tienen registros A o CNAME dirigidos a otros proveedores de hosting.
    Sugerencia para la solución de problemas: Verifica que tus registros A apunten solo a Firebase App Hosting y quita todos los registros CNAME.
Pendiente

La configuración del dominio personalizado se realizó sin problemas, pero Firebase App Hosting no aprovisionó 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.