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 un dominio personalizado de una de estas 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

Es posible que el asistente Configurar dominio de App Hosting te solicite que agregues o quites de 1 a 5 registros DNS, según la configuración actual de tu dominio. El campo Type 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 IPv4 (p.ej., 8.8.8.8), que les indican a los navegadores qué dirección usar cuando intentan comunicarse con tu dominio. Sí
AAAA Estos registros contienen valores IPv6 (p.ej., 2001:4860:4860::8888), un tipo diferente de registro de direcciones 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. No
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 razones:
  • 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

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.

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

Migrar un dominio

Si deseas garantizar un servicio sin interrupciones para tu app, debes configurar los registros DNS en un orden determinado. Después de agregar tu dominio, primero deberás realizar un proceso para verificar tus registros DNS y, luego, deberás realizar un paso de verificación más para dirigir las solicitudes activas a 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: Verifica los registros DNS

  1. 1. En el asistente Migrar un 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 para los registros obligatorios:
    • Nombre: Ingresa el 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, ya que los registros A y AAAA tienen direcciones IP como valores, mientras que los registros TXT son cadenas.
  2. Selecciona Verificar registros. App Hosting intentará detectar los cambios que tienes en tu proveedor de dominios. 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 verifique las actualizaciones de los registros, el diálogo Direct to App Hosting mostrará el registro final que debes actualizar para dirigir tu dominio a 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 el 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, ya que los registros A y AAAA tienen direcciones IP como valores, mientras que los registros TXT son cadenas.
  2. Selecciona Verificar registros. App Hosting intentará detectar los cambios que tienes en tu proveedor de dominios. 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 el 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, ya que los registros A y AAAA tienen direcciones IP como valores, mientras que los registros TXT son cadenas.
  2. Selecciona Verificar registros. App Hosting intentará detectar los cambios que tienes en tu proveedor de dominios. 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, es posible que se requieran 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 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 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 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: Comprueba que tus registros A estén dirigidos 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.