Copy & Run

Suricata로 pcap 파일 재생해 보기: 사용자 규칙과 alert 개수 게이트

내 PC의 웹 컨테이너 트래픽을 pcap으로 저장하고, Suricata 8.0.8이 그 파일을 읽어 평문 비밀번호 전송, 경로 이탈, 포트 스캔 규칙으로 alert를 내는지 정상 pcap과 공격 pcap으로 비교합니다. 규칙 하나가 조용히 0건이었던 이유와 alert 개수를 종료 코드로 바꾸는 방법까지 다룹니다.

실습 노트 · 2026-10-30 발행 · 10분 · 2026-10 확인

네트워크 탐지 규칙은 만들기보다 시험하기가 어렵습니다. 실제 공격을 흘려 볼 수 없고, 규칙이 조용히 아무것도 잡지 못해도 화면에는 아무 일도 일어나지 않기 때문입니다. 그래서 먼저 트래픽을 pcap 파일로 저장해 두고, Suricata가 그 파일을 읽게(replay) 하는 방식으로 규칙을 시험합니다. 같은 파일을 몇 번이든 다시 읽을 수 있고, 규칙을 고칠 때마다 결과를 비교할 수 있습니다. 이 글에서는 내 PC의 컨테이너끼리 만든 트래픽만 사용합니다. 정상 요청만 담은 pcap과 포트 스캔, 평문 로그인, 경로 이탈 요청을 담은 pcap을 만들고, 사용자 규칙으로 alert를 세어 종료 코드로 바꿉니다.

준비물

항목 확인한 값
Docker 29.5.3 (Windows 11, Git Bash에서 실행)
Suricata 8.0.8 (jasonish/suricata 이미지)
웹 서버 nginx:alpine (/login은 200, 나머지는 hello를 돌려주는 설정)
트래픽 만들기 curlimages/curl, instrumentisto/nmap
pcap 저장 nicolaka/netshoot의 tcpdump
파이썬 3.12 (eve.json을 세는 데만 사용)

모든 컨테이너는 전용 네트워크 osk-net에만 연결하고, 포트는 바깥에 열지 않았습니다. 스캔 대상도 직접 띄운 osk-web 컨테이너 하나입니다.

1. 순서 한눈에 보기

  1. osk-web(nginx)을 띄웁니다.
  2. 같은 네트워크 공간을 쓰는 tcpdump 컨테이너로 pcap 저장을 시작합니다.
  3. 클라이언트 컨테이너로 트래픽을 만듭니다. 정상 요청이면 clean.pcap, 공격 흉내이면 attack.pcap입니다.
  4. Suricata를 -r 파일로 실행해 pcap을 읽고, 내 규칙 파일 하나(-S)만 적용합니다.
  5. eve.json에서 alert 이벤트를 규칙 번호(sid)별로 세고, 허용 개수를 넘으면 종료 코드 1로 끝냅니다.

실시간 감시와 달리 시간이 파일 안의 타임스탬프로 흐르므로 같은 입력에서는 같은 결과가 나와야 합니다. 이 점이 규칙 시험에 pcap을 쓰는 가장 큰 이유입니다.

이 단계의 파일 내려받기:nginx_lab.conf

2. 사용자 규칙

local.rules에는 규칙 네 줄이 있습니다. 번호는 사용자 영역인 1000000번대를 썼습니다.

sid 잡으려는 것 핵심 조건
1000001 평문 HTTP로 password 전송 POST 요청이고 본문에 password=
1000002 경로 이탈 ../ http.uri(정규화된 주소)에 ../
1000004 경로 이탈 ../ http.uri.raw(원본 주소)에 ../
1000003 포트 스캔 의심 5초 안에 같은 출발지의 SYN이 20번 이상(threshold)

1000002와 1000004는 같은 것을 잡으려고 일부러 두 번 썼습니다. 이유는 5번에서 설명합니다.

이 단계의 파일 내려받기:local.rules

3. 정상 pcap과 공격 pcap 만들기

정상 pcap에는 GET /, GET /health, GET /index.html 세 요청만 넣었습니다. 공격 pcap에는 다음 세 가지를 넣었습니다.

  • nmap -p 1-100 -T4 osk-web: 100개 포트에 SYN을 보내는 스캔
  • curl -d 'user=admin&password=passw0rd' http://osk-web/login: 평문 로그인
  • curl --path-as-is http://osk-web/../../etc/passwd: 경로 이탈 요청(--path-as-is가 없으면 curl이 ../를 먼저 정리해 버립니다)

만들어진 파일은 정상 3,769바이트, 공격 17,658바이트였고, 스크립트를 다시 돌려도 같은 크기였습니다.

이 단계의 파일 내려받기:suricata_demo.sh

4. 재생 결과

## 2. 정상 pcap 재생
  합계 0건 (허용 0건)
  종료 코드 0
## 3. 공격 pcap 재생
  sid 1000001    1건  LAB 평문 HTTP로 password 전송
  sid 1000003    1건  LAB 짧은 시간에 SYN 다수(포트 스캔 의심)
  sid 1000004    1건  LAB 경로 이탈 ../ 요청(원본 uri)
  합계 3건 (허용 0건)
  종료 코드 1

suricata_demo.sh 실행 결과에서 정상 pcap은 alert 0건과 종료 코드 0, 공격 pcap은 규칙 세 개가 1건씩 걸려 합계 3건과 종료 코드 1이 나오고, http 이벤트로 POST /login 200과 GET /../../etc/passwd 400이 보이는 것을 확인합니다.
suricata_demo.sh 실행 결과에서 정상 pcap은 alert 0건과 종료 코드 0, 공격 pcap은 규칙 세 개가 1건씩 걸려 합계 3건과 종료 코드 1이 나오고, http 이벤트로 POST /login 200과 GET /../../etc/passwd 400이 보이는 것을 확인합니다.

  • 정상 pcap은 0건입니다. 규칙이 정상 요청을 오탐하지 않는다는 뜻입니다. 이 한 줄이 있어야 공격 쪽 숫자가 의미가 있습니다.
  • 포트 스캔은 100개 SYN인데 alert는 1건입니다. 규칙의 threshold:type both는 기준을 넘는 순간 한 번만 알리고 나머지를 묶기 때문입니다. SYN마다 alert가 쏟아지지 않아 읽기 편하지만, 개수가 곧 스캔 규모는 아닙니다.
  • 응답 코드도 같은 eve.json에 남습니다. 로그인 요청은 200, 경로 이탈 요청은 nginx가 400으로 거절했습니다. alert가 났다고 공격이 성공한 것은 아니며, 이 응답 코드를 함께 봐야 합니다.

fast.log는 같은 alert를 한 줄씩 보여 주고, 요약 스크립트는 정상 pcap에서 종료 코드 0을 냈습니다.

공격 pcap의 fast.log에 규칙 번호 1000003, 1000001, 1000004가 한 줄씩 있고, 정상 pcap의 요약은 0건과 종료 코드 0인 것을 확인합니다.
공격 pcap의 fast.log에 규칙 번호 1000003, 1000001, 1000004가 한 줄씩 있고, 정상 pcap의 요약은 0건과 종료 코드 0인 것을 확인합니다.

이 단계의 파일 내려받기:suricata_demo.sh

5. 같은 규칙인데 하나만 0건이었던 이유

경로 이탈을 잡는 규칙 두 개 중 http.uri를 쓴 1000002는 한 번도 걸리지 않았고, http.uri.raw를 쓴 1000004만 걸렸습니다. 처음에는 1000002 하나만 썼다가 공격 pcap에서 경로 이탈이 빠진 것을 보고 알았습니다. http.uri는 Suricata가 ../를 정리한 뒤의 주소를 보기 때문으로 보이며, 원본을 보려면 http.uri.raw를 써야 했습니다. 내부 처리 방식은 소스까지 확인하지 않았고 결과만 확인한 것입니다.

여기서 얻는 교훈은 규칙이 조용히 0건이면 "공격이 없었다"와 "규칙이 틀렸다"를 구분할 수 없다는 점입니다. 그래서 규칙마다 일부러 걸리는 pcap을 하나씩 두고 걸리는지 확인해야 합니다.

6. alert 개수를 게이트로 만들기

suricata_summary.py는 eve.json의 alert 이벤트를 sid별로 세고 --max N(기본 0)보다 많으면 종료 코드 1로 끝납니다. 정상 pcap은 0, 공격 pcap은 1이므로 파이프라인에서 "이 pcap에서 alert가 나오면 실패"로 쓸 수 있습니다. 반대로 공격 pcap이 3건보다 적으면 실패시키는 식으로 규칙이 약해지는 것을 막을 수도 있지만, 이 글에서는 해 보지 않았습니다.

이 단계의 파일 내려받기:suricata_summary.py

전체 코드

실험 전체를 한 번에 돌리는 스크립트입니다. 아래 파일과 같은 폴더에서 실행합니다.

# suricata_demo.sh
#!/usr/bin/env bash
# 내 PC의 웹 컨테이너 트래픽을 pcap 으로 저장하고, Suricata 가 그 파일을 읽어(replay) 사용자 규칙으로 alert 를 내는지 확인한다.
# 준비: Docker, 같은 폴더에 local.rules, nginx_lab.conf, suricata_summary.py, python.
# 실행(Git Bash): bash suricata_demo.sh   (약 2분)
export MSYS_NO_PATHCONV=1
HERE="$(pwd)"
OUT=../osk-suricata-out                 # 결과 폴더는 규칙 폴더 밖에 둔다. Windows 의 python 이 읽도록 상대 경로로 둔다
rm -rf "$OUT"; mkdir -p "$OUT"; ABS="$(cd "$OUT" && pwd)"
cleanup() { docker rm -f osk-web osk-sniff >/dev/null 2>&1; docker network rm osk-net >/dev/null 2>&1; }
cleanup
docker network create osk-net >/dev/null
docker run -d --name osk-web --network osk-net -v "$HERE/nginx_lab.conf:/etc/nginx/conf.d/default.conf:ro" nginx:alpine >/dev/null
sleep 2

capture() {   # capture <이름> <명령...> : tcpdump 를 켜고, 그 사이에 트래픽을 만든 뒤 pcap 으로 저장
  local name="$1"; shift
  docker run -d --name osk-sniff --network container:osk-web --cap-add NET_RAW --cap-add NET_ADMIN \
    -v "$ABS:/out" nicolaka/netshoot tcpdump -i eth0 -U -w "/out/$name.pcap" >/dev/null
  sleep 2
  "$@"
  sleep 1
  docker stop osk-sniff >/dev/null; docker rm osk-sniff >/dev/null
}
clean_traffic() {
  for p in / /health /index.html; do docker run --rm --network osk-net curlimages/curl -s -o /dev/null "http://osk-web$p"; done
}
attack_traffic() {
  docker run --rm --network osk-net instrumentisto/nmap -p 1-100 -T4 osk-web >/dev/null
  docker run --rm --network osk-net curlimages/curl -s -o /dev/null -d 'user=admin&password=passw0rd' http://osk-web/login
  docker run --rm --network osk-net curlimages/curl -s -o /dev/null --path-as-is 'http://osk-web/../../etc/passwd'
}
echo "## 1. pcap 만들기"
capture clean clean_traffic
capture attack attack_traffic
ls -l "$OUT"/*.pcap | awk '{print "  " $5 " 바이트  " $9}' | sed "s#$OUT/##"

replay() {    # replay <이름> : Suricata 가 pcap 을 읽고 eve.json 을 남긴다
  mkdir -p "$OUT/log-$1"
  docker run --rm -v "$HERE:/rules:ro" -v "$ABS:/out" --entrypoint suricata jasonish/suricata:latest \
    -r "/out/$1.pcap" -S /rules/local.rules -l "/out/log-$1" -k none >"$OUT/run-$1.txt" 2>&1
}
echo "## 2. 정상 pcap 재생"
replay clean
python suricata_summary.py "$OUT/log-clean/eve.json"; echo "  종료 코드 $?"
echo "## 3. 공격 pcap 재생"
replay attack
python suricata_summary.py "$OUT/log-attack/eve.json"; echo "  종료 코드 $?"
echo "## 4. 같은 eve.json 의 http 이벤트(요청 줄과 응답 코드)"
python - "$OUT/log-attack/eve.json" <<'PY'
import json, sys
sys.stdout.reconfigure(encoding="utf-8")
for line in open(sys.argv[1], encoding="utf-8"):
    e = json.loads(line)
    if e["event_type"] == "http":
        h = e["http"]
        print(f"  {h.get('http_method')} {h.get('url')} -> {h.get('status')}")
PY
cleanup
echo "## 끝 (결과 폴더: $OUT)"

규칙 파일입니다. 한 줄이 규칙 하나입니다.

local.rules

# 내 PC 시험용 규칙. sid 1000000번대는 사용자 규칙 영역이다.
alert http any any -> any any (msg:"LAB 평문 HTTP로 password 전송"; flow:established,to_server; http.method; content:"POST"; http.request_body; content:"password="; sid:1000001; rev:1;)
alert http any any -> any any (msg:"LAB 경로 이탈 ../ 요청(정규화된 uri)"; flow:established,to_server; http.uri; content:"../"; sid:1000002; rev:1;)
alert http any any -> any any (msg:"LAB 경로 이탈 ../ 요청(원본 uri)"; flow:established,to_server; http.uri.raw; content:"../"; sid:1000004; rev:1;)
alert tcp any any -> any any (msg:"LAB 짧은 시간에 SYN 다수(포트 스캔 의심)"; flags:S; threshold:type both, track by_src, count 20, seconds 5; sid:1000003; rev:1;)

시험용 웹 서버 설정입니다. 로그인 주소는 200을 돌려줍니다.

# nginx_lab.conf
server {
  listen 80;
  location /login { return 200 "ok\n"; }
  location / { return 200 "hello\n"; }
}

eve.json의 alert를 세어 종료 코드로 바꾸는 파이썬 스크립트입니다.

# suricata_summary.py
#!/usr/bin/env python
"""eve.json 에서 alert 를 규칙(sid)별로 세고, 허용 개수를 넘으면 종료 코드 1 로 끝낸다.
사용: python suricata_summary.py eve.json [--max 0]"""
import collections
import json
import sys

sys.stdout.reconfigure(encoding="utf-8")

path = sys.argv[1]
limit = int(sys.argv[sys.argv.index("--max") + 1]) if "--max" in sys.argv else 0
count = collections.Counter()
for line in open(path, encoding="utf-8"):
    line = line.strip()
    if not line:
        continue
    ev = json.loads(line)
    if ev.get("event_type") == "alert":
        a = ev["alert"]
        count[(a["signature_id"], a["signature"])] += 1
total = sum(count.values())
for (sid, sig), n in sorted(count.items()):
    print(f"  sid {sid}  {n:>3}건  {sig}")
print(f"  합계 {total}건 (허용 {limit}건)")
sys.exit(1 if total > limit else 0)

자주 막히는 곳

증상 원인 해결
Python was not found (종료 코드 49) Git Bash에서 python3가 Windows의 스토어 바로가기에 걸림 python 사용
파이썬이 eve.json을 못 찾음 Windows 파이썬은 /c/... 경로를 읽지 못함 파이썬에는 상대 경로를 쓰고, docker -v에는 pwd 절대 경로를 씀
UnicodeEncodeError: 'charmap' 한글 출력이 cp1252 콘솔로 나감 스크립트 첫머리에 sys.stdout.reconfigure(encoding="utf-8")
경로 이탈 요청이 pcap에 없음 curl이 ../를 먼저 정리함 --path-as-is
규칙이 0건인데 이유를 모름 보는 필드가 정규화된 값임 http.uri.raw로 바꿔 비교

확인 범위

  • 해 본 것: 2026-10-30, Windows 11 · Docker 29.5.3 · Suricata 8.0.8에서 컨테이너 트래픽의 pcap 저장, 정상 pcap과 공격 pcap의 재생, 사용자 규칙 네 줄의 alert 확인(정상 0건, 공격 3건), eve.json의 http 이벤트와 응답 코드 확인, alert 개수의 종료 코드 변환을 실행했습니다. 전체 스크립트를 세 번 실행해 결과가 같았고 pcap 크기도 같았으며, 끝에 컨테이너와 네트워크를 지웠습니다.
  • 해 보지 않은 것: 실시간 인터페이스 감시, 공개 규칙 세트(ET Open) 적용과 suricata-update, 규칙 오탐 조정, 암호화된 HTTPS 트래픽, threshold 값을 바꾼 비교, 성능 측정, Linux와 macOS.
  • 읽을 때 주의: 이 글의 트래픽은 내 PC의 컨테이너끼리 만든 것이며 남의 시스템에는 스캔을 보내지 않았습니다. alert 개수는 이 규칙과 이 pcap에서의 값이고 실제 환경의 탐지율이 아닙니다. 필드 이름과 출력은 8.0.8 기준입니다.

이 글은 스타트업·소규모 조직 보안 구축 로드맵의 한 단계입니다.

이 글의 다음 단계

  • Zeek으로 pcap 읽어 conn.log와 http.log 만들기: 스캔 흔적과 404 개수 게이트내 PC의 웹 컨테이너 트래픽을 pcap으로 저장하고 Zeek 9.0.1로 읽어 JSON 로그를 만든 뒤, 정상 요청과 스캔 요청을 비교합니다. Zeek의 패킷 합계를 tcpdump 개수와 대조하고, 한 출발지의 404가 기준을 넘으면 종료 코드 1로 끝나는 게이트까지 만듭니다.
  • Falco 컨테이너 런타임 규칙 시험: 셸 실행, /etc 쓰기Falco 0.45.2를 modern eBPF 드라이버로 Docker Desktop에서 띄우고 사용자 규칙 세 개를 얹어, 평범한 컨테이너와 수상한 동작을 한 컨테이너를 같은 방법으로 비교합니다. 처음에는 경고가 0건이었던 이유(준비 시간, 규칙 하나만 걸리는 기본 동작)를 풀고 결과를 종료 코드로 바꿉니다.

이 내용을 팀 교육으로 진행하고 싶으신가요?

인원, 수준, 일정에 맞춰 실습 환경까지 준비해 진행합니다. 대상과 기간을 알려 주시면 구성을 제안해 드립니다.

교육 문의하기

교육 진행 순서와 자주 묻는 질문 보기

팀이나 교육 담당자에게 이 글 제안하기

메일로 보내실 수도 있습니다: fankh111@gmail.com

같은 카테고리의 글