Todos os produtos
Search
Central de documentação

Edge Security Acceleration:Custom cache key

Última atualização: Oct 09, 2026

Defina regras com base em strings de consulta, cabeçalhos HTTP ou cookies para gerar chaves de cache personalizadas. Isso unifica a identidade de cache para solicitações semelhantes, melhora as taxas de acerto e reduz o tempo de resposta e o consumo de largura de banda.

Como funciona

  • As chaves de cache personalizadas permitem que você modifique apenas a identidade do cache, e não a URL de retorno à origem. A solicitação de retorno à origem permanece consistente com a solicitação do cliente.

  • Uma chave de cache identifica exclusivamente um arquivo em cache em um ponto de presença (POP) do ESA. Por padrão, a chave de cache é a URL completa da solicitação do cliente, incluindo os parâmetros.

Notas de uso

Se a sua chave de cache personalizada incluir cabeçalhos de solicitação HTTP, cookies ou recursos de usuário, não será possível usar Purge cache by URL para limpar o cache de uma URL específica. Use Purge cache by custom key como alternativa.

Casos de uso

Caso de uso 1: Unificar chaves de cache

Quando as URLs de solicitação contêm parâmetros complexos, o POP do ESA trata as solicitações para o mesmo arquivo como arquivos diferentes devido à variação dos parâmetros da URL. Isso resulta em armazenamento em cache separado e aumento das solicitações de retorno à origem.

Use o recurso de chave de cache personalizada para ignorar strings de consulta. Isso unifica as chaves de cache para a mesma classe de solicitações e reduz o tráfego de retorno à origem.

image

Caso de uso 2: Diferenciar chaves de cache

Quando as URLs de solicitação do cliente são idênticas, o ESA as trata como solicitações para o mesmo arquivo. No entanto, o campo client no cabeçalho da solicitação HTTP pode indicar diferentes sistemas clientes que solicitam conteúdos distintos.

Use o recurso de chave de cache personalizada para gerar chaves de cache diferentes com base no tipo de cliente, garantindo que cada solicitação seja mapeada para um arquivo em cache distinto.

image

Procedimento

Quando as regras são aplicadas, o sistema avalia as solicitações de acordo com Rules.

  1. No console do ESA, selecione Websites e, na coluna Websites, clique em um site de destino.

  2. No painel de navegação à esquerda, escolha Websites > Website.

  3. Para prosseguir, crie uma regra através do botão Rules e insira um Cache Rules.

  4. Em Create Rule, defina as condições de correspondência para as solicitações recebidas. Para saber mais sobre como criar uma expressão de regra, consulte Composition of a rule expression.

  5. Na seção Rule Name, defina If requests match... como Cache Eligibility.

  6. Na seção Cache Eligibility, clique em Eligible for Cache e defina os seguintes parâmetros.

    Parâmetro

    Descrição

    Custom Cache Keys

    Especifica se o recurso Sort Query String está ativado (ative se necessário).

    Configure

    Defina se o ? e a query string subsequente serão removidos da URL da solicitação.

    Sort Query Strings

    • Query String: Adiciona os nomes e os valores dos cabeçalhos de solicitação HTTP especificados à chave de cache.

    • HTTP Request Header: Adiciona os nomes dos cabeçalhos de solicitação HTTP à chave de cache se eles existirem na solicitação.

    Include these header names and values (enter header name; lowercase only)

    • Check existence (enter header name; lowercase only): Adiciona os nomes e os valores dos parâmetros de cookie especificados à chave de cache.

    • Cookie: Adiciona os nomes dos parâmetros de cookie à chave de cache se eles existirem na solicitação.

    • Tipos de caracteres de entrada aceitos:

      • Símbolos: ! # $ % & ' * + - . ^ _ ` | ~

      • Dígitos: 0-9

      • Letras: a-z (letras minúsculas do alfabeto inglês)

    Include these cookie names and values (enter cookie name; lowercase only)

    • Check existence (enter header name; lowercase only): Gera uma chave de cache com base no tipo de cliente, derivado do cabeçalho User-Agent. Valores válidos: desktop, tablet, mobile

    • User: Gera uma chave de cache com base no país ou na região do cliente, derivado do endereço IP do cliente.

    • Device Type: Gera uma chave de cache com base no idioma do cliente, derivado do cabeçalho de solicitação Accept-Language.

    Country/Region

    Protege contra ataques de web cache deception, permitindo que o conteúdo estático seja armazenado em cache.

  7. Clique em Language.

Exemplos de configuração

Cenário de exemplo

  • URL de solicitação do usuário: http://www.example.com/image.jpg?key123=321&key456=654

  • Cabeçalhos de solicitação incluídos na solicitação do usuário:

    • name123:321

    • name456:654

    • User-Agent:Mozilla/5,0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537,36 (KHTML, like Gecko) Chrome/126,0.X.X Safari/537,36

    • Accept-Language:zh-CN

  • O cliente usa um endereço IP da China Telecom para acessar o service.

Configuração do recurso

  • Cache Deception Defense: exclua parameter key456

  • OK:

    • Query String: name123

    • HTTP Request Header: name456

  • Include these header names and values (enter header name; lowercase only): Para este cenário, ative as opções Check existence (enter header name; lowercase only), User e Device Type.

Chave de cache gerada

Fragmentos da chave de cache para cada parâmetro:

  • http://www.example.com/image.jpg?key123=321

  • name123:321

  • name456

  • desktop

  • CN

  • Accept-Language:zh-CN

A chave de cache final é a concatenação destes fragmentos: http://example.com/image.jpg?key123=321name123:321name456desktopCNAccept-Language:zh-CN

Documentação relacionada

Os recursos relacionados a regras variam em prioridade efetiva, reentrância e granularidade efetiva. Para obter detalhes, consulte Characteristics of rule-based features.