> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Listas de Acesso por IP

> Restrinja o acesso à API do Devin e ao aplicativo web a endereços IP ou faixas CIDR específicas usando listas de acesso por IP do Enterprise gerenciadas pela Enterprise API v3.

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.

<h2 id="how-it-works">
  Como funciona
</h2>

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.

<h2 id="configuring-ip-access-lists">
  Configurando listas de acesso por IP
</h2>

As listas de acesso por IP são gerenciadas por meio da [Enterprise API v3](/pt-BR/api-reference/v3/ip-access-list/get-ip-access-list). As seguintes operações estão disponíveis:

* [Visualizar a lista de acesso atual](#viewing-the-current-access-list) (`GET`)
* [Adicionar faixas de IP à lista de acesso](#adding-to-the-access-list) (`POST`)
* [Substituir a lista de acesso](#replacing-the-access-list) (`PUT`)
* [Limpar a lista de acesso](#clearing-the-access-list) (`DELETE`)

<h3 id="viewing-the-current-access-list">
  Visualizando a lista de acesso atual
</h3>

Obtenha a lista de acesso por IP atual da sua Enterprise:

```bash theme={null}
GET /v3/enterprise/ip-access-list
```

Retorna a lista de faixas de IP atualmente permitidas.

<h3 id="adding-to-the-access-list">
  Adicionando à lista de acesso
</h3>

Adicione faixas de IP à lista de acesso existente sem remover nenhuma das faixas já configuradas:

```bash theme={null}
POST /v3/enterprise/ip-access-list
```

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`.

```json theme={null}
{
  "ip_ranges": ["198.51.100.0/24"]
}
```

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.

<h3 id="replacing-the-access-list">
  Substituindo a lista de acesso
</h3>

Substitua toda a lista de acesso por IP por um novo conjunto de faixas de IP:

```bash theme={null}
PUT /v3/enterprise/ip-access-list
```

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`.

```json theme={null}
{
  "ip_ranges": ["10.0.0.0/8", "192.168.1.0/24", "203.0.113.50/32"]
}
```

<Warning>
  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](#adding-to-the-access-list) para adicionar faixas sem afetar as já existentes.
</Warning>

<h3 id="clearing-the-access-list">
  Limpando a lista de acesso
</h3>

Remova todas as restrições de IP limpando a lista de acesso:

```bash theme={null}
DELETE /v3/enterprise/ip-access-list
```

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

<h2 id="permissions">
  Permissões
</h2>

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](/pt-BR/enterprise/security-access/custom-roles). Observe que `ManageEnterpriseSettings` não concede permissão para gerenciar listas de acesso por IP.

<h2 id="best-practices">
  Melhores práticas
</h2>

* **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

<Note>
  Se você se bloquear acidentalmente ao configurar uma lista de acesso por IP incorreta, entre em contato com [support@cognition.ai](mailto:support@cognition.ai) para obter assistência.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.