Esta guía explica una práctica no recomendada para la mayoría de las tiendas y solo se aplica en excepciones extremas.
Implementar un proxy inverso significa sustituir todos los servicios perimetrales (CDN) gestionados y optimizados por VTEX. Esto significa que la tienda será responsable por mantener efectivamente el sitio web, incluyendo configuración, monitoreo y gestión de aspectos como el paso de encabezados, cookies y la caché. VTEX no ofrece soporte o documentación para esas configuraciones específicas y no se hace responsable por los problemas que puedan surgir.
VTEX no se hace responsable por problemas en ese sistema, ya sea en una CDN propia, un servicio de WAF u otro recurso que esté delante de nuestros servidores. No tenemos visibilidad de la operación y, por lo tanto, la solución no entra en nuestros acuerdos de SLA.
Para apuntar tu propia CDN a la CDN de VTEX, debes insertar un proxy inverso delante de los servicios de VTEX. El flujo de tráfico seguirá el orden a continuación:
- Tienda: punto de origen del tráfico.
- Proxy inverso: el intermediario configurado.
- CDN de VTEX: la CDN predeterminada de VTEX.
- VTEX: los servidores finales de VTEX.
Sigue las guías que se describen a continuación para implementar un proxy inverso:
Configurar DNS
En la zona de DNS de tu dominio, debes configurar los registros DNS necesarios para dirigir el tráfico a la CDN de VTEX. Sigue las instrucciones a continuación.
Crear registro TXT
Para garantizar que tu dominio esté correctamente dirigido a la CDN de VTEX, crea un registro TXT en formato _{hostname}
con el valor {hostname}.cdn.vtex.com
.
Sustituye {hostname}
con la combinación de subdominio, dominio y dominio de nivel superior de tu tienda. Por ejemplo: www.mitienda.com
. Asegúrate de incluir _
antes del host.
Formato:
Nombre: _{hostname}Tipo: TXTValor: {hostname}.cdn.vtex.com
Ejemplo:
Nombre: _www.mitienda.comTipo: TXTValor: www.mitienda.com.cdn.vtex.com
Crear registro CNAME
Crea un registro CNAME para dirigir el tráfico de la CDN o WAF a nuestros servidores con el valor correspondiente del CNAME del dominio.
Sustituye {hostname}
con la combinación de subdominio, dominio y dominio de nivel superior de tu tienda. Por ejemplo: www.mitienda.com
.
Formato:
Nombre: {hostname}Tipo: CNAMEDestino: {hostname}.cdn.vtex.com
Ejemplo:
Nombre: www.mitienda.comTipo: CNAMEDestino: www.mitienda.com.cdn.vtex.com
Enrutar tráfico
En el archivo de configuración del proxy inverso, configura el enrutamiento de tráfico a VTEX. Asegúrate de que el encabezado Host
contenga el dominio original. Sigue el formato a continuación en los requests HTTP del proxy inverso a VTEX:
curl http://{hostname}.cdn.vtex.com/ \-H 'Host: {hostname}'
Ejemplo:
curl http://www.mitienda.com.cdn.vtex.com/ \-H 'Host: www.mitienda.com'
La forma de configurar el enrutamiento de tráfico y escribir el request HTTP puede variar dependiendo de la solución de software del proxy inverso.
Responsabilidades de los certificados SSL
Las responsabilidades de los certificados SSL se organizan de la siguiente manera cuando hay proxies inversos:
- La CDN externa (proxy inverso) gestiona el certificado SSL en la comunicación entre el cliente y la propia red.
- VTEX gestiona el certificado SSL en la comunicación entre el proxy inverso (CDN externa) y los servidores VTEX.
Para permitir generar certificados SSL, asegúrate de que todo el tráfico HTTP a /.well-known/acme-challenge/*
llegue a VTEX sin cambios, tales como redirecciones internas de HTTP a HTTPS o bloqueos de tráfico.
Algunos proxies inversos capturan esta ruta, lo que impide que VTEX pueda emitir o renovar el certificado SSL.
VTEX admite la navegación solo si:
El host apunta a VTEX a través del CNAME.
Es posible emitir y renovar certificados SSL para el host.
Si no se cumplen ambas condiciones, la navegación no funcionará y el sitio web se queda sin conexión.