문제점 해결

온라인 편집

IP 필터링 문제 해결 방법에 관한 정보.

관리자 접근 차단됨

시스템을 확인하거나 접근하려고 할 때 오류 메시지가 401 Unauthorized 표시됩니다.

가능한 원인: 방금 생성한 규칙에 의해 현재 IP 주소가 차단되었습니다.

이 문제를 해결하려면 다음 단계를 시도해 보십시오:

  1. 최대 5분까지 기다리십시오. 시스템에는 약 5분 후(환경에 따라 시간이 다를 수 있음) 검증되지 않은 구성을 자동으로 비활성화하는 안전 장치가 있습니다.
  2. 5분 후에는 원래 IP 주소로 다시 시스템에 접속할 수 있습니다.
  3. 재적용하기 전에 IP 필터링 규칙을 주의 깊게 검토하십시오.
  4. 현재 IP 주소가 규칙에서 명시적으로 허용되도록 하십시오.

이 문제를 방지하려면 다음 단계를 고려하십시오:

  • 규칙을 적용하기 전에 항상 다시 한번 확인하십시오.
  • `denyAll: `를 먼저 false로 설정하여 테스트하여 IP가 올바르게 식별되는지 확인하십시오.
  • 초기 설정 시 백업 접속 방법(다른 네트워크/VPN)을 준비해 두십시오.

구성이 적용되지 않았습니다

IP 필터링 규칙이 작동하지 않습니다.

가능한 원인: 지정된 시간 내에 구성이 확인되지 않았습니다.

이 문제를 해결하려면 다음 단계를 시도해 보십시오:

  1. 구성이 존재하는지 확인하십시오:
    GET /api/settings/ip-filtering

    반환된 값이 404인 경우, 구성이 자동으로 비활성화되었습니다.

  2. 구성을 재구성하고 즉시 확인하십시오.
    PATCH /api/settings/ip-filtering/verify

현재 IP 주소를 확인할 수 없습니다

규칙을 허용하기 위해 사용해야 하는 IP 주소를 확인할 수 없습니다.

이 문제를 해결하려면 다음 단계를 시도해 보십시오:

  1. 네트워크 관리자에게 문의하여 게이트웨이의 외부 IP 주소를 확인하십시오.
  2. 공개 IP 주소를 확인하려면 https://api.ipify.org 와 같은 서비스를 사용하세요.
참고: 발신 게이트웨이 또는 프록시 IP 주소가 사용되며, 로컬 머신의 IP 주소는 사용되지 않습니다

규칙이 예상대로 작동하지 않습니다

예상과 달리 접근이 허용되거나 거부됩니다.

가능한 원인: 규칙 우선순위 또는 CIDR 표기법 충돌.

이 문제를 해결하려면 다음 단계를 시도해 보십시오:

  1. CIDR 표기법이 올바른지 확인하십시오. 온라인 CIDR 계산기를 사용하십시오.
  2. 규칙 순서를 확인하십시오. 첫 번째 규칙이 최우선 순위를 가집니다. 더 포괄적인 규칙보다 더 구체적인 규칙을 먼저 배치해야 합니다.
  3. 테스트를 통해 일치하는 IP denyAll: false 주소를 확인하십시오.
  4. IP 구성에서 가 설정되어 enabled: true 있는지 확인하십시오.

500 내부 서버 오류

API 호출이 500 오류를 반환합니다.

가능한 원인: 잘못된 구성 형식 또는 시스템 오류

이 문제를 해결하려면 다음 단계를 시도해 보십시오:

  1. JSON 구문을 검증하십시오.
  2. 모든 필수 항목이 포함되어 있는지 확인하십시오 (enabled, denyAll, rules).
  3. CIDR 표기법이 유효한지 확인하십시오. 예를 들어, 1xx.168.1.0/24 와 같이 표기해야 하며, 1xx.168.1.0/33 와 같이 표기해서는 안 됩니다.
  4. API 토큰이 올바른 권한을 가지고 있는지 확인하십시오.
  5. 서버 로그를 검토하여 상세한 오류 메시지를 확인하십시오.