고급 엔지니어링 파라미터 제어

하드웨어 미세 조정, 캐시 할당, 스레드 고정 및 물리적 트레이드오프 분석 (AMEVA-Sentinel)

Release: v2.3.0 NPM Version PyPI Version Security Guard License
핵심 가치 제안 (Why It Matters)

정상적인 손님에게는 불편을 주지 않으면서도 집요한 공격자만을 족집게처럼 잡아내는 미세 감도 조율판입니다.

1. 보안 탐지 엔진 및 슬라이딩 윈도우 제어 파라미터

파라미터명 권장 설정 범위 물리적 시스템 거동 및 하드웨어 트레이드오프 상세 분석
rate_limit_window_ms 1,000 ~ 60,000 ms 슬라이딩 윈도우 시간폭. 짧을수록 버스트 DDoS 방어에 민감하며, 길수록 크롤러의 저속 지속 스크래핑을 정확히 탐지합니다.
max_requests_per_window 10 ~ 1,000 req 단일 클라이언트 IP/세션당 윈도우 내 최대 허용 요청 횟수. 초과 시 즉시 레이트리미트 차단 또는 타르핏(Tarpit)으로 격리합니다.
risk_score_threshold 0 ~ 100 (기본: 85) 자동 차단 조치 위험도 점수 임계값. 85 이상 도달 시 악성 봇으로 단정하여 실시간 트래픽을 필터링합니다.
tarpit_delay_ms 500 ~ 5,000 ms HTTP 타르핏 지연 응답 스트리밍 시간. 악성 봇의 소켓 연결을 장시간 붙잡아 공격자 측 리소스를 고갈시킵니다.
token_ttl_seconds 30 ~ 3,600 s HMAC-SHA256 클라이언트 인증 토큰 유효 기간. 재생 공격(Replay Attack)을 원천 차단합니다.
shannon_entropy_min 1.5 ~ 4.0 bit 인간 상호작용 신호(마우스/스크롤 지터)의 최소 Shannon 엔트로피 기준선. 미달 시 매크로 자동화 봇으로 판별합니다.
honeypot_endpoints Array<string> 공격자가 탐색할 법한 가짜 경로(/.env, /admin/debug). 접근 즉시 해당 IP의 위험 점수가 100으로 최대화됩니다.

2. 프로덕션 환경 구성 파일 예시

실제 배포 환경에서 최적의 방어 성능을 발휘하는 sentinel.config.json 설정 파일입니다:

{
  "rate_limit_window_ms": 60000,
  "max_requests_per_window": 120,
  "risk_score_threshold": 85,
  "tarpit_delay_ms": 2000,
  "token_ttl_seconds": 300,
  "shannon_entropy_min": 2.1,
  "honeypot_endpoints": ["/api/v1/debug", "/.env", "/wp-login.php"],
  "fail_open_on_error": false,
  "audit_trail_enabled": true
}