Resolução de problemas

Editar online

Informações sobre como solucionar um problema com filtragem de IP.

Administrador bloqueado

A mensagem de erro 401 Unauthorized é exibida quando você tenta verificar ou acessar o sistema.

Possível causa: seu endereço IP atual está bloqueado pelas regras que você acabou de criar.

Para solucionar esse problema, tente as seguintes etapas:

  1. Aguarde até 5 minutos. O sistema possui um mecanismo de segurança que desativa automaticamente as configurações não verificadas após aproximadamente 5 minutos (o tempo pode variar de acordo com o ambiente).
  2. Após cinco minutos, você poderá acessar o sistema novamente a partir do seu endereço IP original.
  3. Analise cuidadosamente suas regras de filtragem de IP antes de reaplicá-las.
  4. Certifique-se de que seu endereço IP atual esteja explicitamente permitido nas regras.

Para evitar esse problema, considere as seguintes etapas:

  • Verifique sempre suas regras antes de aplicá-las.
  • Teste primeiro com ` `denyAll: false` para garantir que seu IP esteja sendo identificado corretamente.
  • Mantenha um método de acesso alternativo (rede diferente/VPN) disponível durante a configuração inicial.

Configuração não aplicada

As regras de filtragem de IP não estão funcionando.

Possível causa: a configuração não foi verificada dentro do intervalo de tempo.

Para solucionar esse problema, tente as seguintes etapas:

  1. Verifique se a configuração existe:
    GET /api/settings/ip-filtering

    Se retornar 404, a configuração foi desativada automaticamente.

  2. Recrie a configuração e verifique-a imediatamente.
    PATCH /api/settings/ip-filtering/verify

Não é possível determinar o endereço IP atual

Não é possível determinar qual endereço IP deve ser usado para permitir as regras.

Para solucionar esse problema, tente as seguintes etapas:

  1. Entre em contato com o administrador da sua rede para determinar o endereço IP de saída do seu gateway.
  2. Use um serviço como https://api.ipify.org para verificar seu endereço IP público.
Observação: o endereço IP do gateway de saída ou proxy é usado, mas não o endereço IP da sua máquina local

As regras não estão funcionando como esperado

O acesso é permitido ou negado contrariamente ao esperado.

Possível causa: Conflito na precedência das regras ou na notação CIDR.

Para solucionar esse problema, tente as seguintes etapas:

  1. Verifique se a notação CIDR está correta, utilize calculadoras CIDR online.
  2. Verifique a ordem das regras. A primeira regra tem prioridade máxima. Você deve colocar regras mais específicas antes das regras mais amplas.
  3. Teste com denyAll: false para determinar quais endereços IP são correspondentes.
  4. Verifique se enabled: true está definido na configuração IP.

500 Erro interno do servidor

API as chamadas retornam erros 500.

Possível causa: formato de configuração inválido ou erro do sistema

Para solucionar esse problema, tente as seguintes etapas:

  1. Valide a sintaxe JSON.
  2. Certifique-se de que todos os campos obrigatórios estejam preenchidos (enabled, denyAll, rules).
  3. Verifique se a notação CIDR é válida, por exemplo, 1xx.168.1.0/24, e não 1xx.168.1.0/33.
  4. Verifique se o token API tem as permissões corretas.
  5. Verifique os registros do servidor para obter mensagens de erro detalhadas.