Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Configure uma lista de bloqueios ou de permissões de User-Agent

Última atualização: Sep 25, 2026

O cabeçalho HTTP User-Agent identifica o cliente que faz uma requisição, incluindo o sistema operacional, a versão do SO, o navegador e a versão do navegador. Configure uma lista de bloqueios ou de permissões de User-Agent para filtrar requisições pela identidade do cliente e controlar o acesso aos recursos do ApsaraVideo VOD.

Notas de uso

  • Lista de permissões: apenas as requisições com um cabeçalho User-Agent que correspondam a uma regra na lista de permissões podem acessar seus recursos.

  • Lista de bloqueios: as requisições com um cabeçalho User-Agent que correspondam a uma regra na lista de bloqueios são bloqueadas. Uma requisição bloqueada ainda pode chegar a um POP, mas o POP a rejeita e retorna o código de status HTTP 403. As requisições rejeitadas são registradas nos logs da CDN.

  • As listas de bloqueios e de permissões são mutuamente exclusivas; portanto, não é possível configurar ambas simultaneamente.

Procedimento

  1. Faça login no console do ApsaraVideo VOD.

  2. No painel de navegação à esquerda, escolha Configuration Management > CDN Configuration > Domain Names.

  3. Encontre o nome de domínio que deseja configurar e clique em configure na coluna Actions.

  4. No painel de navegação à esquerda do nome de domínio selecionado, clique em Resource Access Control.

  5. Clique na guia User-Agent Blacklist/Whitelist.

  6. Na guia User-Agent Blacklist/Whitelist, clique em Modify.

  7. Configure a Blacklist ou a Whitelist de User-Agent conforme as instruções.

    Item

    Descrição

    Type

    O tipo de lista.

    • Blacklist

      Se o cabeçalho User-Agent de uma requisição corresponder a um valor na lista de bloqueios, o acesso é negado e o sistema retorna o código de status 403.

    • Whitelist

      Apenas as requisições cujo cabeçalho User-Agent corresponda a um valor na lista de permissões podem acessar os recursos do domínio.

    Rules

    Especifique os valores de User-Agent. Separe vários valores com uma barra vertical (|). Use um asterisco () como curinga. Exemplo: curl|IE|chrome|firefox*.

    Nota
    • Para controlar o acesso de requisições com um cabeçalho User-Agent vazio, use this-is-empty-ua para representar um valor de User-Agent vazio.

      • Em uma lista de permissões: se uma regra incluir this-is-empty-ua, as requisições com um cabeçalho User-Agent vazio são permitidas.

      • Em uma lista de bloqueios: se uma regra incluir this-is-empty-ua, as requisições com um cabeçalho User-Agent vazio são rejeitadas.

    • As listas de bloqueios e de permissões de User-Agent não suportam controle de acesso em requisições sem um cabeçalho User-Agent. ative esse recurso usando o EdgeScript. Para mais informações, consulte EdgeScript overview.

  8. Clique em OK para concluir a configuração.

Exemplos de configuração

  • Exemplo 1: Configurar uma lista de permissões

    Regra: *IE*|*firefox*

    Resultado esperado: apenas as requisições enviadas do IE ou do Firefox podem acessar os recursos nos POPs.

  • Exemplo 2: Configurar uma lista de bloqueios

    Regra: *IE*|this-is-empty-ua

    Resultado esperado: as requisições enviadas do IE ou que contenham um cabeçalho User-Agent vazio são rejeitadas.