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 el dominio
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 iniciar el proceso de validación.
Paso 2: Verifica la propiedad del dominio
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.
Paso 3: Activa el dominio
En la ventana Conectar dominio de Firebase console, selecciona Configuración rápida para un sitio nuevo o Configuración avanzada si ya tienes un sitio ejecutándose en otro proveedor de hosting y necesitas una migración con tiempo de inactividad cero.
Configuración rápida
Regresa al sitio de administración de DNS de tu proveedor de nombres de dominio para crear registros A del DNS que dirijan tu página a Firebase Hosting. Agrega y guarda registros 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 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”.
Da tiempo para que se aprovisione tu certificado SSL.
Esto puede demorar hasta 24 horas después de que apuntas tus registros A 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
En la ventana Conectar dominio de Firebase console, se te solicitará que proporciones un token para migrar tu sitio existente. Solo necesitas completar uno de los siguientes pasos para proporcionar el token:
Actualiza los registros TXT de DNS: Visita el sitio de administración de DNS de tu proveedor de dominio. Agrega un registro TXT con tu clave de dominio y el valor que se proporcionó.
Espera hasta 24 horas para que tus registros TXT se propaguen.
Sube un archivo a un sitio existente: Sube el token a tu sitio existente en la URL especificada y verifica su existencia.
Esta página debe entregarse a través de HTTPS y no tiene que ser válida ni segura. El token encriptado solo es válido para un intento. Si la migración falla, se generará un token nuevo para tus registros.
Da tiempo para que se aprovisione tu certificado SSL.
Esto puede tardar hasta 24 horas.
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.
Después de aprovisionar tu certificado SSL, regresa al sitio de administración de DNS de tu proveedor correspondiente para agregar registros A del DNS que dirijan tu
página a Firebase Hosting. Agrega y guarda registros 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 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 a la emisión 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.
Conectado
El dominio personalizado tiene los registros DNS adecuados y un certificado SSL. Puedes entregar el contenido de tu sitio.
Debe volver a verificarse
Es posible que Firebase requiera que vuelvas a verificar de forma manual la propiedad del dominio si el registro TXT que se agregó cuando
verificaste inicialmente tu propiedad del dominio
se modificó o quitó de la configuración de DNS del dominio.
Ten en cuenta que se permiten múltiples registros TXT con un token de verificación de sitio de Google en un solo dominio.
Exigimos que el registro TXT esté presente de forma continua en tu
configuración de DNS, ya que esto demuestra que eres el propietario del dominio y nos autoriza a
asignar y renovar certificados SSL para tu sitio.
Sugerencia para la solución de problemas: Visita la
página Hosting
del proyecto a fin de completar el proceso de nueva verificación dentro del período especificado
(generalmente 30 días) y, de ese modo, evitar que el dominio personalizado se desconecte
automáticamente de Firebase Hosting.