Claude Platform Docs
AdministraçãoAutenticação

Lista de IPs permitidos

Proteja sua organização limitando o acesso a endereços IP específicos nos quais você confia.

O “IP allowlisting” (lista de IPs permitidos) protege sua organização permitindo que solicitações cobertas venham apenas de intervalos de IP específicos. Isso significa que, se uma chave de API vazar, será muito mais difícil para um invasor usar a chave. Isso pode evitar vazamentos de dados e reduzir a probabilidade de você ser cobrado por uso abusivo.

Uma lista de permissões limita onde uma chave funciona, mas não por quanto tempo. Você também deve definir uma expiração de chave curta, ou migrar para a Workload Identity Federation para deixar de usar chaves estáticas. Isso é mais seguro do que usar apenas a lista de permissões.

Como funciona

Um administrador ou proprietário da organização configura uma lista de intervalos de IP nas configurações. Essa lista de intervalos abrange toda a sua organização. Para cada solicitação coberta, a Anthropic compara o endereço IP público da solicitação com a sua lista e a nega se ela não for permitida.

  • Solicitações de API para endpoints cobertos vindas de um endereço fora da lista são rejeitadas. Por exemplo, a Messages API retorna um 403 permission_error com a mensagem Your IP address isn't in this organization's allowed range.
  • Pessoas que se conectam a partir de um endereço não permitido veem uma página intitulada Your current network can’t access this organization. Os administradores da organização também são bloqueados, mas você pode, opcionalmente, dar aos administradores uma forma de voltar para evitar o bloqueio; nesse caso, eles podem acessar apenas as configurações da lista de permissões.

Organizações da Claude Platform

Onde a lista de permissões se aplica

Consulte também Limitações.

Organizações do Claude Enterprise

Uma organização do Claude Enterprise tem sua própria lista de IPs permitidos, que permite o acesso aos aplicativos que ela cobre apenas a partir de intervalos de IP específicos. Isso significa que, se o login de um usuário for roubado, será muito mais difícil para um invasor usá-lo. Essa lista abrange toda a sua organização, incluindo os proprietários. Proprietários e proprietários principais podem configurá-la. Antes de ativar a lista de permissões, leia Evite se bloquear.

Aplicativos cobertos pela lista de permissões

Usuários fora da lista perdem o acesso à sua organização em:

  • Claude em um navegador, nos aplicativos para desktop e nos aplicativos móveis
  • Claude Code, quando os usuários entram com sua conta do Claude
  • Claude in Chrome, os suplementos do Office, Cowork e Remote Tools

Isso inclui conectores e artifacts nesses aplicativos, exceto artifacts que um usuário compartilhou fora da organização. Para o Claude Science, consulte Identity and access nos controles de administração do Claude Science.

A lista de permissões também abrange a Admin API e a Compliance API, com uma chave que abrange apenas esta organização.

Consulte também Limitações.

O que os usuários podem esperar

Na web e nos aplicativos para desktop, os usuários bloqueados veem uma página intitulada Your current network can’t access this organization. Os proprietários também são bloqueados, mas você pode, opcionalmente, dar aos proprietários uma forma de voltar para evitar o bloqueio; nesse caso, eles podem acessar apenas as configurações da lista de permissões. No Claude Code, os usuários bloqueados veem um erro de API 403 com a mensagem Your IP address isn't in this organization's allowed range.

  • Outras contas: Usuários bloqueados ainda podem entrar e usar outras organizações ou uma conta pessoal.
  • Usuários remotos: Telefones usando dados móveis, Wi-Fi residencial e laptops fora da VPN ficam bloqueados até se conectarem por meio de uma rede listada.
  • Proxies: Alguns recursos se conectam por meio de bridge.claudeusercontent.com: Claude in Chrome, Cowork, Remote Tools e o trabalho entre aplicativos nos suplementos do Office. Se o seu proxy envia esse host por um endereço diferente do usado para claude.ai e api.anthropic.com, liste esse endereço também.

Limitações

  • Claude Platform: A lista de permissões abrange as solicitações aos endpoints do Claude Managed Agents, não os próprios agentes. Ela não se aplica a nenhuma comunicação de rede no runtime do Claude Managed Agents. A lista de permissões não se aplica ao Claude no Amazon Bedrock, à Claude Platform on AWS, aos Claude Models on Google Cloud nem ao Claude no Microsoft Foundry.
  • Claude Enterprise: Claude Design, Claude in Slack e Claude Academy não são cobertos. Se o Claude estiver trabalhando em uma tarefa em um chat quando um usuário for bloqueado, a tarefa pode continuar por até 24 horas. O usuário não pode abrir nem controlar esse chat de fora da lista.

Ative a lista de permissões

  1. Ative a opção

    Acesse a página de configurações da sua organização:

    Ative a opção IP allowlist. Nada muda até que você salve.

  2. Adicione seus intervalos e salve

    Clique em Add entry (Claude Console) ou Add IP range (claude.ai), insira um ou mais endereços ou intervalos, separados por vírgulas, e pressione Enter. Liste cada rede a partir da qual seus servidores, CI e usuários se conectam, incluindo aquela a partir da qual você está se conectando. A Anthropic recomenda garantir que a caixa de seleção Allow admins to access this settings page from any IP address (Claude Console) ou Allow owners to access this settings page from any IP address (claude.ai) esteja marcada para evitar o bloqueio. Em seguida, clique em Save e confirme.

  3. Verifique seu tráfego

    As alterações podem levar até 15 minutos para entrar em vigor. Monitore seus aplicativos em busca de respostas 403 permission_error, incluindo tarefas que são executadas apenas diária ou semanalmente, e adicione qualquer endereço que tenha faltado. Em uma organização do Claude Enterprise, peça aos usuários de cada rede que confirmem que ainda conseguem abrir o Claude. Nessas organizações, as alterações podem levar mais tempo para chegar a conexões que já estão abertas, aos suplementos do Office e ao Remote Tools.

Formato das entradas

  • Formato: Você pode incluir na lista de permissões endereços IPv4 ou IPv6. Cada entrada pode ser um único endereço (203.0.113.5) ou um intervalo CIDR (203.0.113.0/24, 2001:db8::/32) não mais amplo que /8 para IPv4 ou /32 para IPv6. A lista comporta até 1.000 entradas.
  • Somente endereços públicos: Liste os endereços pelos quais seu tráfego sai da sua rede, não intervalos privados como 10.0.0.0/8. Se você adicionar o endereço de um proxy compartilhado, observe que um invasor com uma chave vazada ou um login roubado poderia potencialmente usá-lo por meio do proxy.

Evite se bloquear

Quando você salva, a página de configurações verifica seu endereço atual em relação à lista para garantir que você não esteja prestes a se bloquear. Mas ela não verifica seus servidores, seus colegas de equipe ou o endereço a partir do qual você poderá se conectar amanhã.

  • Certifique-se de listar todas as redes primeiro: Inclua data centers, sistemas de CI, escritórios, VPNs, proxies e os workers de quaisquer sandboxes auto-hospedados, com seus endereços públicos IPv4 e IPv6. Observe que endereços residenciais e móveis muitas vezes podem mudar sem aviso.
  • Mantenha uma forma de voltar: A Anthropic recomenda marcar a caixa de seleção Allow admins to access this settings page from any IP address (Claude Console) ou Allow owners to access this settings page from any IP address (claude.ai). Assim, um administrador (um proprietário em claude.ai) pode corrigir a lista de qualquer lugar. A desvantagem é que um invasor que comprometa a sessão de um administrador ou proprietário poderá atualizar a lista de permissões a partir de um local remoto. Se você configurar a Compliance API para sua organização, o Activity Feed dela registra as alterações na lista de permissões, para que você possa auditá-las.

Se você estiver bloqueado

Em uma organização do Claude Enterprise, os administradores não podem alterar a lista, portanto “administrador ou proprietário” nestas etapas significa um proprietário ou proprietário principal.

  1. Reconecte-se a partir de uma rede listada: Conecte-se à rede do seu escritório ou VPN e, em seguida, clique em Try again. Se não houver um botão Try again, recarregue a página.
  2. Peça a outro administrador ou proprietário: Um administrador ou proprietário em uma rede listada pode adicionar seu endereço.
  3. Corrija a lista de onde você está: Se você for administrador ou proprietário e a caixa de seleção mencionada em Mantenha uma forma de voltar estiver marcada, abra o Claude Console ou o Claude em um navegador e clique em Open IP allowlist, ou acesse a página Identity and access (Organization and access em claude.ai). Clique em Add it para adicionar seu endereço atual, ou desative a lista de permissões, e então clique em Save e confirme. O acesso pode levar até 15 minutos para ser restabelecido.
  4. Entre em contato com a Anthropic: Se nenhum administrador ou proprietário conseguir acessar a página, peça ao suporte da Anthropic para desativar a lista de permissões.

Esta página foi útil?