Uma lista de bloqueios ou de permissões de User-Agent controla o acesso a recursos em um nome de domínio acelerado com base no campo User-Agent dos cabeçalhos de requisição HTTP. Configure uma lista de bloqueios para negar clientes específicos ou uma lista de permissões para permitir apenas clientes específicos.
Tipos de listas de bloqueios e de permissões
Uma lista de User-Agent possui os seguintes tipos:
Lista de bloqueios: se o campo User-Agent de um cabeçalho de requisição HTTP corresponder à lista de bloqueios, o usuário não poderá acessar o recurso solicitado e o sistema retornará um código de status 403.
-
Lista de permissões: os usuários só poderão acessar os recursos sob o nome de domínio acelerado se o campo User-Agent do cabeçalho de requisição HTTP corresponder à lista de permissões.
Selecione o tipo com base no resultado de controle de acesso desejado:
Para bloquear clientes específicos, como navegadores IE, e permitir todos os outros, selecione Blacklist.
Para permitir apenas clientes específicos e bloquear todos os demais, selecione Whitelist.
Observações de uso
Antes de configurar uma lista de bloqueios ou de permissões de User-Agent, observe o seguinte:
O recurso de listas de bloqueios e de permissões de User-Agent não oferece suporte a controle de acesso para requisições sem cabeçalho User-Agent. Para controlar essas requisições, use o recurso EdgeScript. Para mais informações, consulte EdgeScript. Alternativamente, abra um ticket para solicitar a configuração no backend.
-
Para aplicar controle de acesso em requisições com cabeçalho User-Agent vazio, use
^$para representar esse valor. O padrão^$corresponde apenas a um valor User-Agent vazio, e não a requisições sem o cabeçalho User-Agent.Em uma lista de permissões: se uma regra contiver
^$, as requisições com cabeçalho User-Agent vazio serão permitidas.Em uma lista de bloqueios: se uma regra contiver
^$, as requisições com cabeçalho User-Agent vazio serão negadas.
Quando este recurso referencia condições de regra do Rules Engine, a ordem de execução segue a prioridade das condições configuradas no Rules Engine, e não a prioridade da configuração deste próprio recurso.
Procedimento
Faça login no console do DCDN.
Faça login no console do DCDN.
No painel de navegação à esquerda, clique em Domain Names.
No painel de navegação à esquerda, clique em Domain Names.
Na página Domain Names, localize o nome de domínio desejado e clique em Configure.
Na árvore de navegação à esquerda do nome de domínio, clique em Access Control.
Clique na aba User-Agent Blacklist/Whitelist.
-
Ative a chave User-Agent Blacklist/Whitelist. Siga as instruções na tela para configurar a Blacklist ou Whitelist de User-Agent.
Parâmetro
Descrição
Type
Tipo da lista de User-Agent. Valores válidos: Blacklist e Whitelist. Para entender o comportamento de cada tipo, consulte Tipos de listas de bloqueios e de permissões.
Rules
Ao configurar campos User-Agent, separe vários valores com barras verticais (|). Há suporte para curingas (). Exemplo:
curl|IE|chrome|firefox*.NotaPara mais informações sobre como corresponder a um valor User-Agent vazio e a requisições sem cabeçalho User-Agent, consulte Observações de uso.
Clique em OK.
Exemplos
-
Exemplo 1: Lista de bloqueios
Regra:
*IE*|^$
Resultado: quando uma requisição vem de um navegador IE ou o campo User-Agent do cabeçalho da requisição contém um valor vazio, o acesso ao recurso solicitado é negado. Requisições sem cabeçalho User-Agent não são afetadas por esta regra.
-
Exemplo 2: Lista de permissões
Regra:
*IE*|*firefox*
Resultado: apenas requisições originadas dos navegadores IE ou Firefox podem acessar o recurso solicitado. Todas as outras requisições são negadas.