# OSV-Scanner로 잠금 파일 점검하기: 34건을 읽고, 예외를 두고, 0건이 될 때까지 고치기

> 오래된 버전을 일부러 적은 requirements.txt와 package-lock.json을 OSV-Scanner에 넣어 취약점 34건을 찾습니다. JSON 요약, 예외 설정, 고친 뒤에도 남는 하위 의존성 두 건을 거쳐 종료 코드 0이 되기까지 실행해 확인합니다.

- 주소: https://copyandrun.com/blog/osv-scanner-lockfile-vulnerabilities/
- 분야: DevSecOps
- 발행일: 2026-10-30
- 태그: OSV-Scanner, SCA, 취약점, 잠금 파일

의존성 점검 도구는 여러 가지가 있지만 모두 "이 버전에 알려진 취약점이 있는가"를 묻는다는 점은 같습니다. OSV-Scanner는 구글이 만든 오픈소스 도구로, 파이썬과 npm 같은 서로 다른 생태계의 잠금 파일을 한 번에 읽어 OSV 데이터베이스(osv.dev)에 물어봅니다. 이 글에서는 오래된 버전을 일부러 적은 파일 두 개를 넣어 결과를 읽고, 요약하고, 예외를 두고, 고친 뒤에 다시 검사해 종료 코드 0을 만드는 과정을 실행하고 기록합니다. 앞의 [pip-audit 글](/blog/pip-audit-python-dependencies/)이 파이썬만 다뤘다면, 이 글에서는 한 도구로 두 생태계를 함께 봅니다.

## 준비물

| 항목 | 확인한 값 |
|---|---|
| Docker | 29.5.3 (Windows 11, Git Bash에서 실행) |
| OSV-Scanner | 2.7.0 (`ghcr.io/google/osv-scanner:latest` 이미지, 설치 없이 컨테이너로 실행) |
| 파이썬 | 3.12 (JSON 요약용) |
| 네트워크 | 필요(검사할 때마다 OSV와 deps.dev에 조회) |

## 1. 검사할 파일 두 개

`requirements.txt`는 파이썬 패키지 다섯 개를 오래된 버전으로 고정했습니다.

```text
flask==1.1.2
requests==2.19.0
pyyaml==5.3
jinja2==2.11.2
urllib3==1.24.1
```

`package-lock.json`은 npm 패키지 둘(`lodash` 4.17.15, `minimist` 1.2.5)을 고정한 최소한의 잠금 파일입니다. 전체 내용은 아래 "전체 코드"에 있습니다. 이 파일들을 빈 폴더에 두고 폴더 이름을 `osv-demo`라고 하겠습니다.

## 2. 폴더 전체 검사

폴더를 컨테이너에 연결하고 `scan source -r`(하위 폴더까지)로 검사합니다. Git Bash에서는 `/src` 경로가 윈도우 경로로 바뀌지 않도록 `MSYS_NO_PATHCONV=1`을 먼저 설정합니다.

```bash
export MSYS_NO_PATHCONV=1
docker run --rm -v "$PWD:/src" ghcr.io/google/osv-scanner:latest scan source -r /src
```

끝에 이런 요약이 나왔습니다.

```text
Total 7 packages affected by 34 known vulnerabilities (3 Critical, 13 High, 18 Medium, 0 Low, 0 Unknown) from 2 ecosystems.
34 vulnerabilities can be fixed.
```

검사한 패키지 일곱 개(파이썬 5, npm 2) 모두에서 합계 34건이 나왔고, 34건 모두 고칠 수 있는 버전이 있다고 알려 줍니다. 표는 지적마다 OSV 주소, 점수(CVSS), 패키지, 현재 버전, 고칠 수 있는 버전(`FIXED VERSION`), 출처 파일을 보여 줍니다.

![OSV-Scanner 표 출력의 앞부분에서 요약 줄과 flask, jinja2, pyyaml 등 패키지별 지적, 점수, 현재 버전, 수정 버전이 나열되는 것을 확인합니다.](https://copyandrun.com/img/osv-scanner-lockfile-vulnerabilities/01-표-출력.png)

종료 코드는 1이었습니다. 취약점이 하나라도 있으면 1을 돌려주므로 CI에서는 이 값만 봐도 통과와 실패를 가를 수 있습니다. 표의 앞 몇 줄만 보면 같은 패키지가 여러 줄(OSV 주소가 `PYSEC-`로 시작하는 줄과 `GHSA-`로 시작하는 줄)로 나와 개수가 많아 보입니다. 같은 문제를 가리키는 서로 다른 번호는 한 건으로 묶어서 세므로, 표의 줄 수가 아니라 요약 줄의 숫자를 봅니다.

### 파이썬 파일이 보내는 충돌 경고

검사 중간에 이런 메시지도 나왔습니다.

```text
failed resolution for src/requirements.txt: resolution impossible:
requirements conflict: urllib3: "==1.24.1,<1.24,>=1.21.1"
```

`requests` 2.19.0이 `urllib3`를 1.24 미만으로 요구하는데 파일은 1.24.1을 적어서 서로 맞지 않는다는 뜻으로 읽힙니다. 이 경우 OSV-Scanner는 하위 의존성을 풀어 내지 못하고 파일에 적힌 다섯 개(`found 5 packages`)만 검사했습니다. `--data-source native`로 바꿔도 같은 경고와 같은 34건이 나왔습니다. 실제 프로젝트에서는 이런 경고가 나오면 파일이 설치할 수 없는 조합이라는 신호이므로, 취약점과 별개로 먼저 고칩니다.

## 3. JSON으로 받아 패키지별로 요약

표는 사람이 읽기에는 좋지만 집계에는 불편합니다. `--format json`으로 받아 패키지별 건수, 최고 점수, 지적을 모두 없애는 버전을 한 줄씩 보여 주는 짧은 스크립트(`osv_summary.py`)를 만들었습니다. 결과는 이렇습니다.

```text
ecosystem package   version  count max CVSS  one version that clears all
PyPI      flask     1.1.2        2      8.7  3.1.3
PyPI      jinja2    2.11.2       5      7.8  3.1.6
PyPI      pyyaml    5.3          2      9.8  5.4
PyPI      requests  2.19.0       5      7.5  2.33.0
PyPI      urllib3   1.24.1      13      8.9  2.8.0
npm       lodash    4.17.15      6      8.1  4.18.0
npm       minimist  1.2.5        1      9.8  1.2.6
total advisories: 34
```

`urllib3` 하나에 13건이 몰려 있고, 가장 높은 점수(9.8)는 `pyyaml`과 `minimist`입니다. 마지막 열은 그 패키지의 모든 지적이 말하는 수정 버전 중 가장 높은 값이므로, 이 버전 이상으로 올리면 그 패키지의 지적은 모두 사라진다고 읽습니다(5번에서 확인합니다). 스크립트를 처음 만들었을 때는 이 열에 `afd63b16...` 같은 긴 해시가 나왔습니다. OSV 기록에는 버전 범위 말고 커밋 해시 범위(`GIT` 형식)도 들어 있어서, 이를 건너뛰도록 한 줄을 넣어 고쳤습니다.

### 파일 하나만, 출력 형식 바꾸기

한 파일만 보려면 `-L`로 지정합니다. `-L /src/package-lock.json`으로 검사하니 npm 패키지 둘에서 7건(Critical 1, High 3, Medium 3)이 나왔습니다. 형식은 `--format`으로 바꿉니다. 같은 검사 결과를 형식별로 받았을 때 크기는 이랬습니다.

| 형식 | 크기(바이트) | 쓰는 곳 |
|---|---|---|
| `markdown` | 5,140 | 보고서나 이슈에 붙이기 |
| `spdx-2-3` | 10,292 | 소프트웨어 구성 목록(SBOM) 교환 |
| `cyclonedx-1-6` | 114,266 | SBOM 교환(다른 규격) |
| `sarif` | 382,537 | 코드 호스팅 서비스의 보안 화면 연동 |

이 글에서는 형식의 크기만 확인했고, 각 형식을 다른 도구로 읽어 보지는 않았습니다.

## 4. 예외 설정

지금 당장 고칠 수 없는 지적이 있으면 설정 파일(`osv-scanner.toml`)에 이유와 함께 예외로 둡니다.

```toml
[[IgnoredVulns]]
id = "GHSA-xvch-5gv4-984h"
ignoreUntil = 2027-03-31
reason = "개발 도구에서만 쓰는 minimist, 배포본에는 들어가지 않음(예시)"
```

`--config /src/osv-scanner.toml`을 주고 다시 검사하자 요약이 `Total 6 packages affected by 33 known vulnerabilities`로 바뀌었습니다. 34건에서 `minimist`의 1건이 빠지고 그 패키지가 목록에서 사라진 것입니다. `ignoreUntil`에 날짜를 적는 이유는 예외가 영원히 남지 않게 하기 위해서입니다. 이 글에서는 날짜가 지난 뒤에 지적이 다시 나타나는지는 시험하지 않았습니다. 위 `reason`은 예시이며, 실제로는 왜 괜찮은지 검토한 사람과 근거를 남깁니다.

## 5. 모두 고쳐서 다시 검사

3번 표의 마지막 열대로 올린 파일을 별도 폴더에 만들어 검사했습니다. `pyyaml`은 표의 5.4보다 높은 6.0.2로 올렸고, `package-lock.json`은 숫자만 바꿨습니다.

```text
flask==3.1.3
jinja2==3.1.6
pyyaml==6.0.2
requests==2.33.0
urllib3==2.8.0
```

결과는 0건이 아니었습니다.

```text
Total 2 packages affected by 2 known vulnerabilities (1 Critical, 0 High, 1 Medium, 0 Low, 0 Unknown) from 1 ecosystem.
```

남은 두 건은 `certifi` 2026.7.22(수정 버전 2026.10.19)와 `idna` 3.9.0(수정 버전 3.15)입니다. 이 둘은 파일에 적지 않았고 `requests`가 끌어온 하위 의존성입니다. 이번에는 `requests`의 요구와 충돌이 없어서 하위 의존성까지 풀렸고, 처음 검사에서는 보이지 않던 두 패키지가 나타났습니다. 이 둘도 파일에 고정해 다시 검사했습니다.

```text
certifi==2026.10.19
idna==3.15
```

이번에는 `No issues found`와 종료 코드 0이 나왔습니다. 정리하면, 처음에는 충돌 때문에 하위 의존성이 검사에서 빠져 7개 패키지의 34건만 보였고, 직접 쓰는 패키지를 고쳐 충돌이 사라지자 하위 의존성의 취약점이 새로 드러났습니다. 고치는 중에 지적이 줄지 않고 다른 이름으로 나타날 수 있다는 점을 알고 있으면 당황하지 않습니다.

![osv_demo.sh 실행 결과에서 34건 요약, 패키지별 요약 표, 형식별 크기, 예외 설정 후 33건, 고친 뒤 2건과 certifi, idna, 고정 후 No issues found와 종료 코드 0을 확인합니다.](https://copyandrun.com/img/osv-scanner-lockfile-vulnerabilities/02-osv_demo-실행.png)

## 6. CI에 넣는 방법

종료 코드가 1이면 실패하는 CI 작업에서는 이렇게 한 줄이면 됩니다.

```bash
docker run --rm -v "$PWD:/src" ghcr.io/google/osv-scanner:latest scan source -r /src
```

처음 도입할 때 34건이 한꺼번에 나오면 팀이 지칩니다. 먼저 점수가 높은 것(Critical, High)만 막고 나머지는 목록으로 관리하거나, 4번의 예외 파일에 이유와 만료일을 적어 단계적으로 줄입니다. 이 글에서는 CI 서비스에 실제로 올려 보지 않았고, 같은 종료 코드 동작은 위 실행으로만 확인했습니다.

## 전체 코드

아래 네 파일을 같은 폴더에 두고 `bash osv_demo.sh`를 실행하면 이 글의 모든 숫자를 다시 얻습니다. 이 PC에서 약 1분이 걸렸고 검사할 때마다 네트워크 조회가 있습니다. 5번의 고친 파일은 스크립트가 폴더 바깥(`../osv-fixed-tmp`)에 만들고 끝에 지웁니다.

`requirements.txt`

```text
flask==1.1.2
requests==2.19.0
pyyaml==5.3
jinja2==2.11.2
urllib3==1.24.1
```

`package-lock.json`

```json
{
  "name": "demo",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": { "name": "demo", "version": "1.0.0", "dependencies": { "lodash": "4.17.15", "minimist": "1.2.5" } },
    "node_modules/lodash": { "version": "4.17.15", "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.15.tgz" },
    "node_modules/minimist": { "version": "1.2.5", "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.5.tgz" }
  }
}
```

`osv_summary.py`

```python
# osv_summary.py
"""osv-scanner 의 JSON 결과를 패키지별로 요약하고, 지적을 모두 없애는 최소 버전을 계산한다.
사용: python osv_summary.py out.json
"""
import json
import sys
from collections import defaultdict


def ver(s):
    """'1.24.3' -> (1, 24, 3). 숫자가 아닌 꼬리표는 무시한다."""
    out = []
    for part in s.split("."):
        digits = "".join(ch for ch in part if ch.isdigit())
        out.append(int(digits) if digits else 0)
    return tuple(out)


def fixed_versions(vuln, name):
    """한 지적(vuln)에서 패키지 name 에 해당하는 수정 버전 목록."""
    found = []
    for aff in vuln.get("affected", []):
        if aff.get("package", {}).get("name", "").lower() != name.lower():
            continue
        for rng in aff.get("ranges", []):
            if rng.get("type") == "GIT":  # 커밋 해시는 버전이 아니므로 뺀다
                continue
            for ev in rng.get("events", []):
                if "fixed" in ev:
                    found.append(ev["fixed"])
    return found


data = json.load(open(sys.argv[1], encoding="utf-8"))
rows = defaultdict(lambda: {"ids": set(), "max": 0.0, "fixes": []})

for res in data["results"]:
    for pkg in res["packages"]:
        name, version = pkg["package"]["name"], pkg["package"]["version"]
        key = (pkg["package"]["ecosystem"], name, version)
        for grp in pkg["groups"]:
            rows[key]["ids"].add(grp["ids"][0])
            try:
                rows[key]["max"] = max(rows[key]["max"], float(grp["max_severity"]))
            except ValueError:
                pass
        for v in pkg["vulnerabilities"]:
            rows[key]["fixes"] += fixed_versions(v, name)

print(f"{'ecosystem':9} {'package':9} {'version':8} {'count':>5} {'max CVSS':>8}  one version that clears all")
for (eco, name, version), r in sorted(rows.items()):
    best = max(r["fixes"], key=ver) if r["fixes"] else "-"
    print(f"{eco:9} {name:9} {version:8} {len(r['ids']):>5} {r['max']:>8}  {best}")
print("total advisories:", sum(len(r["ids"]) for r in rows.values()))
```

`osv_demo.sh`

```bash
# osv_demo.sh
#!/usr/bin/env bash
# OSV-Scanner 로 잠금 파일의 알려진 취약점을 찾고, 요약하고, 예외를 두고, 고친 뒤 다시 검사한다.
# 준비: Docker, 인터넷(api.osv.dev, deps.dev 조회). 같은 폴더에 requirements.txt, package-lock.json, osv_summary.py.
# 실행(Git Bash): bash osv_demo.sh
export MSYS_NO_PATHCONV=1   # Git Bash 가 /src 를 윈도우 경로로 바꾸지 않게 한다
IMG=ghcr.io/google/osv-scanner:latest
HERE="$(pwd)"
osv() { docker run --rm -v "$HERE:/src" "$IMG" "$@"; }

echo "## 0. 버전"
osv --version 2>&1 | head -1

echo "## 1. 폴더 전체 검사(표). 요약 줄과 종료 코드만 본다"
osv scan source -r /src > table.txt 2>&1
echo "exit code = $?"
grep -E '^Total|can be fixed' table.txt

echo "## 2. JSON 으로 받아 패키지별로 요약"
osv scan source -r --format json /src 2>/dev/null > out.json
python osv_summary.py out.json

echo "## 3. 파일 하나만 검사(-L)"
osv scan source -L /src/package-lock.json 2>&1 | grep -E '^Total|^No issues'

echo "## 4. 출력 형식별 크기(바이트)"
for f in markdown sarif cyclonedx-1-6 spdx-2-3; do
  printf '%-14s ' "$f"; osv scan source -r --format "$f" /src 2>/dev/null | wc -c
done

echo "## 5. 지적 하나에 예외(이유와 만료일 포함)를 두고 다시 검사"
cat > osv-scanner.toml <<'TOML'
[[IgnoredVulns]]
id = "GHSA-xvch-5gv4-984h"
ignoreUntil = 2027-03-31
reason = "개발 도구에서만 쓰는 minimist, 배포본에는 들어가지 않음(예시)"
TOML
osv scan source -r --config /src/osv-scanner.toml /src 2>&1 | grep -E '^Total|ignored|Ignored'
rm -f osv-scanner.toml

echo "## 6. 모든 지적을 없애는 버전으로 올린 파일을 새 폴더에 만들어 검사"
FIX="$HERE/../osv-fixed-tmp"   # 검사 대상 폴더 밖에 만든다. 안에 두면 1번 검사가 이 폴더까지 읽는다
mkdir -p "$FIX"
cat > "$FIX/requirements.txt" <<'REQ'
flask==3.1.3
jinja2==3.1.6
pyyaml==6.0.2
requests==2.33.0
urllib3==2.8.0
REQ
sed -e 's/4\.17\.15/4.18.0/g' -e 's/1\.2\.5/1.2.6/g' package-lock.json > "$FIX/package-lock.json"
docker run --rm -v "$FIX:/src" "$IMG" scan source -r /src > "$FIX/fixed.txt" 2>&1
echo "exit code = $?"
grep -E '^Total|^No issues|conflict' "$FIX/fixed.txt"

echo "## 7. 남은 둘은 직접 쓰지 않은 하위 의존성(requests 가 끌어온 것). 표에서 이름을 확인한다"
grep -E '^\| https://osv.dev/PYSEC' "$FIX/fixed.txt" | awk -F'|' '{gsub(/ +/," ",$5); gsub(/ +/," ",$6); gsub(/ +/," ",$7); print "  " $5 $6 " -> fix " $7}'

echo "## 8. 그 둘도 고정해 다시 검사"
printf 'certifi==2026.10.19\nidna==3.15\n' >> "$FIX/requirements.txt"
docker run --rm -v "$FIX:/src" "$IMG" scan source -r /src > "$FIX/fixed2.txt" 2>&1
echo "exit code = $?"
grep -E '^Total|^No issues' "$FIX/fixed2.txt"
rm -rf "$FIX" table.txt out.json
```

## 자주 막히는 곳

| 증상 | 원인과 해결 |
|---|---|
| 종료 코드가 128이고 아무것도 검사되지 않음 | Git Bash의 `mktemp -d`가 만든 `/tmp/...` 경로를 Docker가 마운트하지 못함. 현재 폴더 기준 경로 사용 |
| 지적 개수가 실행할 때마다 다름 | 검사 폴더 안에 이전에 만든 고친 파일 폴더가 남아 있었음. `-r`은 하위 폴더까지 읽으므로 그 폴더의 `certifi`와 `idna`가 합산되어 34건이 36건이 됨. 임시 파일은 검사 폴더 밖에 보관 |
| 요약 열에 긴 해시가 나옴 | JSON에는 버전 범위 말고 커밋 해시 범위도 있음. `type`이 `GIT`인 범위를 건너뜀 |
| `resolution impossible` 경고 | 파일에 적은 버전끼리 맞지 않음. 하위 의존성이 검사에서 빠지므로 충돌부터 수정 |
| 고쳤는데 다른 이름의 지적이 남음 | 하위 의존성. 표의 `SOURCE`와 패키지 이름을 보고 직접 고정하거나, 그것을 끌어오는 상위 패키지를 올림 |

## 확인 범위

- **해 본 것:** 2026-10-30, Windows 11 · Docker 29.5.3 · OSV-Scanner 2.7.0에서 폴더 검사(34건, 종료 코드 1), 충돌 경고와 `--data-source native` 비교, JSON 요약, 단일 파일(`-L`), 출력 형식 네 가지의 크기, 예외 설정(33건), 고친 파일의 검사(2건)와 하위 의존성 고정 뒤 0건(종료 코드 0)을 실행했습니다. 처음 검사를 같은 입력으로 세 번 반복해 34건이 매번 같음을 확인했습니다.
- **해 보지 않은 것:** 네트워크 없는 환경의 검사, 컨테이너 이미지와 소스 코드의 호출 분석(`--call-analysis`), 예외의 만료일이 지난 뒤의 동작, 출력 형식을 다른 도구로 읽는 일, 고친 버전으로 실제 애플리케이션을 실행하는 일, pip-audit와의 결과 비교, Linux와 macOS.
- **읽을 때 주의:** 취약점 데이터는 매일 바뀝니다. 이 글의 건수와 수정 버전은 2026-10-30 기준이며, 며칠 뒤에는 다른 숫자가 나올 수 있습니다. Flask 1.x에서 3.x로 올리는 것은 주 버전이 두 단계 바뀌는 큰 변경이라 코드가 그대로 돌지 않을 수 있으므로, 실제 프로젝트에서는 시험을 돌린 뒤에 올립니다. `ignoreUntil`의 `reason`은 예시입니다.
