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

# Lista de IPs permitidos

> Restrinja o acesso ao seu workspace Lerian a uma lista de endereços de rede confiáveis, para as pessoas que entram e para os sistemas que chamam a API.

A lista de IPs permitidos é uma lista de endereços de rede em que o seu workspace confia.

A lista pertence ao workspace inteiro, não a uma pessoa ou a uma application.

## O que a lista protege

***

A lista tem duas chaves. Você pode ligar uma, a outra ou as duas.

| Chave | O que ela restringe | Quem ela afeta |
| - | - | - |
| **Acesso ao console** | Pessoas que entram no Console com uma conta de usuário. | Seu time: administradores, analistas, operadores. |
| **Acesso à API** | Sistemas que chamam as APIs da Lerian com as credenciais do seu workspace. | Suas integrações: ERPs, webhooks, jobs agendados, tokens de application. |

> [!WARNING]
>
> Não ligue o **Acesso à API** antes de listar cada endereço de onde as suas integrações chamam. Esses endereços normalmente não são os mesmos que o seu time usa para acessar o Console.

## Como a plataforma decide

***

Uma requisição a uma rota protegida passa por esta verificação, nesta ordem:

1. Uma requisição chega à plataforma com as credenciais do seu workspace.
2. A plataforma descobre o endereço de rede de onde a requisição veio. Atrás do seu load balancer, ela lê o endereço que o seu proxy encaminha. No BYOC, veja [Requisitos de deploy](https://docs.lerian.studio/pt/platform/access-manager/features/ip-allowlist/deployment.md). Na Lerian Cloud, a Lerian cuida disso para você.
3. A plataforma verifica se a lista está ativa para aquele tipo de acesso, Console ou API, e se o endereço está na lista.

## O que uma pessoa ou sistema recusado vê

***

Veja a [lista de erros do Access Manager](https://docs.lerian.studio/pt/reference/platform/access-manager/access-manager-error-list.md).

## O que você pode cadastrar

***

Uma entrada é um endereço único ou uma faixa de endereços, em IPv4 ou IPv6.

| Você digita | A plataforma armazena | Por quê |
| - | - | - |
| `203.0.113.5` | `203.0.113.5/32` | Um endereço IPv4 único é uma faixa de um. |
| `2001:db8::7` | `2001:db8::7/128` | Um endereço IPv6 único é uma faixa de um. |
| `203.0.113.0/24` | `203.0.113.0/24` | Uma faixa CIDR fica como você digitou. |
| `203.0.113.77/24` | `203.0.113.0/24` | A plataforma normaliza a faixa para o endereço de rede dela. |

Regras que valem para a lista:

* Use notação CIDR para faixas. A plataforma não aceita faixas do tipo "de-até", como `203.0.113.1-203.0.113.50`.
* A plataforma une duplicatas. `203.0.113.5` e `203.0.113.5/32` são a mesma entrada.
* A plataforma recusa uma faixa mais ampla que `/24` para IPv4 ou `/48` para IPv6.
* As entradas guardadas, separadas por vírgulas, devem caber em 200 caracteres. Prefira faixas a listas longas de endereços únicos.
* Uma entrada pode ter uma descrição, como o nome do escritório. A descrição é um texto para os seus administradores. Ela não muda a decisão de acesso.

## Os estados da lista

***

| Estado | O que significa | A plataforma verifica os endereços? |
| - | - | - |
| **Vazia** | Nenhuma entrada. | Não. |
| **Salva, não aplicada** | Existem entradas, mas nenhuma chave está ligada. | Não. A lista está guardada e não faz nada. |

Uma credencial de um parceiro que tem a própria lista não vazia é verificada contra essa lista em todas as superfícies, qualquer que seja o estado da sua lista. Consulte [O campo de lista de IPs permitidos](https://docs.lerian.studio/pt/platform/access-manager/features/partners/api.md#the-ip-allowlist-field).

O Console mostra o estado atual em um banner no topo da aba Lista de IPs permitidos.

## Proteções no Console

***

O Console ajuda você a não perder o próprio acesso.

* Antes de a primeira entrada ativar a lista, o Console pede sua confirmação.
* Se a lista vale para o acesso ao console e não cobre o seu endereço, o Console inclui o seu endereço ou pergunta antes de salvar.
* Um botão **Adicionar meu IP** inclui o endereço de onde você se conecta.
* O Console pede uma confirmação separada antes de aplicar a lista ao acesso à API.

Leia o guia passo a passo em [Gerenciar a lista de IPs permitidos no Console](https://docs.lerian.studio/pt/platform/access-manager/features/ip-allowlist/console.md).

## O que a lista não cobre

***

* **Os serviços da própria plataforma da Lerian continuam funcionando.** As requisições que carregam um token interno da plataforma passam por fora da lista, para que o seu workspace não pare por acidente.
* **Não existe isenção para administrador.** Mantenha na lista pelo menos um endereço sob seu controle.
* **Acesso de emergência.** Se todos os administradores ficarem sem acesso, fale com o suporte da Lerian para restaurar o acesso.

## Próximos passos

***

> [card] [Gerencie a lista no Console](https://docs.lerian.studio/pt/platform/access-manager/features/ip-allowlist/console.md)
>
> Adicione endereços, escolha onde a lista se aplica e desative-a.

> [card] [Gerencie a lista pela API](https://docs.lerian.studio/pt/platform/access-manager/features/ip-allowlist/api.md)
>
> Leia e substitua a lista com duas operações da API do Identity, com exemplos.

> [card] [Requisitos de deploy](https://docs.lerian.studio/pt/platform/access-manager/features/ip-allowlist/deployment.md)
>
> O que um operador BYOC configura para a plataforma descobrir o endereço real de quem chamou.

> [card] [Lista de erros](https://docs.lerian.studio/pt/reference/platform/access-manager/access-manager-error-list.md)
>
> Cada código que a lista pode retornar, com título e mensagem.


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