> ## 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. # Gerenciar a lista de IPs permitidos no Console > Adicione endereços confiáveis, escolha se a lista vale para o acesso ao console, para o acesso à API ou para os dois, e desative-a na página Segurança do Lerian Console. Este guia mostra como gerenciar a [lista de IPs permitidos](https://docs.lerian.studio/pt/platform/access-manager/features/ip-allowlist/overview) pelo Console. Você adiciona endereços, escolhe onde a lista se aplica e a desativa quando não precisa mais dela. ## Antes de começar *** Você precisa da permissão `security` com a ação `get` para abrir a página e da ação `put` para mudar a lista. O papel de administrador padrão da Lerian tem as duas. Sem `get`, a página mostra "Você não está autorizado a acessar esta página." Saiba de qual endereço você se conecta. O Console mostra esse endereço em várias caixas de diálogo e no botão **Adicionar meu IP**. Se você se conecta por uma VPN ou por um proxy corporativo, o endereço que você vê é o daquela VPN ou proxy. ## Abrir a aba Lista de IPs permitidos *** **1. Abra Configurações** Clique no ícone de engrenagem () na barra de navegação superior. **2. Selecione Segurança** Selecione **Segurança** na barra lateral de Configurações. O título da página é "Segurança". **3. Selecione a aba Lista de IPs permitidos** A página abre na aba **Single Sign-On**. Selecione a aba **Lista de IPs permitidos**. Você também pode abrir o caminho `/settings/security?tab=ip-allowlist` diretamente. ![A página Security no Console, aberta na aba IP allowlist. O banner âmbar diz "IP allowlist inactive" e a caixa de estado vazio diz "No IP addresses registered. While the list is empty, access is not restricted." Os botões "Add my IP" e "Add IP" ficam acima da caixa.](https://mintcdn.com/lerian-49cb71fc/kktgwl8ajkkMHFzZ/images/en/console/security-ip-allowlist-empty.png?fit=max\&auto=format\&n=kktgwl8ajkkMHFzZ\&q=85\&s=bc6b84025d249245cd3429fb75bf570a) Figura 1. A aba Lista de IPs permitidos com a lista vazia ## Ler a página *** O subtítulo da aba diz "Restrinja o acesso à plataforma a uma lista de endereços IP confiáveis." Um banner de status diz se a plataforma aplica a lista agora: | Banner | Cor | Descrição mostrada | | - | - | - | | Lista de IPs permitidos inativa | Âmbar | "O acesso não é restrito. Adicione um endereço IP para ativar a lista de permitidos." | | Lista de IPs permitidos inativa | Âmbar | "A lista está salva mas não é aplicada em lugar nenhum — o acesso não está restrito. Escolha abaixo onde ela vale." | | Lista de IPs permitidos ativa | Verde | "Apenas os endereços IP abaixo conseguem entrar e usar o console. O acesso à API não está restrito." | | Lista de IPs permitidos ativa | Verde | "Apenas os endereços IP abaixo conseguem acessar a API com as suas credenciais. O acesso ao console não está restrito." | | Lista de IPs permitidos ativa | Verde | "Apenas os endereços IP abaixo conseguem entrar no console ou acessar a API com as suas credenciais." | Três botões ficam acima da lista: * **Adicionar meu IP** inclui o endereço de onde você se conecta. Quando o Console não consegue determiná-lo, ele desabilita o botão e mostra o tooltip "Não foi possível determinar o seu endereço IP." * **Adicionar IP** abre um painel lateral onde você digita um endereço ou uma faixa. * **Desativar** aparece apenas quando a lista tem pelo menos uma entrada. ## Adicionar um endereço *** **1. Abra o painel lateral** Clique em **Adicionar IP**. O painel lateral "Adicionar endereço IP" abre com a descrição "Adicione um endereço IP ou faixa CIDR à lista de permitidos." **2. Digite o endereço ou a faixa** Preencha **Endereço IP ou faixa CIDR**. O placeholder mostra as formas aceitas, como `203.0.113.5` ou `203.0.113.0/24`. Se quiser, preencha **Descrição** com um rótulo de até 255 caracteres, por exemplo "Escritório de São Paulo". A descrição é só um rótulo e não muda o acesso. Para incluir o seu próprio endereço, clique em **Adicionar meu IP** dentro do painel. Quando o Console conhece o seu endereço, o botão o mostra entre parênteses. A entrada mantém a descrição que você digitou. **3. Salve** Clique em **Salvar**. O Console valida a entrada antes de salvá-la. O Console recusa dois tipos de entrada: * Um valor que não é um endereço nem uma faixa CIDR mostra "Insira um endereço IP ou intervalo CIDR válido". * Um valor que já está na lista mostra "Esta entrada já está na lista." `203.0.113.5` e `203.0.113.5/32` contam como a mesma entrada. ### Quando você adiciona a primeira entrada Quando você adiciona a primeira entrada, o Console pede sua confirmação com a caixa de diálogo "Ativar a lista de IPs permitidos?". O texto diz: > Uma vez ativada, apenas as requisições vindas dos endereços IP listados são aceitas nas superfícies marcadas em "Onde esta lista é aplicada". Seu IP atual é `{ip}`. Clique em **Ativar** para continuar ou em **Mudei de ideia** para voltar. ### Quando o seu endereço não está na lista A lista pode valer para o **Acesso ao console** e não cobrir o endereço de onde você se conecta. Se o seu endereço não é um endereço de rede privada, o Console o inclui na lista antes de salvar. Depois ele mostra o aviso "Adicionamos também o seu IP atual (`{entry}`)". O aviso explica o motivo e como excluir a entrada depois. Se a lista não tem espaço para o seu endereço, o Console abre a caixa de diálogo "Não foi possível incluir o seu IP atual nesta lista". ### Quando o seu endereço é de rede privada Você pode se conectar de um endereço de rede privada que uma lista para o **Acesso ao console** não cobre. Nesse caso, o Console pergunta antes. A caixa de diálogo "Identificamos seu acesso vindo de `{ip}`, um endereço de rede privada" explica que o endereço pode ser da sua VPN ou de um proxy. Clique em **Incluir mesmo assim** para adicioná-lo, ou em **Continuar sem incluir** para deixá-lo de fora. ## Escolher onde a lista se aplica *** A seção "Onde esta lista é aplicada:" aparece abaixo da tabela quando a lista tem pelo menos uma entrada. Ela tem duas caixas de seleção: * **Acesso ao console**: "apenas os endereços acima conseguem entrar e usar o console". * **Acesso à API**: "apenas os endereços acima conseguem usar a API com suas credenciais". O Console salva cada mudança assim que você marca ou desmarca uma caixa de seleção. ### Aplicar a lista ao acesso à API Quando você marca **Acesso à API**, o Console pede sua confirmação. A caixa de diálogo "Suas integrações precisam estar na lista acima" abre. Ela cita os sistemas que usam a API com suas credenciais: webhooks, ERPs, jobs agendados, tokens de aplicação. Ela pede que você revise a lista antes de confirmar. Clique em **Aplicar ao acesso à API** para confirmar. > [!WARNING] > > Não marque **Acesso à API** até que o endereço de saída de cada integração esteja na lista. ### Desmarcar as duas caixas de seleção Se você desmarca as duas caixas de seleção, a lista continua salva mas não faz nada. O banner fica âmbar. A nota abaixo das caixas de seleção diz "A lista está salva, mas não é aplicada em lugar nenhum — o acesso não está restrito." ## Excluir uma entrada *** **1. Encontre a entrada** Encontre a linha na tabela. A coluna "Endereço IP / CIDR" mostra a entrada, e a coluna "Descrição" mostra o rótulo dela. O rodapé diz "Exibindo N entradas de IP." **2. Clique no ícone de lixeira** Clique no ícone de lixeira ("Excluir") na linha. A caixa de diálogo "Remover esta entrada?" abre. **3. Confirme** Leia o texto "Após a remoção, as requisições vindas desta faixa de IP não serão mais permitidas." Clique em **Sim, remover**. A exclusão pode deixar o seu endereço fora de uma lista para o **Acesso ao console**. Nesse caso, o Console abre em seguida a caixa de diálogo "Seu IP não está nesta lista". Ela avisa que você pode perder o acesso a este workspace se salvar. Clique em **Salvar mesmo assim** apenas se você controla outro endereço da lista. Excluir a última entrada desativa a lista, então o Console mostra a caixa de diálogo de desativação. ## Desativar a lista *** A desativação remove cada entrada. **1. Clique em Desativar** Clique em **Desativar** acima da tabela. **2. Confirme** A caixa de diálogo "Desativar a lista de IPs permitidos?" diz "Isso remove todas as entradas e permite novamente o acesso a partir de qualquer IP." Clique em **Sim, desativar**. ![A caixa de diálogo "Deactivate the IP allowlist?" sobre a página Security. O corpo diz "This clears every entry and allows access from any IP address again." Os botões dizem "I changed my mind" e "Yes, deactivate".](https://mintcdn.com/lerian-49cb71fc/kktgwl8ajkkMHFzZ/images/en/console/security-ip-allowlist-deactivate-dialog.png?fit=max\&auto=format\&n=kktgwl8ajkkMHFzZ\&q=85\&s=fa5b71ef7f692b72f8488e7c23e6111b) Figura 2. A caixa de diálogo de desativação > [!TIP] > > Para pausar a lista sem perder as entradas, desmarque as duas caixas de seleção. As entradas continuam salvas e você pode aplicá-las de novo depois. ## Mensagens que o Console mostra *** Depois de uma mudança bem-sucedida, o Console mostra "Lista de IPs permitidos atualizada". Quando a plataforma recusa uma mudança, o Console mostra a recusa em uma notificação. Os [erros da API](https://docs.lerian.studio/pt/platform/access-manager/features/ip-allowlist/api.md#errors) listam as causas. ## Páginas relacionadas *** > [card] [Lista de IPs permitidos](https://docs.lerian.studio/pt/platform/access-manager/features/ip-allowlist/overview) > > O que o recurso protege, como ele decide e o que ele não cobre. > [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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.