Ignorar parâmetros

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

Comparação de recursos

Custom Cache Key entra em conflito com o recurso de ignorar parâmetros. Se você configure o recurso de ignorar parâmetros e a Custom Cache Key simultaneamente, o recurso de ignorar parâmetros se tornará inválido.

A Custom Cache Key pode substituir o recurso de ignorar parâmetros na configuração da chave de cache e oferece uma funcionalidade mais abrangente. Recomendamos priorizar o seu uso. Comparação de configurações:

Cenário	Ignorar parâmetros	Custom Cache Key
Ignorar todos os parâmetros da 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 da solicitação: Action: Retain Parameter name: defina como qualquer nome de parâmetro inexistente, como example-argument.
Reter apenas o parâmetro da solicitação key1 na chave de cache	Defina Ignore Parameters como Yes e defina Retain Specified Parameters como `key1`.	Adicione uma regra de tratamento de parâmetros da solicitação: Action: Retain Parameter name: key1
exclua apenas o parâmetro da solicitação key1 da chave de cache	Exclua a configuração do parâmetro `key1`.	Adicione uma regra de tratamento de parâmetros da solicitação: Action: exclua Parameter name: key1

Rewrite Origin Parameters pode substituir o recurso de ignorar parâmetros na reescrita de solicitações de origem e oferece uma funcionalidade mais abrangente. Recomendamos priorizar o seu uso.

Visão geral do recurso

Função

Cenários

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

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

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

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

Sem o recurso de ignorar parâmetros, os nós de borda da CDN tratam essas solicitações como recursos diferentes e não conseguem compartilhar o mesmo cache, exigindo uma busca na origem para cada solicitação. Com o recurso de ignorar parâmetros ativado, os nós de borda da CDN retiram os parâmetros e usam http://example.com/1.jpg para corresponder ao cache.

Nota

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

Reter parâmetros de origem

Função

Cenários

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

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

Procedimento

Faça logon no console da CDN.
No painel de navegação à esquerda, clique em Domain Names.
Na lista de domínios, clique no nome do domínio de destino. No painel de navegação à esquerda, clique em Optimization para acesse 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 salve.

Importante

A troca de modo limpa as configurações existentes.
Após modificar a configuração do recurso de ignorar parâmetros, os arquivos em cache nos nós de borda não se atualize automaticamente. Execute um URL refresh ou directory refresh no console para aplicar a nova configuração e atualize o cache antigo. Caso contrário, os usuários ainda poderão acessar o conteúdo em cache sob a política antiga, causando problemas de acesso.

Modo: Reter parâmetros especificados

Parâmetro	Descrição	Exemplo
Ignore Parameters	Yes: ative o recurso 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: desative o recurso de ignorar parâmetros para reter todos os parâmetros da URL.	Suponha que a URL original seja `http://example.com/1.jpg?key1=1&key2=2&key3=3`. Os resultados de cada configuração são os seguintes: Exemplo 1, ignorar todos os parâmetros, não reter 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, reter parâmetros especificados, não reter 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, reter 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, reter parâmetros especificados, reter 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 retidos. Especifique até 10 parâmetros, separados por vírgulas (,).
Retain Origin Parameters	Yes: retém todos os parâmetros originais da URL durante as buscas na origem. No: durante as buscas na origem, inclua apenas os parâmetros consistentes com a chave de hash do cache (ou seja, os parâmetros retidos).
Rule Condition	Uma condição de regra identifica diversas informações de parâmetros em uma solicitação do usuário. Isso determina se uma configuração entra em vigor para essa solicitação. Importante Ao referenciar condições de regra, a correspondência ocorre com base na prioridade das condições de regra associadas, e não na ordem de configuração do próprio recurso. Do not use: não utiliza uma condição de regra. Para adicionar ou edite condições de regra, gerencie-as no Rules Engine.

Modo: exclua parâmetros especificados

Parâmetro	Descrição	Exemplo
Remove Specified Parameters	Insira os nomes dos parâmetros a serem excluídos. Especifique até 10 parâmetros, separados por espaços.	Suponha que a URL original seja `http://example.com/1.jpg?key1=1&key2=2&key3=3`. Os resultados de cada configuração são os seguintes: Exemplo 1, exclua parâmetros especificados, não reter parâmetros de origem: Configuração: exclua 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, exclua parâmetros especificados, reter parâmetros de origem: Configuração: exclua 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: retém todos os parâmetros originais da URL durante as buscas na origem. No: durante as buscas na origem, inclua 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 diversas informações de parâmetros em uma solicitação do usuário. Isso determina se uma configuração entra em vigor para essa solicitação. Importante Ao referenciar condições de regra, a correspondência ocorre com base na prioridade das condições de regra associadas, e não na ordem de configuração do próprio recurso. Do not use: não utiliza uma condição de regra. Para adicionar ou edite condições de regra, gerencie-as no Rules Engine.

Exemplos de cenários de uso

Uso do recurso de ignorar parâmetros para mitigar ataques de bypass de cache via parâmetros de URL

Quando invasores 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 exclusivo. Isso reduz a taxa de acerto do cache e aumenta abruptamente o tráfego de retorno à origem.

ative o recurso de ignorar parâmetros (ou configure-o para ignorar todos os parâmetros) para que as solicitações com parâmetros aleatórios diferentes acessem o mesmo cache, reduzindo efetivamente a pressão sobre a origem. Por exemplo, após ative o recurso 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 o recurso de ignorar parâmetros ativado, todas essas solicitações usam http://example.com/page.html para corresponder ao cache, mitigando efetivamente os ataques de bypass de cache via parâmetros de URL.