Saltar para o conteúdo

Pontuação e desafios

Cada pedido recebe uma pontuação 0-100. Acima do limite de bloqueio é travado; numa zona cinzenta pode receber uma verificação rápida (challenge) que humanos passam e bots não.

5 min de leitura

Como a pontuação flui

Pontuação:    0 ────────── 40 ───────── 70 ───────── 100
                 PASSA      DESAFIO      BLOQUEIA
              (humano)    (verifica)     (bot)

Os números (40 e 70) são os defaults. Podes ajustá-los nas definições.

Os três caminhos de um pedido

Pontuação baixa (0-39): passa

  • Pedido parece humano. Vai direto ao site, sem fricção.
  • A maioria dos visitantes legítimos cai aqui.

Pontuação média (40-69): desafio

  • Suspeito mas não obviamente bot.
  • Em vez de bloquear, mostra uma verificação. Humanos passam em fração de segundo (a verificação resolve-se automaticamente para quem executa JavaScript normalmente). Bots ficam presos porque não passam o teste.
  • Esta é a "rede de segurança": apanha bots disfarçados sem afetar tráfego legítimo na zona cinzenta.

Pontuação alta (70-100): bloqueia

  • Bot identificado com confiança.
  • Pedido devolve 403 (ou desafio, ou só registo, conforme a ação configurada).

O desafio (challenge)

Quando ativado, em vez de bloqueio direto na zona cinzenta o visitante recebe uma página de verificação:

  • Visualmente parece uma página normal com um pequeno spinner e mensagem "A verificar...".
  • Por baixo do palco, o browser resolve um problema criptográfico (proof-of-work leve) — uns 100-500 ms num browser moderno.
  • Se passa, recebe um cookie de "humano verificado" e é encaminhado para a página que pediu. Próximos pedidos no mesmo browser durante a sessão passam direto.
  • Se falha (não executa JS, não responde, demora demasiado), é tratado como bot.

Ajustar os limites

Limite de bloqueio (block_threshold)

Define a partir de que pontuação o pedido é bloqueado:

  • Default: 70
  • Baixar (ex.: 50) → mais agressivo, mais bots apanhados, mais risco de FP
  • Subir (ex.: 85) → mais conservador, menos FP, alguns bots passam

Limite de desafio (challenge_threshold) — só relevante se o challenge estiver ligado

A partir de que pontuação mostra a verificação:

  • Default: 40
  • Tem de ser menor que o limite de bloqueio (validação do form impede o contrário).
  • Subir (ex.: 55) → menos visitantes desafiados, mas mais bots na zona cinzenta passam.
  • Baixar (ex.: 25) → mais conservador, alguns humanos com pegada estranha podem ver desafios.

Quando ativar o desafio vs bloquear direto

Liga o desafio se:

  • Tens utilizadores legítimos com perfis "estranhos" (corporate networks com proxies estranhos, browsers de privacidade, etc.).
  • Subiste a sensibilidade para Alta.
  • Queres dar uma segunda hipótese ao tráfego ambíguo.

Desativa o desafio (bloqueio direto) se:

  • Tens muito tráfego programático previsto que não consegue resolver JS (APIs internas, parceiros).
  • Estás sob ataque ativo e queres minimizar custos (cada desafio gasta um pouco de CPU no browser do atacante, mas se eles tentam milhões de vezes em IPs diferentes...).
  • Site é só para humanos e qualquer bot é hostil — bloquear direto é menos fricção quando o cliente é claramente humano (pontuação baixa) e claramente bot (pontuação alta), e a zona cinzenta é estatisticamente toda hostil.

A ação aplicada ao bloqueio

Independente do desafio, podes escolher o que acontece a pedidos acima do limite de bloqueio:

  • Bloquear o pedido — devolve 403, fim. Recomendado.
  • Mostrar verificação — mostra o challenge em vez de bloquear (mesmo na zona alta).
  • Apenas registar — não bloqueia, só anota. Útil para fase de teste.

A diferença entre "Mostrar verificação" como ação de bloqueio vs ter o desafio ligado:

  • Desafio ligado: zona cinzenta (40-69) recebe verificação; zona alta (≥70) leva a ação que escolheste.
  • Ação = "Mostrar verificação": tudo acima de 70 também recebe verificação em vez de 403.

Como ver isto nos logs

Em Atividade → Pedidos bloqueados, eventos da gestão de bots têm:

  • Pontuação de risco: o score 0-100 desse pedido.
  • Resultado: Bloqueado / Desafiado / Detetado (este último = só registo).
Em mais detalhe técnico

Implementação do challenge: a FortFox usa um sistema baseado em proof-of-work (não CAPTCHA visual) — o browser do visitante computa um SHA-256 com um nonce que o servidor lhe dá. O custo é trivial (~100-500 ms num CPU moderno) mas multiplica-se enormemente para um atacante a tentar milhares de vezes em paralelo.

Cookie de verificação: assinado HMAC-SHA256 com chave por-site. Não contém dados pessoais — só um timestamp e um nonce. Inválido cross-site, inválido após 1 hora.

Modo "log_only": o pedido passa para o site, mas o evento é registado e a métrica bot:detected é incrementada. Os contadores são separados de bot:blocked para podermos comparar "o que teria bloqueado" vs "o que bloqueou".

Failover quando o challenge não conclui: se o desafio leva mais de 5 segundos a ser submetido (típico de visitante que fechou o tab), é como se tivesse falhado — o próximo pedido do mesmo IP volta a receber o challenge, não passa.

Por-site, não global: o cookie de verificação é por hostname. Um humano que verificou em o-meu-site.pt ainda vai ter de verificar em loja.o-meu-site.pt se for um site separado na FortFox.

Próximos passos

← Toda a documentação