Bot Manager Lite

O Bot Manager Lite é a edição de autosserviço do Bot Manager, instalada a partir do Azion Marketplace e executada como uma instância de função em um Firewall. A função instalada está na versão 0.2.0, é escrita em JavaScript e tira toda a sua configuração de um objeto JSON de argumentos.

A função pontua cada requisição contra 26 regras estáticas. Cada regra que a requisição corresponde soma um número fixo de pontos e, quando o total alcança ou passa o argumento threshold, a função aplica o argumento action. Uma requisição que fica abaixo do threshold segue pelo Rules Engine for Firewall até a aplicação. As regras pontuam as marcas que clientes de raspagem e de força bruta deixam: um user agent ausente, um cabeçalho Accept-Language ausente, um cookie de sessão que não verifica.

Esta página lista as 26 regras com os seus IDs, pontuações e classes, os argumentos para os quais a função entrega um padrão e o log de report que ela escreve.

Regras

Cada regra abaixo soma o seu incremento de pontuação ao total corrente da requisição, e a classe nomeia o comportamento que a regra pontua. Uma regra cujo ID está listado no argumento disabled_rules não é processada e não soma nada.

A regra 14 verifica o IP do cliente contra as Network Lists cujos IDs estão listados em reputation_network_lists, e soma 6 pontos para cada lista em que o IP é encontrado.

Dois argumentos tiram uma requisição da tabela antes de ela ser pontuada. Uma requisição cujo fingerprint está listado em good_fingerprint_list pula todas as regras acima. Com block_ai_bots definido como true, uma requisição de um user agent de IA conhecido é bloqueada antes do pipeline de pontuação, então ela não alcança regra nenhuma e não carrega ID de regra na sua linha de log.

Os IDs que uma requisição correspondeu são escritos no log de report, então os valores de disabled_rules vêm do seu próprio tráfego, e não desta tabela.

Argumentos

Uma instância do Bot Manager Lite tira toda a sua configuração de um objeto JSON, e nenhum argumento é obrigatório. O Azion Console renderiza o objeto como a seção Arguments de uma instância de função, na aba Functions Instances do firewall, e a Azion API e o Azion CLI o carregam como args. A função instalada não publica esquema de argumentos, então o editor de Arguments não tem formulário para construir a partir dele e o objeto é escrito como JSON puro.

Nada verifica esse objeto. Toda chave que uma instância carrega é armazenada e lida de volta exatamente como foi enviada, incluindo uma chave que a função nunca lê. Escreva thresold no lugar de threshold e a instância guarda thresold, a função segue pontuando contra 30 e nenhuma interface relata um problema. Um argumento alcança a função apenas sob o nome que a função lê.

Os padrões entregues são um fallback de execução, não uma cópia. Uma instância criada com {} armazena {}, então ler uma instância mostra quais argumentos essa instância define, não os valores com que a função é executada.

O Bot Manager Lite v0.2.0 entrega um padrão para oito argumentos:

log_headers é entregue com nove cabeçalhos: accept, accept-encoding, accept-language, content-type, host, referer, user-agent, x-forwarded-for e x-request-id. O array nomeia os cabeçalhos que a função escreve, e não os cabeçalhos a manter fora do log. Sete cabeçalhos nunca são escritos, qualquer que seja o conteúdo do array: authorization, cookie, proxy-authorization, set-cookie, x-csrf-token, x-api-key e x-amz-security-token. Os valores dos cabeçalhos são escritos em base64.

Os sete argumentos abaixo são documentados para o Bot Manager Lite e não são entregues com padrão na função, então Padrão documentado é o valor que a documentação informa, e não um valor lido da função instalada.

O Bot Manager documenta outros argumentos que o Bot Manager Lite não documenta, e os valores que action aceita estão listados uma vez para as duas edições. Para mais informações, consulte Argumentos.

Internal logs

internal_logs seleciona para quais requisições a função escreve uma linha de log de report. Um valor que a função não reconhece é lido como 0.

Defina internal_logs como 2 enquanto você calibra uma instância. Uma requisição que pontuou 0 ainda produz uma linha, que é o único jeito de ver que as regras foram executadas e não corresponderam a nada.

Log de report

O Bot Manager Lite escreve uma linha por requisição pontuada. A linha abre com o produto e o log_tag da instância entre colchetes, e depois carrega um objeto JSON de catorze campos:

O log_tag fica no prefixo, não no objeto, então um firewall que executa várias instâncias é diferenciado pelo colchete, e não por um campo. O objeto carrega request_id, remote_addr, fingerprint, host, http_user_agent, request_uri, geoip_country, geoip_region, asn, score, bot_category, classified, action e matched_rules. O Bot Manager escreve um objeto mais longo; o dicionário de campos das duas edições está em Logs.

score é o total acumulado da requisição em todas as regras que ela correspondeu, e matched_rules carrega os IDs que dispararam, que é de onde vêm os valores de disabled_rules. Os dois concordam com a tabela acima: a linha mostrada correspondeu às regras 1, 10, 18, 19 e 20, cujos incrementos de 8, 8, 4, 4 e 4 somam o score de 28.

bot_category é uma lista unida por vírgula das classes das regras que corresponderam, não um valor único: as regras 1 e 10 são Bad bot signatures e as regras 18, 19 e 20 são Malicious intent.

classified é um veredito relativo ao threshold, não uma propriedade da requisição em si. A mesma pontuação de 28 pelas mesmas regras é lida como legitimate sob um threshold de 30 e como bad bot sob um threshold de 1. Elevar um threshold impede que a ação seja executada e muda como o tráfego é etiquetado nos logs.

geoip_country carrega um código de país, e fingerprint carrega quatro segmentos separados por sublinhado, não um hash único. request_id correlaciona a linha com a mesma requisição nas outras ferramentas de observabilidade da Azion, e remote_addr é o IP do cliente que a regra 14 verifica contra as listas de reputação.

Recursos relacionados