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

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

- 주소: https://copyandrun.com/blog/suricata-pcap-replay-alerts/
- 분야: SIEM·보안관제
- 발행일: 2026-10-30
- 태그: Suricata, pcap, IDS, 네트워크 탐지, eve.json

네트워크 탐지 규칙은 만들기보다 시험하기가 어렵습니다. 실제 공격을 흘려 볼 수 없고, 규칙이 조용히 아무것도 잡지 못해도 화면에는 아무 일도 일어나지 않기 때문입니다. 그래서 먼저 트래픽을 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. 순서 한눈에 보기

<!-- files: nginx_lab.conf -->

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

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

## 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번에서 설명합니다.

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

<!-- files: suricata_demo.sh -->

정상 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바이트였고, 스크립트를 다시 돌려도 같은 크기였습니다.

## 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이 보이는 것을 확인합니다.](https://copyandrun.com/img/suricata-pcap-replay-alerts/01-suricata-pcap-재생-alert.png)

- **정상 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인 것을 확인합니다.](https://copyandrun.com/img/suricata-pcap-replay-alerts/02-suricata-fast-log-종료코드.png)

## 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건보다 적으면 실패시키는 식으로 규칙이 약해지는 것을 막을 수도 있지만, 이 글에서는 해 보지 않았습니다.

## 전체 코드

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

```bash
# 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`

```text
# 내 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
# nginx_lab.conf
server {
  listen 80;
  location /login { return 200 "ok\n"; }
  location / { return 200 "hello\n"; }
}
```

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

```python
# 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 기준입니다.
