Encabezados de Solicitud Personalizados
Aprende como agregar encabezados HTTP personalizados a las solicitudes de cside para identificarlas y filtrarlas en tu servidor de origen.
Descripcion general
Los encabezados de solicitud personalizados te permiten adjuntar tus propios encabezados HTTP a cada solicitud que cside realiza a tu servidor de origen. Esto facilita identificar, autenticar o filtrar el trafico de cside en tu backend.
Cuando cside obtiene tus scripts, los encabezados personalizados que configures se incluyen automaticamente en la solicitud HTTP saliente a tu origen.
Casos de uso
- Identificar trafico de cside: Agrega un encabezado como
X-Request-Source: csidepara que tu backend pueda distinguir las solicitudes de cside del trafico regular de usuarios - Autenticacion: Incluye un token de autorizacion para que tu origen pueda verificar que la solicitud proviene de cside
- Filtrado y registro: Etiqueta las solicitudes con un identificador personalizado para facilitar el filtrado de logs y analisis
- Reglas de WAF / firewall: Permite las solicitudes de cside haciendo coincidencia con un valor de encabezado conocido
Configurar encabezados personalizados
Navega a la configuracion de tu dominio en el panel de cside y desplazate hasta la seccion Custom Request Headers.
Agregar un encabezado
- Ingresa el nombre del encabezado en el campo Header name (ej.
X-Request-Id) - Ingresa el valor del encabezado en el campo Value (ej.
my-value) - Para agregar encabezados adicionales, haz clic en + Add header
- Haz clic en Save request headers para aplicar los cambios
Los cambios en los encabezados personalizados surten efecto en pocos minutos a medida que la configuracion se actualiza en todas las regiones edge.
Eliminar un encabezado
Para eliminar un encabezado, haz clic en el boton de eliminar junto a la fila del encabezado que deseas borrar, luego haz clic en Save request headers.
Como funciona
Cuando cside realiza una solicitud a tu servidor de origen para obtener el contenido del script, cualquier encabezado personalizado que hayas configurado se inyecta en la solicitud HTTP saliente. Tu servidor de origen recibe estos encabezados junto con los encabezados de solicitud estandar.
Ejemplo: Si configuras un encabezado X-Cside-Token con el valor abc123, tu origen recibira solicitudes como:
GET /your-script.js HTTP/1.1
Host: yourdomain.com
X-Cside-Token: abc123
Luego puedes usar este encabezado en la configuracion de tu servidor para identificar o autorizar solicitudes de cside. Por ejemplo, en NGINX:
location /scripts/ {
if ($http_x_cside_token = "abc123") {
# La solicitud proviene de cside
}
}
Permisos
Gestionar los encabezados de solicitud personalizados requiere el permiso Manage Domains en tu equipo. Contacta al administrador de tu equipo si no tienes acceso a esta configuracion.