Skip to main content
As Restrições de IP permitem que sua equipe mantenha uma lista de permissões de endereços IP e intervalos CIDR de onde as solicitações à API devem se originar. A lista de permissões é aplicada no servidor durante a autenticação em todas as solicitações autenticadas, portanto, uma chave de API vazada ou exfiltrada é inútil fora das suas redes aprovadas. A lista de permissões tem escopo de equipe: ela se aplica a todas as chaves de API da equipe de uma só vez.
As Restrições de IP são um recurso Enterprise e são habilitadas por organização. Entre em contato com a equipe da sua conta Firecrawl para habilitá-las na sua conta.
Este é o controle de entrada — de onde suas solicitações para a Firecrawl podem vir. Se você estiver procurando a direção de saída (IPs de egresso estáticos para o tráfego da Firecrawl em direção aos seus sistemas, para que você possa incluir a Firecrawl na lista de permissões), consulte recursos Enterprise.

O que você pode incluir na lista de permissões

As entradas podem ser:
  • Endereços IPv4 individuais — por exemplo, 203.0.113.7
  • Endereços IPv6 individuais — por exemplo, 2001:db8::1
  • Faixas CIDR, IPv4 ou IPv6 — por exemplo, 10.0.0.0/8, 2001:db8::/32
Clientes que se conectam por IPv6 mapeado para IPv4 (::ffff:203.0.113.7) são normalizados para o formato IPv4 antes da verificação de correspondência, portanto uma entrada IPv4 também os cobre. A lista de permissões só é aplicada quando não está vazia. Uma lista de permissões vazia significa que não há restrição, portanto uma equipe nunca pode se bloquear antes de configurar qualquer IP.

Configurando a lista de permissões

Os administradores da equipe gerenciam a lista de permissões em Enterprise Controls → IP Restriction no painel. Adicione ou remova entradas e salve — as mudanças entram em vigor em cerca de um minuto.

Aplicação

A verificação é executada durante a autenticação, portanto cobre uniformemente todos os pontos de acesso autenticados: todas as versões da API, endpoints de status e cancelamento de job e conexões de status via websocket. Não há como ignorá-la no nível da request. Uma request de um IP que não está na lista de permissões é rejeitada com um 403:

Referência de erros

Notas

  • As restrições de IP não geram cobrança de créditos.
  • As restrições de IP são independentes das Restrições de chave; uma equipe pode usar ambas, e uma única chave pode ser limitada por formato, endpoint e rede de origem ao mesmo tempo.