Utilizar un proxy inverso con HubSpot

• Revisado las consideraciones de configurar un proxy inverso.
• Configurado el proxy en tu entorno externo. La guía incluye instrucciones generales, así como instrucciones específicas para proveedores como Amazon CloudFront y nginx.
• Confirmado que la configuración es correcta. Esta guía también incluye los pasos para la solución de problemas si aparece un error 404 durante el proceso.
• Añadido el dominio a HubSpot para habilitar la creación de contenido en HubSpot.

​

Consideraciones

​

1. Configurar un proxy

​

Instrucciones generales

1. Configura tu proxy para que no almacene el caché de las rutas provenientes de HubSpot. HubSpot gestiona automáticamente el contenido caché de nuestra CDN, por lo que las páginas se actualizan automáticamente cuando se publica contenido. Ten en cuenta que si el servicio almacena en caché las respuestas, las páginas pueden no actualizarse durante horas o días.
2. Añade o precede un encabezado X-Forwarded-For con la dirección IP del cliente de la solicitud original. Esto es necesario para diferenciar a los clientes entre sí. Muchos servicios, como CloudFront, gestionan estos encabezados automáticamente.
3. Para garantizar que el contenido personalizado según la ubicación funcione, pasa un encabezado estático X-HubSpot-Trust-Forwarded-For: true. Esto asegurará al encabezado ​X-Forwarded-For​, que puede no haber sido actualizado por todos los proxies ascendentes.
4. Pasa un encabezado X-HS-Public-Host con el valor de tu dominio de destino.
5. Permite todos los métodos HTTP.
6. Asegúrate de que se haya provisionado e instalado un certificado SSL para tu dominio de proxy.
7. Reenvía todas las cadenas de consulta.
8. Reenvía todos los demás encabezados de solicitud y respuesta tal como están, incluidas las cookies.
9. Idealmente, todas las rutas bajo tu dominio deberían dirigirse a HubSpot. Si ese no es el caso, las siguientes rutas deben ser configuradas bajo el proxy para que los recursos se carguen correctamente desde tu dominio: /_hcms/*, /hs/*, /hubfs/*, hs-fs/hubfs/*, /hs-fs/*​, /cs/c/* y /e3t/*.

​

2. Valida que la configuración sea correcta

• Puedes identificar problemas con tu configuración en los ajustes de dominio de HubSpot:
  • En tu cuenta de HubSpot, haz clic en el ícono de configuración en la barra de navegación principal.
  • En el menú de la barra lateral izquierda, dirígete a Sitio web > Dominios y URL.
  • Junto al dominio que estás utilizando para el proxy inverso, haz clic en el menú desplegable Editar y selecciona Verificar la conexión del proxy inverso.
  • Haz clic en cualquier categoría que esté etiquetada como Fallido para ver las recomendaciones para solucionar el problema.
  • Una vez que hayas implementado las correcciones, haz clic en Actualizar prueba para validar nuevamente la configuración.

• Para todas las demás cuentas, puedes validar la configuración visitando: https://[yourFullDomain]/_hcms/diagnostics
• Verifica la siguiente información:
  • El valor de la hora actual cambia con cada carga. Esto confirma que la página no está almacenada en caché.
  • El User-Agent es consistente con tu navegador.
  • El valor de Accept-Language es consistente con tu navegador.
  • El encabezado Accept-Encoding es *. Esto garantiza que las respuestas estén comprimidas.
  • El valor Cookie no está vacío.
  • La dirección Protocol es https.
  • La dirección IP más a la izquierda en X-Forwarded-For coincide con tu dirección IP según los informes de un servicio como https://www.whatismyip.com.
  • Los valores de IP-Determined Location son precisos según tu ubicación. Estos se basan en los encabezados relacionados con la IP en X-Forwarded-For.

​

Solución de problemas

• X-Forwarded-For
• X-HubSpot-Trust-Forwarded-For
• X-HS-Public-Host

​

Clics registrados como eventos de bot

​

3. Conectar el dominio a HubSpot

• En tu cuenta de HubSpot, navega a la configuración de dominios.
• Haz clic en Conectar un dominio.
• Selecciona Primario o Secundario. Los dominios de redireccionamiento y de correos electrónico no son compatibles con esta función.
• Haz clic para desactivar el interruptor Conectar con la red de entrega de contenido (CDN) integrada de HubSpot, luego haz clic en Conectar.
• Selecciona el tipo de contenido que alojarás en el dominio y haz clic en Siguiente.
• Ingresa el dominio de la marca. Por ejemplo, para www.website.com, ingresa website.com.

• Ingresa el subdominio donde alojarás el contenido. Este subdominio debe coincidir con el subdominio del dominio alojado externamente. Luego, haz clic en Siguiente.
• Revisa el dominio que ingresaste y haz clic en Siguiente.
• Luego, verifica tu dominio para que HubSpot pueda confirmar la propiedad del dominio y permitir la publicación de contenido:
  • En tu proveedor de DNS, crea los registros con los valores proporcionados.
  • En HubSpot, haz clic en Verificar. Puede tardar hasta 4 horas en que HubSpot reconozca los cambios realizados en tu proveedor de DNS y verifique tu dominio.

​

Instrucciones específicas según proveedores

​

Configurar un proxy inverso con Amazon CloudFront

• Inicia sesión en tu cuenta de Amazon CloudFront.
• En la barra lateral izquierda, navega a Distribuciones.
• Si comienzas desde cero, primero tendrás que crear una nueva distribución haciendo clic en Crear distribución. También puedes editar una distribución existente o saltar a los pasos de configuración del origen y los comportamientos.
  • En la pestaña General, haz clic en Editar.
  • En el campo nombres de dominio alternativos (el nombre canónico), agrega el dominio, incluido el subdominio. Este debe coincidir con el dominio que agregaste a HubSpot.
  • Confirma los cambios haciendo clic en Sí, editar. Luego, regresarás a la pestaña General, donde el dominio debería aparecer junto a los Nombres de dominio alternativos (el nombre canónico).
  • También tendrás que crear un nuevo registro del nombre canónico en tu proveedor de DNS utilizando el valor del campo Nombre de dominio. Este valor debería parecerse a <value>.cloudfront.net.
• A continuación, configura un nuevo origen:
  • Haz clic en la pestaña Orígenes y grupos de origen.
  • Haz clic en Crear origen y ajusta su origen:
    • En el campo Dominio de origen, ingresa el valor del nombre canónico <HubID>.<suffix> de la tabla anterior. Este valor debería parecerse a 123.sites-proxy.hscoscdn20.net.
    • En Añadir encabezado personalizado, haz clic en Añadir encabezado. Luego, añade los siguientes datos de encabezado:
      • Para garantizar que el contenido personalizado basado en la ubicación funcione, puedes pasar un encabezado X-Client-IP con el valor de la IP del usuario final (preferido) o pasar un encabezado estático como X-HubSpot-Trust-Forwarded-For: true. Este último confiará en el encabezado X-Forwarded-For, el cual puede no haber sido actualizado por todos los proxies upstream.
      • Envía un encabezado X-HS-Public-Host con el valor de tu dominio de destino.
  • Haz clic en Crear para guardar tus cambios:
• Luego, configura los comportamientos de caché para las rutas de las páginas en las que alojarás el contenido de HubSpot:
  • Haz clic en la pestaña Comportamientos.
  • Haz clic en Crear comportamiento.
  • En el campo Patrón de ruta, ingresa la ruta URL de la página en la que está alojado el contenido de HubSpot. Puede ser una ruta a una página específica o una URL flexible, como un comodín. Más información sobre los patrones de ruta.
  • Haz clic en el campo Orígenes y grupos de origen y selecciona el origen que creaste anteriormente.
  • Haz clic en Guardar cambios.

​

Configurar un proxy inverso con nginx

location ~ ^(/|/some-other-path) {
    proxy_set_header Host $http_host;
    proxy_set_header X-HS-Public-Host www.example.com;
    proxy_pass_request_headers on;
    proxy_set_header X-HubSpot-Trust-Forwarded-For true;
    proxy_pass https://2XX93.sites-proxy.hscoscdnXX.net;
    proxy_ssl_name www.example.com;
    proxy_ssl_server_name on;
    proxy_set_header   X-Real-IP $proxy_protocol_addr;
    proxy_set_header   X-Forwarded-Proto  $scheme;
    proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header   X-HubSpot-Client-IP $proxy_protocol_addr;
  }

location ~ ^(/hs|/_hcms|/hubfs|/hs-fs|/cs/c) {
    proxy_set_header Host $http_host;
    proxy_set_header X-HS-Public-Host www.example.com;
    proxy_pass_request_headers on;
    proxy_set_header X-HubSpot-Trust-Forwarded-For true;
    proxy_pass https://2XX93.sites-proxy.hscoscdnXX.net;
    proxy_ssl_name www.example.com;
    proxy_ssl_server_name on;
    proxy_set_header   X-Real-IP  $proxy_protocol_addr;
    proxy_set_header   X-Forwarded-Proto  $scheme;
    proxy_set_header   X-Forwarded-For    $proxy_add_x_forwarded_for;
    proxy_set_header   X-HubSpot-Client-IP $proxy_protocol_addr;
  }

proxy_ssl_name www.example.com;
proxy_ssl_server_name on;