Con Firebase Hosting, no tienes que renunciar a tus nombres de dominio únicos y centrados en la marca. Puedes usar un dominio personalizado (como example.com o app.example.com) en lugar de uno generado por Firebase para un sitio alojado en Firebase.
Firebase Hosting aprovisiona un certificado SSL para cada uno de tus dominios y entrega el contenido a través de una CDN global.
El resto de este documento es una explicación de los pasos para conectar tu dominio
personalizado.
Configura tu dominio para Hosting
Asegúrate de completar el asistente “Primeros pasos” en la página de Firebase Hosting de tu proyecto para tener un sitio de Firebase Hosting en tu proyecto de Firebase.
Paso 1: Agrega un dominio personalizado
En la
página de Hosting de tu proyecto,
ingresa al asistente para conectar un dominio personalizado:
Si solo tienes un sitio de Hosting, haz clic en Agrega un dominio personalizado.
Si tienes más de un sitio de Hosting, haz clic en
Ver en el sitio deseado y, luego, en Agrega un dominio personalizado.
Ingresa el nombre del dominio personalizado que quieres conectar al sitio de
Hosting.
(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).
Haz clic en Continuar para configurar tus registros DNS y terminar de configurar tu dominio personalizado.
Paso 2: Configura el dominio personalizado
Si se solicita en el asistente de configuración Conectar dominio, verifica tu dominio principal.
Estos pasos garantizan que tu dominio aún no esté vinculado con un proyecto de Firebase y que tú seas el propietario del dominio especificado.
En el sitio de tu proveedor de dominio, busca la página de administración de DNS.
Agrega y guarda un registro nuevo con las siguientes entradas:
Tipo: Agrega un registro TXT.
Firebase Hosting requiere que mantengas este registro TXT presente de forma continua en tu configuración de DNS para probar tu propiedad del dominio y autorizar a Firebase a asignar y renovar los certificados SSL de tu sitio.
Tu proveedor de dominio puede incluir este término como “Tipo de registro”.
Probar tu propiedad de un dominio principal, o dominio raíz, prueba tu propiedad de todos sus subdominios.
Tu proveedor de dominio puede incluir este término como “Nombre de host”, “Nombre” o “Dominio”.
Valor: Copia el valor de verificación único en el campo.
Firebase Hosting verifica este valor para demostrar la propiedad de tu dominio.
Tu proveedor de dominio puede incluir este término como “Datos”.
Espera hasta 24 horas para que se propaguen tus registros TXT actualizados. Luego, haz clic en Verificar.
Ten en cuenta que puedes hacer clic en Cancelar para cerrar de forma segura la ventana Conectar dominio y volver a abrirla más tarde. Esto no afecta el tiempo de propagación, pero se te pedirá que vuelvas a ingresar el nombre del dominio cuando abras la ventana de nuevo.
Después de un tiempo de propagación amplio, si haces clic en Verificar en la ventana Conectar dominio de Firebase console, puedes comenzar el proceso de aprovisionamiento de certificados SSL.
En la mayoría de los casos, la propagación de tus registros y la verificación de tu dominio ocurrirán en unas pocas horas, en función de tu proveedor de dominio. Consulta la documentación del proveedor de dominio a fin de obtener instrucciones detalladas para agregar registros TXT y tiempos de propagación.
Si aparece un mensaje de error cuando haces clic en Verificar, significa que tus registros no se han propagado o que tus valores pueden ser incorrectos.
En el asistente Agregar dominio personalizado de Firebaseconsole, selecciona Configuración rápida o Configuración avanzada.
La Configuración rápida se puede usar para dominios nuevos que actualmente no reciben tráfico o dominios que intentas transferir desde otro sitio de Hosting. Puedes usar la Configuración avanzada si ya tienes un dominio que recibe solicitudes en otro proveedor de hosting y necesitas una migración con tiempo de inactividad cero.
El asistente de Configuración avanzada te ayudará a establecer un certificado SSL y una reclamación de propiedad para permitir que Hosting entregue tráfico en el dominio antes de recibirlo.
Configuración rápida
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 Hosting. Agrega, quita y guarda registros de tu dominio en tu proveedor de DNS con las siguientes entradas:
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”.
Valor: Asigna las direcciones IP proporcionadas al valor de los registros.
Tu proveedor de dominio puede incluir este término como “Datos”, “Dirige a”, “Contenido”, “Dirección” o “Dirección IP”.
Da tiempo para que se aprovisione tu certificado SSL.
Este proceso puede tardar hasta 24 horas después de que apuntas tu DNS a Firebase Hosting.
En la mayoría de los casos, la propagación de tus registros y el aprovisionamiento de tu certificado SSL ocurrirán en unas pocas horas, dependiendo de tu proveedor de dominio.
Configuración avanzada
El modo de configuración Avanzada del asistente de Agregar dominio personalizado te permite configurar Hosting para que entregue tu dominio de forma segura antes de dirigir el tráfico a sus servidores. En general, Hosting necesita tres elementos para entregar tráfico en un dominio con éxito:
Registro de propiedad: Un registro TXT le indica a Hosting qué sitio entregar en el dominio
Certificado SSL: Un certificado específico del dominio que permite la comunicación encriptada entre los servidores de Hosting y los usuarios finales
Registros IP de Hosting: uno o más registros A y AAAA que dirigen todas las solicitudes del dominio a los servidores de Hosting
La configuración Avanzada te guía en la configuración del dominio para que Hosting se encargue de los dos primeros requisitos con anticipación, de modo que esté listo para entregar el contenido correcto antes de que comience a recibir el correspondiente a tu dominio.
Este asistente representa este proceso como un flujo de trabajo de dos pasos:
Preparar dominio
Actualiza los registros DNS: Agrega uno o más registros a tu dominio:
Propiedad: Un registro TXT con el formato “hosting-site=[site_id]”.
CAA (opcional): Es un par de registros CAA que permiten que las autoridades certificadoras de Hosting emitan un certificado SSL para tu dominio. Solo está presente si Hosting descubre registros de CAA existentes que le impiden aprovisionar un certificado.
Configurar certificado SSL: El asistente proporciona un desafío de ACME que las autoridades certificadoras de Hosting usarán para crear un certificado SSL para tu dominio. Puedes elegir entre un desafío de DNS o HTTP:
Desafío de DNS: Visita los sitios de administración de DNS de tu proveedor de dominio. Agrega un registro TXT con la clave de subdominio del desafío de ACME y el valor proporcionado. Espera hasta 24 horas para que tus registros TXT se propaguen.
Desafío de HTTP: Sube el archivo de texto proporcionado a tu sitio existente en la URL especificada y verifica su existencia.
Hosting intentará validar los desafíos de ACME antes de solicitar la verificación de su CA. Si la CA no valida tus desafíos por algún motivo (por ejemplo, problemas de servicio intermitente). Hosting tendrá que generar un nuevo conjunto de desafíos para ti. Si la verificación es exitosa, Hosting puede tardar algunas horas en aprovisionar un certificado SSL y permitir que se propague.
Dirigir a hosting
Después de que Hosting establezca la propiedad de tu dominio y aprovisione un certificado SSL, regresa a tu proveedor de DNS y agrega registros A/AAAA de DNS que dirijan solicitudes a Hosting:
Tipo: Agrega los registros A/AAAA de DNS solicitados.
Host: Ingresa la clave de dominio personalizado para ambos 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”.
Valor: Asigna un valor a cada registro A del DNS para apuntar el dominio a las direcciones IP especificadas.
Tu proveedor de dominio puede incluir este término como “Datos”, “Dirige a”, “Contenido”, “Dirección” o “Dirección IP”.
Espera el aprovisionamiento del certificado SSL
Después de verificar la propiedad del dominio, aprovisionamos un certificado SSL para tu
dominio y lo implementamos en nuestra CDN global en un plazo de 24 horas después de que dirijas tus
registros A del DNS a Firebase Hosting.
Tu dominio se mostrará en la sección de nombres alternativos de la entidad (SAN) del certificado SSL de FirebaseApp. 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 en el que falta el nombre de dominio. Esta es una parte normal del proceso y se resolverá cuando esté disponible el certificado de tu dominio.
En el caso de los usuarios de Configuración avanzada,
el proveedor de hosting anterior alojará el sitio web
hasta que el estado de configuración en la
página de Firebase Hosting
de tu proyecto
se actualice a Conectado.
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)
Solo www para el subdominio de www.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.
Cloudflare
Tipo
Host
Valor
Entradas de registro TXT del DNS
TXT
example.com
valor de verificación proporcionado en Firebase console
Entradas de registro A del DNS
A
example.com
199.36.158.100
A
www
199.36.158.100
Google Domains
Tipo
Host
Valor
Entradas de registro TXT del DNS
TXT
@
valor de verificación proporcionado en Firebase console
Entradas de registro A del DNS
A
@
199.36.158.100
A
www
199.36.158.100
Google Cloud DNS
Tipo
Host
Valor
Entradas de registro TXT del DNS
TXT
example.com
valor de verificación proporcionado en Firebase console
Entradas de registro A del DNS
A
example.com
199.36.158.100
A
www
199.36.158.100
NameCheap
Tipo
Host
Valor
Entradas de registro TXT del DNS
TXT
@
valor de verificación proporcionado en Firebase console
Entradas de registro A del DNS
A
@
199.36.158.100
A
@
199.36.158.100
Squarespace
Tipo
Host
Valor
Entradas de registro TXT del DNS
TXT
@
valor de verificación proporcionado en Firebase console
Entradas de registro A del DNS
A
@
199.36.158.100
A
www
199.36.158.100
Descripciones de los estados de la configuración de 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 Hosting.
Sugerencia para la solución de problemas: Si han transcurrido más de 24 horas, verifica si dirigiste los registros a Firebase Hosting.
En casos menos frecuentes, en especial si se usa el flujo de configuración avanzada, los desafíos de SSL pueden estar fallando debido a lo siguiente:
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 Hosting. También quita todos los registros CNAME.
La migración falló y ahora el token (los registros TXT de DNS o el archivo que se subió y proporcionó a tu sitio) no es válido.
Sugerencia para la solución de problemas: Selecciona la opción Ver de tu dominio y proporciona un token nuevo al dominio existente.
Pendiente
La configuración del dominio personalizado se realizó sin problemas, pero Firebase Hosting no ha aprovisionado un certificado SSL.
En ocasiones, los siguientes problemas pueden detener la creación de un certificado SSL para un dominio personalizado:
Tus registros CAA son muy restrictivos. Sugerencia para la solución de problemas: Asegúrate de que las autoridades certificadas “letsencrypt.org” y “pki.goog” puedan crear certificados SSL para el dominio.
El código de desafío no es válido. Si usas el flujo de Configuración avanzada y la migración falla, el token (y su código de desafío) no son válidos.
Sugerencia para la solución de problemas: Selecciona la opción Ver del dominio y
proporciona un token nuevo al dominio existente.
Solicitaste certificados para demasiados subdominios. Sugerencia para la solución de problemas: Debido a los límites de creación de certificados SSL, en general no se recomienda que un dominio personalizado principal contenga más de 20 subdominios para Firebase Hosting.
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.
