Control caching by ignoring URL parameters - Edge Security Acceleration

Los parámetros que siguen al signo ? en una solicitud de URL pueden afectar la proporción de aciertos de caché. Cuando se habilita la función para ignorar parámetros, los nodos de DCDN eliminan los parámetros que van después del ? de la URL durante la búsqueda en la caché. Esto mejora la proporción de aciertos y reduce la cantidad de solicitudes de retorno al origen.

Notas de uso

Conflictos entre funciones

Importante

Si configura el método de procesamiento de cadenas de consulta en la función Custom Cachekey y al mismo tiempo habilita Ignore Parameters, la configuración de Custom Cachekey a nivel de regla tiene prioridad sobre la configuración global de Ignore Parameters. La función Ignore Parameters no surte efecto en las solicitudes que coinciden con la regla de caché.

Cuando una regla de caché tiene configurado el método de procesamiento de cadenas de consulta en la función Custom Cachekey, dicha configuración a nivel de regla prevalece sobre el ajuste global de Ignore Parameters. Por lo tanto, la función Ignore Parameters queda inactiva para las solicitudes que coincidan con esa regla de caché.

Para que la función Ignore Parameters surta efecto, compruebe que ninguna regla de caché tenga configurado el método de procesamiento de cadenas de consulta en la función Custom Cachekey.

Uso de Custom Cachekey como alternativa

La función Custom Cachekey ofrece un control de parámetros más flexible y permite replicar todas las configuraciones de clave de caché de la función para ignorar parámetros. Se recomienda utilizar Custom Cachekey como alternativa. A continuación se presenta una tabla que compara los métodos de configuración de ambas funciones.

Use case	Ignore parameters configuration	Custom Cachekey configuration
Ignorar todos los parámetros de solicitud en la clave de caché.	Establezca ignore parameters en Passed y deje Retain Specified Parameters vacío.	Agregue una política de procesamiento de parámetros de solicitud: establezca la acción en Yes y el nombre del parámetro en cualquier nombre de parámetro que no exista.
Conservar únicamente el parámetro de solicitud `key1` en la clave de caché.	Establezca ignore parameters en Passed y defina Retain Specified Parameters como `key1`.	Agregue una política de procesamiento de parámetros de solicitud: establezca la acción en Yes y el nombre del parámetro en `key1`.
Eliminar únicamente el parámetro de solicitud `key1` de la clave de caché.	Establezca Delete Specified Parameters en `key1`.	Agregue una política de procesamiento de parámetros de solicitud: establezca la acción en Delete y el nombre del parámetro en `key1`.

Funcionamiento

La función para ignorar parámetros incluye dos ajustes: ignore parameters y Retain Parameters in Back-to-origin Requests.

Ignore parameters

Al habilitarse, los POP de DCDN eliminan los parámetros que siguen al signo ? de una URL durante las búsquedas en la caché. De este modo, las solicitudes dirigidas al mismo recurso coinciden con la misma entrada de caché, incluso si tienen parámetros distintos.

Caso de uso	Descripción
Una URL contiene parámetros, como identificadores de usuario, que no guardan relación con el contenido del recurso.	Por ejemplo, el usuario A solicita `http://example.com/1.jpg?uid=123` y el usuario B solicita `http://example.com/1.jpg?uid=654`. Si habilita ignore parameters, el POP de DCDN utiliza `http://example.com/1.jpg` para la búsqueda en la caché, lo que permite que ambas solicitudes obtengan el mismo archivo almacenado en caché.

Retain Parameters in Back-to-origin Requests

Caso de uso	Descripción
Habilitó ignore parameters, pero necesita transmitir información del usuario al servidor de origen.	Después de habilitar Ignore Parameters, DCDN utiliza de forma predeterminada la URL sin sus parámetros para las solicitudes de retorno al origen. Al habilitar Retain Parameters in Back-to-origin Requests, DCDN emplea la URL original, incluidos los parámetros que siguen al signo `?`, en las solicitudes de retorno al origen para transmitir la información del usuario al servidor de origen.

La función para ignorar parámetros cuenta con dos modos: Retain Specified Parameters y Delete Specified Parameters. El siguiente diagrama de flujo muestra cómo DCDN procesa las solicitudes cuando se habilita ignore parameters.

Nota

La función de firma de URL tiene prioridad sobre la función para ignorar parámetros. DCDN ejecuta la validación de firma de URL antes de aplicar las reglas de ignore parameters, ya que la firma para la autenticación de tipo A se calcula con los parámetros de solicitud originales. Para obtener más información sobre cómo configurar la firma de URL, consulte Configure URL signing.

Procedimiento

Inicie sesión en la consola de DCDN.
En el panel de navegación izquierdo, haga clic en Domain Names.
En la página Domain Names, busque el nombre de dominio de destino y haga clic en Configure.
En el árbol de navegación izquierdo del nombre de dominio, haga clic en Optimization.

En la sección Ignore Parameters, haga clic en Modify, seleccione un modo y complete la configuración según sus necesidades.

Nota

Cambiar de modo elimina la configuración existente.

Modo: Retain Specified Parameters

Parámetro	Descripción	Ejemplo
Parameter Filtering	Passed: elimina los parámetros de URL que siguen al signo `?` para mejorar la proporción de aciertos de caché. Nota Si establece Parameter Filtering en Yes, pero deja vacío Retain Specified Parameters, se eliminan todos los parámetros posteriores al signo `?`. Rejected: coincide exactamente con los parámetros que van después del signo `?` en la URL.	Suponga que la URL original es `http://example.com/1.jpg?key1=1&key2=2&key3=3`: Ignorar todos los parámetros y usar la URL procesada para las solicitudes de retorno al origen Configuración: establezca Parameter Filtering en Passed, deje Retain Specified Parameters vacío y defina Retain Parameters in Back-to-origin Requests como Rejected. clave de caché: `http://example.com/1.jpg` URL de retorno al origen: `http://example.com/1.jpg` Conservar parámetros específicos y usar la URL procesada para las solicitudes de retorno al origen Configuración: establezca Parameter Filtering en Passed, defina Retain Specified Parameters como `key1` y configure Retain Parameters in Back-to-origin Requests en Rejected. clave de caché: `http://example.com/1.jpg?key1=1` URL de retorno al origen: `http://example.com/1.jpg?key1=1` Ignorar todos los parámetros y usar la URL original para las solicitudes de retorno al origen Configuración: establezca Parameter Filtering en Passed, deje Retain Specified Parameters vacío y defina Retain Parameters in Back-to-origin Requests como Passed. clave de caché: `http://example.com/1.jpg` URL de retorno al origen: `http://example.com/1.jpg?key1=1&key2=2&key3=3` Conservar parámetros específicos y usar la URL original para las solicitudes de retorno al origen Configuración: establezca Parameter Filtering en Passed, defina Retain Specified Parameters como `key1` y configure Retain Parameters in Back-to-origin Requests en Passed. clave de caché: `http://example.com/1.jpg?key1=1` URL de retorno al origen: `http://example.com/1.jpg?key1=1&key2=2&key3=3`
Retain Specified Parameters	Configure hasta 10 parámetros para conservar y sepárelos con una coma (`,`).	Si define Retain Specified Parameters como `key1`, solo se utiliza el parámetro `key1` de la URL para la coincidencia de caché.
Retain Origin Parameters	Passed: la solicitud de retorno al origen incluye todos los parámetros de la URL original. Rejected: los parámetros de la solicitud de retorno al origen son los mismos que los de la clave de caché. Solo se conservan los parámetros especificados.	Compare las URL de retorno al origen del tercer y cuarto ejemplo anteriores.

Modo: Delete Specified Parameters

Parámetro

Descripción

Ejemplo

Delete Specified Parameters

Especifique los parámetros que desea eliminar. Puede indicar hasta 10 parámetros, separados por espacios.

Suponga que la URL original es http://example.com/1.jpg?key1=1&key2=2&key3=3:

Eliminar parámetros específicos y usar la URL procesada para las solicitudes de retorno al origen
Configuración: establezca Delete Specified Parameters en key1 y defina Retain Parameters in Back-to-origin Requests como Rejected.
clave de caché: http://example.com/1.jpg?key2=2&key3=3
URL de retorno al origen: http://example.com/1.jpg?key2=2&key3=3
Eliminar parámetros específicos y usar la URL original para las solicitudes de retorno al origen
Configuración: establezca Delete Specified Parameters en key1 y defina Retain Parameters in Back-to-origin Requests como Passed.
clave de caché: http://example.com/1.jpg?key2=2&key3=3
URL de retorno al origen: http://example.com/1.jpg?key1=1&key2=2&key3=3

Retain Origin Parameters

Passed: la solicitud de retorno al origen incluye todos los parámetros de la URL original.
Rejected: los parámetros de la solicitud de retorno al origen son los mismos que los de la clave de caché. Los parámetros especificados se eliminan.

Compare las URL de retorno al origen del primer y segundo ejemplo anteriores.

Haga clic en OK.