Ignorar parâmetros

Ao ativar a opção de ignorar parâmetros, os nós de borda da CDN removem os parâmetros de consulta (a parte após o ?) das URLs de solicitação. Isso permite que solicitações com parâmetros diferentes acessem a mesma cópia em cache e melhora a taxa de acerto do cache. Este tópico descreve como configurar essa funcionalidade, compara-a com recursos alternativos e fornece sugestões de uso.

Comparação de recursos

Custom Cache Key entra em conflito com a funcionalidade de ignorar parâmetros. Se você configurar simultaneamente as opções de ignorar parâmetros e Custom Cache Key, a configuração de ignorar parâmetros perderá a validade.

O recurso Custom Cache Key substitui a opção de ignorar parâmetros na configuração de chaves de cache e oferece uma funcionalidade mais abrangente. Recomendamos priorizar seu uso. Veja a comparação de configurações:

Cenário	Ignorar parâmetros	Custom Cache Key
Ignorar todos os parâmetros de solicitação na chave de cache	Defina Ignore Parameters como Yes e deixe Retain Specified Parameters vazio.	Adicione uma regra de tratamento de parâmetros de solicitação: Action: Retain Parameter name: Defina como qualquer nome de parâmetro inexistente, como example-argument.
Manter apenas o parâmetro de solicitação key1 na chave de cache	Defina Ignore Parameters como Yes e configure Retain Specified Parameters como `key1`.	Adicione uma regra de tratamento de parâmetros de solicitação: Action: Retain Parameter name: key1
Excluir apenas o parâmetro de solicitação key1 da chave de cache	Exclua a configuração do parâmetro `key1`.	Adicione uma regra de tratamento de parâmetros de solicitação: Action: Delete Parameter name: key1

Rewrite Origin Parameters substitui a opção de ignorar parâmetros na reescrita de solicitações de origem e oferece uma funcionalidade mais completa. Recomendamos priorizar seu uso.

Visão geral do recurso

Função

Cenários

Remove os parâmetros de consulta (a parte após ?) das URLs de solicitação para que requisições com parâmetros diferentes acessem o mesmo arquivo em cache. Essa ação aumenta a taxa de acerto do cache e reduz o tráfego de retorno à origem.

Ative a opção de ignorar parâmetros quando os parâmetros da URL não tiverem relação com o conteúdo do recurso (como UID de usuário, fonte de referência ou códigos promocionais). Por exemplo, estas duas solicitações acessam o mesmo recurso, mas carregam UIDs diferentes:

Usuário A: http://example.com/1.jpg?uid=123***

Usuário B: http://example.com/1.jpg?uid=654***

Sem a opção de ignorar parâmetros, os nós de borda da CDN tratam essas solicitações como recursos distintos e não conseguem compartilhar o mesmo cache, exigindo uma busca na origem para cada requisição. Com a funcionalidade ativada, os nós de borda removem os parâmetros e utilizam http://example.com/1.jpg para localizar o cache.

Nota

URL signing tem precedência sobre a opção de ignorar parâmetros. A assinatura Tipo A inclui os parâmetros da URL em sua assinatura. A CDN executa a autenticação primeiro e armazena a réplica em cache somente após a validação bem-sucedida.

Manter parâmetros de origem

Função

Cenários

Mantém todos os parâmetros originais da URL durante as buscas na origem para garantir que o servidor de origem receba informações críticas do usuário.

Quando a opção de ignorar parâmetros está ativada, os nós de borda da CDN usam por padrão a URL sem parâmetros nas buscas de origem. No exemplo acima, tanto o Usuário A quanto o Usuário B acionariam uma solicitação de origem para http://example.com/1.jpg, perdendo informações importantes como o UID. Ativar a opção Retain Origin Parameters garante que a CDN utilize a URL original nas buscas de origem, preservando parâmetros como o UID para o servidor de origem.

Procedimento

Faça login no CDN console.
No painel de navegação à esquerda, clique em Domain Names.
Na lista de domínios, clique no nome de domínio desejado. No painel de navegação à esquerda, clique em Optimization para acessar a página de configuração de otimização de desempenho.
Clique em Modify na seção Ignore Parameters. Selecione um modo e conclua a configuração conforme suas necessidades.
Após concluir a configuração, clique em OK para salvar.

Importante

A troca de modos limpa as configurações existentes.
Após modificar a configuração de ignorar parâmetros, os arquivos em cache nos nós de borda não são atualizados automaticamente. Execute uma URL refresh ou directory refresh no console para aplicar a nova configuração e limpar o cache antigo. Caso contrário, os usuários podem continuar acessando conteúdo armazenado sob a política antiga, causando problemas de acesso.

Modo: Manter parâmetros especificados

Parâmetro	Descrição	Exemplo
Ignore Parameters	Yes: Ativa a opção de ignorar parâmetros para remover todos os parâmetros após `?` na URL. Nota Se você ativar Ignore Parameters mas deixar Retain Specified Parameters vazio, todos os parâmetros após `?` serão removidos. No: Desativa a opção de ignorar parâmetros para manter todos os parâmetros da URL.	Considere que a URL original seja `http://example.com/1.jpg?key1=1&key2=2&key3=3`. Os resultados para cada configuração são: Exemplo 1, ignorar todos os parâmetros, não manter parâmetros de origem: Configuração: Ignore Parameters=Yes, Retain Specified Parameters vazio, Retain Origin Parameters=No. Chave de cache: `http://example.com/1.jpg` URL de origem: `http://example.com/1.jpg` Exemplo 2, manter parâmetros especificados, não manter parâmetros de origem: Configuração: Ignore Parameters=Yes, Retain Specified Parameters=`key1`, Retain Origin Parameters=No. Chave de cache: `http://example.com/1.jpg?key1=1` URL de origem: `http://example.com/1.jpg?key1=1` Exemplo 3, ignorar todos os parâmetros, manter parâmetros de origem: Configuração: Ignore Parameters=Yes, Retain Specified Parameters vazio, Retain Origin Parameters=Yes. Chave de cache: `http://example.com/1.jpg` URL de origem: `http://example.com/1.jpg?key1=1&key2=2&key3=3` Exemplo 4, manter parâmetros especificados, manter parâmetros de origem: Configuração: Ignore Parameters=Yes, Retain Specified Parameters=`key1`, Retain Origin Parameters=Yes. Chave de cache: `http://example.com/1.jpg?key1=1` URL de origem: `http://example.com/1.jpg?key1=1&key2=2&key3=3`
Retain Specified Parameters	Insira os nomes dos parâmetros a serem mantidos. É possível especificar até 10 parâmetros, separados por vírgulas (,).
Retain Origin Parameters	Yes: Mantém todos os parâmetros originais da URL durante as buscas na origem. No: Durante as buscas na origem, inclui apenas os parâmetros consistentes com a chave de hash do cache (ou seja, os parâmetros mantidos).
Rule Condition	Uma condição de regra identifica várias informações de parâmetros em uma solicitação de usuário. Isso determina se uma configuração entra em vigor para essa solicitação. Importante Ao referenciar condições de regra, elas são correspondidas com base na prioridade das condições associadas, e não na ordem de configuração do próprio recurso. Não usar: Não utiliza uma condição de regra. Para adicionar ou editar condições de regra, gerencie-as no Rules Engine.

Modo: Excluir parâmetros especificados

Parâmetro	Descrição	Exemplo
Remove Specified Parameters	Insira os nomes dos parâmetros a serem excluídos. É possível especificar até 10 parâmetros, separados por espaços.	Considere que a URL original seja `http://example.com/1.jpg?key1=1&key2=2&key3=3`. Os resultados para cada configuração são: Exemplo 1, excluir parâmetros especificados, não manter parâmetros de origem: Configuração: Delete Specified Parameters=`key1`, Retain Origin Parameters=No. Chave de cache: `http://example.com/1.jpg?key2=2&key3=3` URL de origem: `http://example.com/1.jpg?key2=2&key3=3` Exemplo 2, excluir parâmetros especificados, manter parâmetros de origem: Configuração: Delete Specified Parameters=`key1`, Retain Origin Parameters=Yes. Chave de cache: `http://example.com/1.jpg?key2=2&key3=3` URL de origem: `http://example.com/1.jpg?key1=1&key2=2&key3=3`
Retain Origin Parameters	Yes: Mantém todos os parâmetros originais da URL durante as buscas na origem. No: Durante as buscas na origem, inclui apenas os parâmetros consistentes com a chave de hash do cache (ou seja, o resultado após a exclusão dos parâmetros especificados).
Rule Condition	Uma condição de regra identifica várias informações de parâmetros em uma solicitação de usuário. Isso determina se uma configuração entra em vigor para essa solicitação. Importante Ao referenciar condições de regra, elas são correspondidas com base na prioridade das condições associadas, e não na ordem de configuração do próprio recurso. Não usar: Não utiliza uma condição de regra. Para adicionar ou editar condições de regra, gerencie-as no Rules Engine.

Exemplos de cenários de uso

Uso da opção de ignorar parâmetros para mitigar ataques de bypass de cache via parâmetros de URL

Quando atacantes ou rastreadores adicionam parâmetros aleatórios e sem sentido (como ?timestamp=xxx ou ?random=xxx) para solicitar o mesmo recurso, a CDN trata cada solicitação parametrizada como um recurso único. Isso reduz a taxa de acerto do cache e causa picos no tráfego de retorno à origem.

Ative a opção de ignorar parâmetros (ou configure-a para ignorar todos os parâmetros) para que solicitações com parâmetros aleatórios diferentes acessem o mesmo cache, reduzindo efetivamente a pressão sobre a origem. Por exemplo, após ativar a opção de ignorar parâmetros, estas solicitações acessam o mesmo cache:

http://example.com/page.html?t=123456
http://example.com/page.html?t=789012
http://example.com/page.html?random=abc

Com a opção de ignorar parâmetros ativada, todas essas solicitações usam http://example.com/page.html para localizar o cache, mitigando eficazmente ataques de bypass de cache via parâmetros de URL.

FAQ

Se você encontrar problemas como anomalias de negócio, configuração ineficaz, erros de conteúdo no processamento de imagens do OSS ou status de acerto de cache inconsistente após ativar a opção de ignorar parâmetros, consulte Performance optimization troubleshooting guide.