Proteção contra ameaças

​

Modos

• Desativado (padrão) — nenhuma verificação é realizada.
• Normal — as URLs são verificadas com base no Google Web Risk, que sinaliza páginas e sites associados a malware, engenharia social (phishing) e software indesejado. +2 créditos por URL verificada.
• Zscaler — as URLs são verificadas no tenant do Zscaler Internet Access (ZIA) da sua organização: as categorias de URL definidas pela Zscaler que você optar por bloquear, além das suas categorias de URL e listas de URLs personalizadas. Consulte o modo Zscaler abaixo. Sem taxas de verificação — a classificação é feita no seu próprio tenant.

​

Controles da política

• Lista de bloqueio personalizada — domínios exatos ou globs (por exemplo, *.example.com) que são sempre bloqueados, sem chamar o classificador.
• Lista de permissões personalizada — domínios exatos ou globs que são sempre permitidos. A lista de permissões prevalece sobre todas as outras regras, então um domínio em que você confia nunca é bloqueado.
• TLDs bloqueados — domínios de nível superior bloqueados diretamente (por exemplo, zip), com correspondência nos limites dos rótulos.
• Limite de pontuação de risco — a pontuação normalizada (0–100) a partir da qual um veredito do classificador é tratado como bloqueio. Quanto menor, mais rigoroso. O padrão é 75. Aplica-se ao modo Normal; o modo Zscaler bloqueia por categoria.
• Política de falha — o que fazer quando o classificador não puder ser acessado: bloquear (closed, o padrão e recomendado para um controle de segurança) ou permitir (open).

​

Modo Zscaler

• Classificação em linha — as URLs são classificadas pela API URL Lookup do seu tenant em categorias definidas pela Zscaler, e URLs em categorias que você bloqueou são bloqueadas.
• Regras personalizadas sincronizadas — suas categorias de URL personalizadas (listas de URLs e palavras-chave) e suas adições a categorias definidas pela Zscaler são sincronizadas do tenant de acordo com um agendamento e avaliadas diretamente pelo Firecrawl, pois a API de consulta do ZIA não retorna classificações personalizadas. Entradas removidas no ZIA desaparecem na próxima sincronização; a opção manual Sincronizar agora está disponível no painel.

​

Conecte seu tenant

​

Capacidade e comportamento

• Os resultados de Map são avaliados apenas com base em regras locais (suas listas e regras personalizadas sincronizadas), em vez de serem classificados em linha — um map pode retornar milhares de URLs, e classificá-las consumiria o orçamento por hora com links que talvez nunca sejam buscados. Cada URL ainda passa pela verificação completa quando seu scraping é iniciado.
• Os resultados de busca são classificados em linha, e os resultados bloqueados são removidos, como no modo Normal; cada resultado único consome o orçamento de consultas por hora.

​

Configurando a política

1. Abra Controles empresariais → Proteção contra Ameaças.
2. Escolha um modo, defina o limite de pontuação de risco e adicione entradas à lista de bloqueio, à lista de permissões ou TLDs bloqueados.
3. Para o modo Zscaler: insira a conexão do tenant, execute o teste de conexão, escolha as categorias a bloquear e defina o intervalo de sincronização.
4. Escolha se deseja permitir substituições por requisição e defina a política de falha.
5. Salve. As mudanças entram em vigor imediatamente — a próxima requisição será avaliada de acordo com a nova política.

​

Substituições por requisição

{
  "url": "https://example.com",
  "threatProtection": {
    "mode": "normal",
    "riskScoreThreshold": 50,
    "blacklist": ["*.risky.example"]
  }
}

​

Quando uma URL é bloqueada

{
  "success": false,
  "code": "unsafe_domain_blocked",
  "error": "This URL (https://risky.example/landing) is blocked by your organization's threat protection policy (rule: blacklist). If you believe this is a mistake, contact your organization administrator to adjust the policy (e.g. whitelist the domain)."
}

• Scraping, extração em lote, extração, agente — um alvo bloqueado retorna o erro unsafe_domain_blocked para essa URL.
• Rastreamento — uma URL inicial bloqueada faz a solicitação falhar; links bloqueados descobertos durante o rastreamento são ignorados, e o rastreamento continua.
• Busca, mapeamento — URLs bloqueadas são removidas dos resultados retornados, em vez de serem exibidas e recusadas.

​

Cobrança

• Decisões tomadas inteiramente com base na sua própria política (correspondências com lista de bloqueio, lista de permissões ou TLDs bloqueados) não acionam o classificador e não geram cobrança de taxa de verificação.
• Uma requisição bloqueada ainda é cobrada pela verificação que gerou o veredito.
• As verificações são deduplicadas dentro de um único scraping: uma reverificação de redirecionamento que resolve para a mesma URL compartilha a verificação original, enquanto um redirecionamento que chega a uma URL diferente é uma segunda verificação.
• Rastreamentos e extrações em lote verificam cada página de forma independente. Os vereditos nunca são reutilizados entre páginas — nada sobre o seu tráfego é armazenado (veja acima) — portanto, no modo Normal, espere +2 créditos por página extraída. Um link descoberto durante o rastreamento e bloqueado tem a verificação cobrada uma vez por rastreamento, não importa quantas páginas apontem para ele.
• Busca e mapeamento verificam cada URL única no conjunto de resultados uma vez por requisição, então as taxas de verificação aumentam conforme o número de resultados verificados — o que pode exceder ligeiramente o número retornado quando os resultados são limitados ao seu limit.

​

Referência de erros

​

Observações

• A política vale para toda a organização: ela se aplica automaticamente a cada chave de API e a cada endpoint.
• A lista de permissões sempre prevalece, então uma URL em um domínio explicitamente confiável nunca é bloqueada pelo classificador nem por uma regra de TLD.
• O código de erro unsafe_domain_blocked é mantido estável por compatibilidade, embora as verificações ocorram no nível da URL.
• Com a política de falha definida como closed (o padrão), uma indisponibilidade do classificador faz com que as solicitações afetadas sejam bloqueadas, em vez de serem permitidas silenciosamente.
• Com o SIEM Audit Logging configurado, cada decisão fica visível na sua trilha de auditoria: os eventos incluem a regra que determinou a decisão, o classificador consultado, as categorias de ameaça e — para URLs classificadas pelo Zscaler — uma sinalização security_alert quando a URL recebeu uma classificação de alerta de segurança.