Todos os produtos
Search
Central de documentação

Edge Security Acceleration:Custom cache key

Última atualização: Jun 29, 2026

Defina regras com base em strings de consulta, cabeçalhos HTTP ou cookies para gerar chaves de cache personalizadas. Essa configuração 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 modificam apenas a identidade do cache, sem alterar a URL de back-to-origin. A solicitação de back-to-origin permanece idêntica à solicitação do cliente.

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

Observações de uso

Se a chave de cache personalizada incluir cabeçalhos de solicitação HTTP, cookies ou características do usuário, não será possível usar a opção Purge cache by URL para limpar o cache de uma URL específica. Nesse caso, utilize Purge cache by custom key.

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 requisições para o mesmo arquivo como arquivos distintos devido às variações nos parâmetros da URL. Esse comportamento resulta em armazenamento separado e aumenta as solicitações de back-to-origin.

Use o recurso de chave de cache personalizada para ignorar strings de consulta. Essa ação unifica as chaves de cache para a mesma classe de solicitações e reduz o tráfego de back-to-origin.

image

Caso de uso 2: Diferenciar chaves de cache

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

Configure a chave de cache personalizada para gerar chaves diferentes com base no tipo de cliente. Assim, cada solicitação é mapeada para um arquivo em cache específico.

image

Procedimento

Ao aplicar as regras, o sistema faz a correspondência das solicitações conforme a Rule Precedence.

  1. No console do ESA, selecione Websites e, na coluna Websites, clique em no site desejado.

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

  3. Clique em 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.

    image

    Parâmetro

    Descrição

    Custom Cache Keys

    Define se o recurso Sort Query String deve ser ativado.

    Configure

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

    Sort Query Strings

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

    • HTTP Request Header: Inclui os nomes dos cabeçalhos de solicitação HTTP na chave de cache caso eles existam na solicitação.

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

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

    • Cookie: Inclui os nomes dos parâmetros de cookie na chave de cache se os cookies estiverem presentes na solicitação.

    • Tipos de caracteres suportados para entrada:

      • 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 baseada no tipo de cliente, obtido a partir do cabeçalho User-Agent. Valores válidos: desktop, tablet, mobile

    • User: Crie uma chave de cache baseada no país ou região do cliente, determinada pelo endereço IP do cliente.

    • Device Type: Produz uma chave de cache baseada no idioma do cliente, extraído do cabeçalho de solicitação Accept-Language.

    Country/Region

    Protege contra ataques de engano de cache web e permite o armazenamento de conteúdo estático em cache.

  7. Clique em Language.

Exemplos de configuração

Cenário de exemplo

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

  • Cabeçalhos de solicitação transportados na requisiçã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 utiliza um endereço IP da China Telecom para acessar o serviço.

Configuração do recurso

  • Cache Deception Defense: Delete parameter key456

  • OK:

    • Query String: name123

    • HTTP Request Header: name456

  • Include these header names and values (enter header name; lowercase only): As opções Check existence (enter header name; lowercase only), User e Device Type estão todas ativadas.

image

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 concatena esses fragmentos: http://example.com/image.jpg?key123=321name123:321name456desktopCNAccept-Language:zh-CN

Documentação relacionada

Os recursos relacionados a regras variam quanto à prioridade efetiva, reentrância e granularidade de aplicação. Para obter detalhes, consulte Properties of Rule-Related Features.