Skip to main content
As listas de acesso por IP permitem que administradores Enterprise restrinjam o acesso à plataforma Devin a partir de endereços IP ou faixas CIDR específicas. Quando uma lista de acesso por IP é configurada, apenas solicitações originadas das faixas de IP permitidas podem acessar as APIs e o aplicativo web do Devin.

​
Como funciona

Quando você configura uma lista de acesso por IP, o Devin a aplica no nível da conta Enterprise:
  • Solicitações de API originadas de IPs que não estão na lista de acesso são rejeitadas com uma resposta 401 Unauthorized
  • Acesso ao aplicativo web é restrito a usuários que se conectam a partir de faixas de IP permitidas
Isso é útil para empresas que precisam garantir que o Devin seja acessado apenas a partir de redes corporativas, endpoints de VPN ou outras faixas de IP confiáveis.

​
Configurando listas de acesso por IP

As listas de acesso por IP são gerenciadas por meio da Enterprise API v3. As seguintes operações estão disponíveis:

​
Visualizando a lista de acesso atual

Obtenha a lista de acesso por IP atual da sua Enterprise:
Retorna a lista de faixas de IP atualmente permitidas.

​
Adicionando à lista de acesso

Adicione faixas de IP à lista de acesso existente sem remover nenhuma das faixas já configuradas:
O corpo da requisição deve ser um objeto JSON com um campo ip_ranges contendo uma lista de faixas de IP em notação CIDR. Endereços IP individuais podem ser especificados com o sufixo /32.
As novas faixas são mescladas à lista existente, e as faixas que já estão presentes não são duplicadas. A resposta contém a lista completa resultante de faixas de IP permitidas. Se a lista de acesso estiver vazia no momento, adicionar faixas ativa as restrições de IP.

​
Substituindo a lista de acesso

Substitua toda a lista de acesso por IP por um novo conjunto de faixas de IP:
O corpo da requisição deve ser um objeto JSON com um campo ip_ranges contendo uma lista de faixas de IP em notação CIDR. Endereços IP individuais podem ser especificados com o sufixo /32.
O endpoint PUT substitui toda a lista. Quaisquer faixas de IP que não forem incluídas na solicitação serão removidas. Certifique-se de incluir todas as faixas desejadas em cada atualização ou use o endpoint POST para adicionar faixas sem afetar as já existentes.

​
Limpando a lista de acesso

Remova todas as restrições de IP limpando a lista de acesso:
Quando a lista de acesso está vazia, não há restrições baseadas em IP.

​
Permissões

Visualizar e gerenciar listas de acesso por IP requer a permissão ManageIPWhitelist (“Gerenciar lista de permissões de IP”). Essa permissão geralmente está disponível para administradores Enterprise e pode ser concedida a uma função personalizada. Observe que ManageEnterpriseSettings não concede permissão para gerenciar listas de acesso por IP.

​
Melhores práticas

  • Inclua todos os IPs de saída do escritório e da VPN antes de ativar a lista de acesso, para evitar bloquear os usuários
  • Use faixas CIDR em vez de IPs individuais sempre que possível, para simplificar o gerenciamento
  • Faça testes primeiro com uma faixa ampla e, depois, restrinja conforme necessário
  • Mantenha um registro das faixas configuradas fora do Devin, caso precise restaurar o acesso
Se você se bloquear acidentalmente ao configurar uma lista de acesso por IP incorreta, entre em contato com support@cognition.ai para obter assistência.